39 lines
1.7 KiB
Markdown
39 lines
1.7 KiB
Markdown
|
# ADR-0004: Subdomain `code.sdda.eu`
|
||
|
|
|
||
|
|
**Status:** Accepted
|
||
|
|
**Datum:** 2026-04-11
|
||
|
|
**Entscheider:** Benjamin Weinlich
|
||
|
|
**Phase:** M7.1 — Forgejo Deployment
|
||
|
|
|
||
|
|
## Kontext
|
||
|
|
Forgejo braucht eine öffentliche Subdomain unter `sdda.eu`. Mehrere Varianten standen zur Wahl.
|
||
|
|
|
||
|
|
## Entscheidung
|
||
|
|
**`code.sdda.eu`**
|
||
|
|
|
||
|
|
## Alternativen
|
||
|
|
|
||
|
|
| Option | Pro | Contra |
|
||
|
|
|---|---|---|
|
||
|
|
| `git.sdda.eu` | Kurz, Industriestandard (GitHub, GitLab, Bitbucket) | "Git" ist technisch, Fokus auf Protokoll statt Inhalt |
|
||
|
|
| **`code.sdda.eu`** ✓ | Sprechend, User-orientiert ("hier ist unser Code"), nicht protokoll-spezifisch | Nicht ganz so "Standard" wie git.* |
|
||
|
|
| `source.sdda.eu` | Neutral, betont Source-of-Truth | Ungewöhnlich |
|
||
|
|
| `forge.sdda.eu` | Bezieht sich auf Forgejo-Namen | Tool-spezifisch; bei Migration zu anderer Software irreführend |
|
||
|
|
|
||
|
|
## Begründung
|
||
|
|
Benjamin hat `code.sdda.eu` gewählt, weil es:
|
||
|
|
- **User-zentriert** ist — "Code" ist näher am Geschäftszweck als "Git" (Protokoll)
|
||
|
|
- **Tool-agnostisch** ist — würden wir irgendwann auf GitLab / Gitea / whatever wechseln, passt der Name weiter
|
||
|
|
- **Kurz und merkbar** ist
|
||
|
|
- **Keine technischen Vorkenntnisse braucht** — ein Werkstatt-Mitarbeiter versteht "Code" schneller als "Git"
|
||
|
|
|
||
|
|
## Konsequenzen
|
||
|
|
- DNS A-Record `code.sdda.eu → 91.98.226.44` auf Webmin/BIND
|
||
|
|
- AAAA-Record `code.sdda.eu → 2a01:4f8:1c1e:5113::1` (IPv6)
|
||
|
|
- Let's Encrypt Cert automatisch über Traefik
|
||
|
|
- Authentik Redirect URI: `https://code.sdda.eu/user/oauth2/authentik/callback`
|
||
|
|
- Forgejo ROOT_URL und DOMAIN konfiguriert auf `code.sdda.eu`
|
||
|
|
|
||
|
|
## Nicht übersehen
|
||
|
|
Die Forgejo `SSH_DOMAIN` ist ebenfalls `code.sdda.eu` (Port 222) — git clone URLs sind dann `ssh://git@code.sdda.eu:222/user/repo.git`.
|