Tirsvad
10e88e8a27
- publish-wiki-pages.yml: reusable workflow with wiki_dir, prune and tools-ref inputs and the declared secret TOKEN_FOR_GITEA_WIKI - tools/publish_wiki.py: WIKI_PRUNE selects explicit mode without the marker; a missing folder is a configuration error - publish-own-wiki.yml: this repository calls the reusable workflow - wiki/ moves to docs/wiki/; build_wiki.py and its tests follow - the scoped publish-wiki.yml is marked deprecated, not removed - guides, README and the Danish and Bahasa Malaysia wiki pages describe the caller, docs/wiki/ and the new error messages Task: MIL-008#2 Task: MIL-008#4 Task: MIL-008#5 Task: MIL-008#6
5.7 KiB
Dette er en oversættelse af
Troubleshooting. Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres.
English | Dansk | Bahasa Melayu
Fejlfinding af en mislykket kørsel
Åbn kørslen i Gitea (Actions) og læs de sidste linjer i det trin, der fejler. Hver fejl fra synkroniseringsscriptet skrives som
ERROR: [<category>] <message>
Kategorien fortæller, hvor du skal kigge. En fejl uden for scriptet (jobbet starter aldrig eller stopper før trinnet) er et runner-problem.
| Kategori | Betydning | Første ting at kontrollere |
|---|---|---|
configuration |
En secret eller en repository-indstilling mangler eller er forkert udformet | Secretnavne og format, opsætning af push-spejl |
credentials |
En tjeneste afviste tokenet (HTTP 401) | Token er udløbet, tilbagekaldt eller forkert indtastet |
permissions |
Tokenet er gyldigt, men har ikke tilladelse (HTTP 403, eller ingen GitHub-administrationsadgang) | Token-scopes og repository-adgang |
api |
En anden HTTP-fejl, eller tjenesten kunne ikke nås | Tjenestens status, runnerens netværk |
| runner | Ingen ERROR:-linje; kørslen venter, eller jobbet fejler før scriptet |
Runner online, label, værktøjer |
Meddelelser og løsninger
| Meddelelse (begyndelsen) | Kategori | Årsag og løsning |
|---|---|---|
PAT_FOR_GITHUB is missing or empty. |
configuration | Tilføj secreten |
TOKEN_FOR_GITEA is missing or empty. |
configuration | Tilføj secreten |
Could not determine the Gitea source repository. |
configuration | Kørslen har intet repositorynavn; meld det som en defekt |
Expected at most one GitHub push mirror ... found N |
configuration | Behold ét GitHub push-spejl |
TOKEN_FOR_GITEA_WIKI is missing or empty. |
configuration | Kun wiki-publicering: repositoryet kalder workflowet, men dets organisation har ingen sådan secret, eller kaldet sender den ikke; gem den og send den i secrets: (se credentials.md) |
wiki/.publish may only be empty or contain the word 'prune'. |
configuration | Kun wiki-publicering gennem det ældre scoped workflow: lad markøren være tom, eller skriv kun ordet prune i den |
The prune input must be 'true' or 'false' |
configuration | Kun wiki-publicering: sæt prune i kaldet til "true" eller "false" |
The wiki folder ... does not exist |
configuration | Kun wiki-publicering: sæt wiki_dir i kaldet til mappen med siderne (standard docs/wiki) |
... HTTP 403 ... ved publicering af wikien |
permissions | Kun wiki-publicering: tokenet skal have write:repository og skriveadgang til dette repository |
The wiki is not enabled on <repo> |
configuration | Kun wiki-publicering: aktivér wikien i repositoryets indstillinger |
The wiki source directory ... has no Markdown pages |
configuration | Kun wiki-publicering: mappen har ingen Markdown-sider; intet blev ændret |
Could not determine the GitHub owner and repository ... |
configuration | Spejlets adresse skal se ud som https://github.com/<owner>/<repo>.git |
Gitea API request failed with HTTP 401 |
credentials | Opret et nyt Gitea-token, og opdatér TOKEN_FOR_GITEA |
GitHub API request failed with HTTP 401 |
credentials | Opret et nyt GitHub-token, og opdatér PAT_FOR_GITHUB; værdien skal kun være tokenet (intet navn, ingen anførselstegn eller JSON) |
... HTTP 403 ... (Gitea) |
permissions | Tokenet skal have read:repository, og dets bruger skal være administrator af repositoryet |
... HTTP 403 ... (GitHub) |
permissions | Tokenet skal have Administration read and write på spejl-repositoryet |
The GitHub token cannot administer <repo> |
permissions | Som ovenfor; tokenet kan læse repositoryet, men ikke redigere det |
... HTTP 404 ... |
configuration | Repositoryet blev ikke fundet, eller tokenet kan ikke se det; kontroller spejlets adresse og tokenets adgang til repositoryet |
... HTTP 5xx ... |
api | Problem hos tjenesten; kør igen senere |
... API is unreachable ... |
api | Netværks-, DNS- eller proxyproblem på runneren |
Ikke en fejl
No GitHub push mirror configured for <repo>; nothing to sync. efterfulgt af Skipped. Kørslen lykkes. Ikke alle Gitea-repositories har et GitHub-spejl, så det er forventet for dem. Hvis repositoryet skal have et, så tilføj det i repositoryets indstillinger.
WARNING: Gitea returned an invalid push mirror list; GitHub metadata was not synced. Kørslen lykkes, men intet blev synkroniseret. Kontroller, at Gitea-versionen understøtter push mirror-API'et, og kør igen.
No wiki/.publish marker in <owner>/<repo>; wiki publishing is not enabled for this repository. Kørslen af det ældre scoped Publish wiki lykkes og skriver intet. Repositoryet har ikke meldt sig til; kald det genbrugelige workflow Publish wiki pages (se onboarding.md), hvis det skal publicere.
<n> page(s) are in the wiki but not in <folder>/ and were kept; set the prune input to true to delete them. Kørslen lykkes. Sider, der kun findes i wikien, lades i fred, medmindre kaldet sætter prune: "true" (med det ældre scoped workflow: ordet prune i wiki/.publish).
Runner-problemer
Se afsnittet Runners. Kort sagt: hvis kørslen bliver stående som waiting, har ingen online runner labelen; hvis jobbet fejler før scriptet, mangler runner-imaget et værktøj.
Ny kørsel
Brug Run workflow (workflow_dispatch), når årsagen er rettet. Synkroniseringen kan trygt gentages: den overskriver GitHub-beskrivelsen og -emnerne med værdierne fra Gitea.