diff --git a/Capabilities.da.md b/Capabilities.da.md index 3f83fcd..9803fb9 100644 --- a/Capabilities.da.md +++ b/Capabilities.da.md @@ -1,4 +1,4 @@ - + > Dette er en oversættelse af [`Capabilities`](Capabilities). Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres. @@ -16,69 +16,3 @@ Rækker, der siger Implementeret eller Vejledninger er skrevet, findes i dag. Re | Publicering af et repositorys wiki fra `wiki/` (tilmelding, leveres til alle organisationer) | Implementeret i `.gitea/scoped_workflows/publish-wiki.yml`, med offline-tests; et pilotforsøg i et andet repository publicerer sin wiki (MIL-006) | | Fælles kvalitetskontrol (Python og shell) | Implementeret som det genbrugelige workflow `.gitea/workflows/quality-checks.yml`, med offline-tests og et forsøg i en anden organisation; taget i brug i RepoFoundry ([vejledning](QualityChecksPythonShell.da)) | | Versioneret udgivelse og publicering | Udgivelsesproces, changelog og opgraderingsvejledning er defineret; udgivelsesworkflowet findes, og `v1.0.0` er udgivet (MIL-004) ([vejledning](Upgrading.da)) | - -### Synkronisering af GitHub-metadata - -Synkroniserer Gitea-repositoryets beskrivelse og emner til GitHub push-spejlet. - -#### Tidsplan (cron) - -Dagligt kl. 03:17 UTC (`17 3 * * *`) samt ved hvert push til `main` og manuel `workflow_dispatch`. - -#### Workflow - -```plantuml -@startuml -title Sync Gitea repository description and topics to GitHub - -autonumber - -actor "Push to main,\nmanual trigger, or schedule" as Trigger -participant "Gitea Actions\nsync-github-metadata" as Workflow -participant "Gitea REST API" as Gitea -participant "GitHub REST API" as GitHub - -Trigger -> Workflow: Start workflow -activate Workflow - -Workflow -> Workflow: Read and validate secrets -note right -TOKEN_FOR_GITEA -PAT_FOR_GITHUB -end note - -alt secret validation failed - Workflow --> Trigger: workflow failed -end - - -Workflow -> Gitea: GET /repos/{owner}/{repo} -Gitea --> Workflow: Description and topics - -Workflow -> Gitea: GET /repos/{owner}/{repo}/push_mirrors -Gitea --> Workflow: Push mirror response - -alt mirrors is not a list - Workflow --> Trigger: Log a warning and succeed\n(GitHub metadata not synced) -else mirrors is a list with no GitHub mirror - Workflow --> Trigger: Log that there is nothing to sync and succeed -else mirrors is a list - Workflow -> Workflow: Find GitHub owner and repo from remote_address - - Workflow -> GitHub: PATCH /repos/{owner}/{repo}\n{description} - GitHub --> Workflow: Repository updated - - Workflow -> GitHub: PUT /repos/{owner}/{repo}/topics\n{names} - GitHub --> Workflow: Topics updated - - Workflow --> Trigger: Sync completed -else Gitea API denies access - Gitea --> Workflow: HTTP 403 Forbidden - Workflow --> Trigger: Workflow fails -else GitHub API denies access - GitHub --> Workflow: HTTP error - Workflow --> Trigger: Workflow fails -end -deactivate Workflow -@enduml -```