github-action/wiki/Capabilities.da.md

Dette er en oversættelse af Capabilities. Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres.

English | Dansk | Bahasa Melayu

Funktionalitet

Rækker, der siger Implementeret eller Vejledninger er skrevet, findes i dag. Resten er planlagt og følges i projektplanen, som også beskriver hver enkelt use case.

Funktionalitet	Status
Synkronisering af repositorymetadata (Gitea til GitHub-spejl)	Implementeret i .gitea/scoped_workflows/, med offline-tests og et valideringsworkflow
Konfiguration og validering af workflow-credentials	Implementeret for synkroniseringsworkflowet: en forhåndskontrol tjekker begge tokens før enhver ændring (vejledning)
Tilslutning af et repository, administration af runners, fejlfinding	Vejledninger er skrevet (tilslutning, fejlfinding); scoped levering til alle fire organisationers repositories er verificeret (MIL-002)
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)
Versioneret udgivelse og publicering	Udgivelsesproces, changelog og opgraderingsvejledning er defineret; udgivelsesworkflowet findes, og v1.0.0 er udgivet (MIL-004) (vejledning)

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

@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