write about automatic deployment specifics

This commit is contained in:
leander committed 2026-11-01 22:29:50 +01:00
1 parent 9f5c22f1fe
commit 95be7959cd
1 file changed
+21
+21
View File
@@ -260,6 +260,27 @@ I skrivende stund fungerer dette for følgende tjenester:
- [Mustaboard](#mustaboard)
- [name-100-uio-gamers](#name-100-uio-gamers)
## Secrets og variabler
Workflowen (`.github/workflows/deploy.yml`) er lik i alle repoene og henter innloggingsinfo fra GitHub sine _secrets_ og _variables_. De fleste av disse er satt på organisasjonsnivå, under _Settings → Secrets and variables → Actions_ for [UiO-Gaming](https://github.com/UiO-Gaming), og deles av alle repoene:
| Navn | Type | Nivå | Innhold |
| ----------------- | -------- | ------------ | -------------------------------------------------------- |
| `SSH_PRIVATE_KEY` | Secret | Organisasjon | Privat SSH-nøkkel for `github_deploy` |
| `SSH_USER` | Secret | Organisasjon | Brukernavnet, altså `github_deploy` |
| `SSH_HOST` | Variable | Organisasjon | `uiogaming.no` |
| `MAIN_BRANCH` | Variable | Organisasjon | `main` |
| `WORK_DIR` | Secret | Repo | Mappen applikasjonen ligger i på servermaskinen |
Den offentlige delen av SSH-nøkkelen ligger i `~/.ssh/authorized_keys` til `github_deploy` på servermaskinen. Byttes nøkkelen må begge stedene oppdateres, men bare én gang siden den deles av alle repoene.
Vil du sette opp automatisk deployment for et nytt repo:
1. Kopier `deploy.yml` fra et av repoene over
2. Legg til `WORK_DIR` som secret i det nye repoet
3. Sjekk at organisasjonens secrets og variables er tilgjengelige for det nye repoet. De kan være begrenset til utvalgte repoer
4. Sørg for at `github_deploy` har tilgang til mappen applikasjonen ligger i på servermaskinen, samt kan kjøre `git` og `docker` der
# Nyttige guider
## Hvordan "lage" et subdomene, f.eks yeet.uiogaming.no?