5aacf8770f
Document forgejo@coulomb.social on IONOS smtp.ionos.com:587; mailer live on railiance01 via railiance-apps Helm. T06 password-reset test remains open.
96 lines
5.2 KiB
Markdown
96 lines
5.2 KiB
Markdown
# Forgejo Production Decisions (Wave 1)
|
|
|
|
Date: 2026-07-03
|
|
Workplans: `RAIL-HO-WP-0005-T02`, `CUST-WP-0054-T04`
|
|
Operator input: 2026-07-03
|
|
|
|
## Decision log
|
|
|
|
| # | Topic | Decision | Status | Evidence (2026-07-03) |
|
|
| --- | --- | --- | --- | --- |
|
|
| 1 | **Production hostname** | `forgejo.coulomb.social` | **decided** | DNS A → `92.205.62.239` (railiance01); HTTPS reaches Traefik on railiance01 |
|
|
| 2 | Exposure model | Private HTTPS via railiance01 Traefik ingress + cert-manager `letsencrypt-prod` | **decided** | Same pattern as Gitea (`manifests/forgejo-ingress.yaml` in `railiance-apps`) |
|
|
| 2b | Deployment pattern | `gitea-charts/gitea` **12.5.0** Helm + Forgejo image; CNPG `forgejo-db` in `railiance-platform`; Makefile in `railiance-apps` | **decided** | Chart 12.6+ requires Gitea 1.26 `config edit-ini` (incompatible with Forgejo 11); see `railiance-apps/docs/forgejo-on-railiance01.md` |
|
|
| 2c | Live deploy | Forgejo pod + ingress + TLS on railiance01 | **done** (2026-07-03) | `make forgejo-smoke` → HTTP 200 + OCI `/v2/` 401 challenge; cert `forgejo-tls` Ready |
|
|
| 3 | Gitea during transition | `gitea.coulomb.social` on coulombcore remains canonical **until** Forgejo restore/migration drills pass; then read-only mirror | unchanged | Per `RAIL-HO-WP-0005` safety contract |
|
|
| 4 | SMTP / password reset | **IONOS** SMTP; sender `forgejo@coulomb.social`; mailer deployed on railiance01 | **done** (2026-07-07) | `railiance-apps` Helm rev 5; T06 password-reset test still open — see § SMTP below |
|
|
| 5 | Package registry scope | TBD (container images first assumed) | open | — |
|
|
| 6 | Actions runner model | **In-cluster** on railiance01: `forgejo-runner` Deployment + DinD (`railiance01-build-01`) | **done** (2026-07-03) | Runner 2/2 Ready; coulombcore host runner disabled; `image-build` probe pushed OCI image via org secrets |
|
|
| 7 | Backup target + retention | TBD | open | — |
|
|
| 8 | Cutover mode | TBD (staged per-repo vs freeze-all) | open | — |
|
|
|
|
## Hostname decision detail
|
|
|
|
**Chosen hostname:** `https://forgejo.coulomb.social`
|
|
|
|
| Field | Value |
|
|
| --- | --- |
|
|
| DNS | `forgejo.coulomb.social` → `92.205.62.239` (railiance01) |
|
|
| Edge | railiance01 k3s Traefik (`kube-system/traefik` LoadBalancer) |
|
|
| Target machine | railiance01 (production home per `CUST-WP-0054`) |
|
|
| Canonical git remote (post-cutover) | `https://forgejo.coulomb.social/coulomb/<repo>.git` |
|
|
| OCI registry (post-cutover) | `forgejo.coulomb.social/coulomb/<image>` |
|
|
|
|
### Live probe (2026-07-03, post-deploy)
|
|
|
|
```bash
|
|
getent hosts forgejo.coulomb.social # 92.205.62.239
|
|
curl -fsS -o /dev/null -w '%{http_code}\n' https://forgejo.coulomb.social/ # 200
|
|
curl -sSI -X GET https://forgejo.coulomb.social/v2/ | grep -i docker-distribution # registry/2.0
|
|
KUBECONFIG=~/.kube/config-hosteurope kubectl get pods,ingress,certificate -n forgejo
|
|
```
|
|
|
|
Forgejo is serving HTTPS with a valid Let's Encrypt cert. Gitea on coulombcore
|
|
remains canonical for git remotes until migration drills pass.
|
|
|
|
### Implications for CUST-WP-0054
|
|
|
|
- Wave 1 can proceed with a fixed hostname for overlays, ingress manifests, and
|
|
CI `IMAGE_REPOSITORY` variables.
|
|
- State Hub / sweep checkouts on railiance01 (T05) should clone from
|
|
`forgejo.coulomb.social` once cutover completes.
|
|
- Runners and image-build CI are proven; first repo migration pilot
|
|
(`glas-harness`) documents git/SSH/CI routing in
|
|
`docs/forgejo-repo-migration-pilot-glas-harness.md`.
|
|
- Remaining blockers for production cutover: SMTP **mailbox + T06 test** (provider
|
|
decided: IONOS), backup, cutover mode, and production repo migration
|
|
(`RAIL-HO-WP-0005-T11`).
|
|
|
|
## SMTP decision (IONOS) — 2026-07-07
|
|
|
|
**Provider:** IONOS mail for `coulomb.social` and subdomains (operator owns DNS zone
|
|
via IONOS; mailboxes provisioned in IONOS control panel).
|
|
|
|
**Recommended Forgejo mailer settings** (non-secret; password in
|
|
`railiance-apps/helm/forgejo-secrets.sops.yaml`):
|
|
|
|
| Field | Value |
|
|
| --- | --- |
|
|
| `MAILER_TYPE` | `smtp` |
|
|
| `HOST` | `smtp.ionos.com:587` (EU accounts may use `smtp.ionos.de:587`) |
|
|
| `IS_TLS_ENABLED` | `true` (STARTTLS on 587) |
|
|
| `FROM` | `forgejo@coulomb.social` (or dedicated `noreply@…` mailbox) |
|
|
| `USER` | full mailbox address (same as `FROM` unless using a shared relay mailbox) |
|
|
| `PASSWD` | IONOS mailbox password — SOPS only, never Git plaintext |
|
|
|
|
**Operator setup checklist:**
|
|
|
|
1. Create mailbox in IONOS (e.g. `forgejo@coulomb.social`).
|
|
2. Confirm SPF includes IONOS (`include:_spf-eu.ionos.com` or current IONOS
|
|
guidance for the zone).
|
|
3. Enable DKIM in IONOS for `coulomb.social` if offered.
|
|
4. Store mailbox password in `helm/forgejo-secrets.sops.yaml` under
|
|
`gitea.config.mailer.PASSWD`; redeploy Forgejo.
|
|
5. T06 gate: trigger password reset for a controlled non-admin test account;
|
|
confirm delivery and link works.
|
|
|
|
**Implementation:** `railiance-apps/docs/forgejo-on-railiance01.md` (SMTP section).
|
|
|
|
## Open decisions (need operator input)
|
|
|
|
1. ~~SMTP provider~~ — **done: IONOS** (`forgejo@coulomb.social` deployed); remaining:
|
|
T06 password-reset delivery test
|
|
2. Package types beyond OCI at launch (npm, PyPI, Helm, …)
|
|
3. Actions runner: in-cluster ephemeral vs long-lived pod vs host runner
|
|
4. Backup destination and restore cadence
|
|
5. Cutover: staged project-by-project vs single freeze window |