From 95be7959cd2957505e13a570dfe23420269db062 Mon Sep 17 00:00:00 2001
From: Leander Furumo <leander@furumo.eu>
Date: Sun, 1 Nov 2026 22:29:50 +0100
Subject: [PATCH] write about automatic deployment specifics

---
 driftsdokumentasjon.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/driftsdokumentasjon.md b/driftsdokumentasjon.md
index be57e9c..e05b68e 100644
--- a/driftsdokumentasjon.md
+++ b/driftsdokumentasjon.md
@@ -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?