Tirsvad
0ecdcbe804
The onboarding guide said delivery to other repositories was not verified. On 2026-10-10 the sync workflow ran without a copy in repositories of four organisations, so a repository needs no copy and each organisation needs its own secrets. Regenerate the Onboarding wiki page and its translations. Task: MIL-002#2
4.3 KiB
Dette er en oversættelse af
Onboarding. Den engelske side er autoritativ, og ændringer her bliver overskrevet, næste gang wikien publiceres.
English | Dansk | Bahasa Melayu
Tilslutning af et repository
Sådan får en DevOps-professionel et TirSystem-repository til at bruge det fælles workflow Sync GitHub mirror metadata, og hvilke runners det kræver. Kun dette workflow findes i dag; workflows til kvalitetskontrol og udgivelse er planlagt (se projektplanen).
Hvad er verificeret
| Punkt | Status |
|---|---|
| Gitea-version | 1.27.3 |
.gitea/scoped_workflows/sync-github-metadata.yml kører i dette repository |
Verificeret: kørsel 16, workflow_dispatch, gennemført |
| Samme workflow gælder automatisk for andre repositories | Verificeret 2026-10-10: det kørte, uden en kopi i repositoryet, i repositories i TirSystem, TirSystem-BashScript, vl-staal og Tirsvad-Udemy-100-days-of-code (fx TirSystem/sqa-qc-checklists og TirSystem-BashScript/RepoFoundry). Scriptet, det kørte, ændrede sig, når dette repositorys script ændrede sig. |
Leveringen er automatisk, så et repository behøver ingen kopi af workflowet. Secrets deles ikke mellem organisationer: hver organisation skal have sine egne (trin 3).
Trin
- Kontroller forudsætningerne i repositoryet: Actions er aktiveret, og en runner med labelen
ubuntu-latestogpython3er online (se Runners). - Konfigurer ét GitHub push-spejl i repositoryets indstillinger (Settings, Repository, Mirror settings, Push mirror). Workflowet fejler, hvis der er flere GitHub-spejle. Hvis der ingen er, lykkes det uden at synkronisere noget.
- Tilføj de to secrets i repositoryets (eller organisationens) indstillinger med de scopes, der står i credentials.md. Workflowet kører i alle organisationens repositories, så gem secrets én gang pr. organisation; et repository i en anden organisation kan ikke se dem:
TOKEN_FOR_GITEAPAT_FOR_GITHUB(kun GitHub-tokenet)
- Lever workflowet: scoped workflows gælder for alle repositories på denne instans, så der er intet at kopiere. Kun hvor scoped levering ikke er sat op, kopieres
.gitea/scoped_workflows/sync-github-metadata.ymlfra dette repository til.gitea/workflows/i mål-repositoryet; fastlås kopien til en gennemgået version, og kopier igen, når den ændres. - Angiv en beskrivelse og emner på Gitea-repositoryet, så der er noget at synkronisere.
- Kør det én gang manuelt: Actions, Sync GitHub mirror metadata, Run workflow. Loggen skal slutte med
Synced description and topics to <owner>/<repo>., og GitHub-repositoryet skal vise samme beskrivelse og emner. - Hvis det fejler, brug troubleshooting.md.
Runners
| Punkt | Værdi |
|---|---|
| Label, som workflowet bruger | ubuntu-latest |
| Labels, som runneren på denne instans tilbyder | ubuntu-latest, ubuntu-24.04, ubuntu-22.04 |
| Værktøjer, workflowet skal bruge | python3 (kun standardbiblioteket), udgående HTTPS til Gitea API og api.github.com |
Kræves af actions/checkout (bruges af valideringsworkflowet) |
git og Node.js, normalt i runner-imaget |
Kontroller, at en passende runner er online (kræver tilladelse til at se runners):
curl -s -H "Authorization: token $GITEA_TOKEN" \
https://git.tirsystem.com/api/v1/repos/<owner>/<repo>/actions/runners
For runners, der deles af hele instansen, bruger en administrator /api/v1/admin/actions/runners. På skrivetidspunktet er lister for repository og organisation tomme, og én runner på instansniveau (36cd20104923) er online.
Offline eller inkompatibel runner
| Symptom | Sandsynlig årsag | Handling |
|---|---|---|
Kørslen bliver stående som waiting |
Ingen online runner har den label, der står i runs-on |
Start runneren, eller registrer én med labelen |
| Jobbet fejler i starten med en manglende kommando | Runner-imaget mangler python3, git eller Node.js |
Brug et image, der har dem |
| Jobbet kan ikke nå API'et | Runneren har ingen udgående HTTPS | Ret runnerens netværks- eller proxyindstillinger |