coulomb/railiance-infra
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
railiance-infra/docs/forgejo-gitea-retirement-checklist.md
tegwick 23226b1e8a
Some checks are pending
CI Smoke / container-smoke (push) Waiting to run
Details
CI Smoke / host-smoke (push) Waiting to run
Details
Add RAIL-HO-WP-0006 registry ref cleanup workplan (finished)
2026-07-09 11:59:08 +02:00

3.4 KiB
Raw Blame History

Gitea Retirement Checklist (T12)

Date: 2026-07-09
Workplan: RAIL-HO-WP-0005-T12
Status: Option A decided — Gitea retained as read-only fallback

Operator decision (2026-07-09)

Option A: Keep coulombcore gitea Helm running as documented read-only fallback.

Parameter Value
Rollback window 30 days from cutover (2026-07-08 → 2026-08-07)
Gitea repo deletes Forbidden until 2026-08-07
Helm retirement revisit After 2026-08-07 (Option B reassessment)
Canon the-custodian/docs/forgejo-production-decisions.md § T12

Prerequisites

Gate Status
T04/T09 7-day backup gate 4/7 (ETA 2026-07-12) — does not block T12 Option A
state-hub stabilization window Met (closed 2026-07-09)
Operator approval (needs_human) Met — Option A, 30-day window

Monitor backup gate:

cd ~/railiance-platform && make forgejo-backup-status

Dependency scan (2026-07-09)

Clear — no active git remotes on Gitea

Check Result
State Hub remote_url 82 Forgejo, 0 Gitea, 0 without remote
Workstation origin using gitea-remote 0 (legacy gitea remotes retained for rollback only)
Forgejo Actions workflows referencing gitea-remote 0

Gitea retained intentionally

Host Release Namespace Notes
coulombcore (~/.kube/config) gitea Helm 12.5.0 default Read-only fallback through 2026-08-07
railiance01 (config-hosteurope) forgejo Helm 12.5.0 forgejo Production canonical

Rollback runbook: docs/forgejo-cutover-rollback.md (30-day no-delete contract).

Follow-up backlog

Area Status
OCI image refs (railiance-apps charts/helm/docs) Done (WP-0005 session)
npm registry URLs (secrets-engine, activity-core, railiance-platform) Done (WP-0005 session)
Cross-repo sweep (issue-core, state-hub, whynot-design, ops-hub, core-hub, reuse-surface) Done (RAIL-HO-WP-0006, 2026-07-09)
State Hub railiance-bootstrap alias Done — archived; local_path → railiance-cluster
Workstation ~/railiance-bootstrap Done — symlink → railiance-cluster
ArgoCD sourceRepos Forgejo primary; Gitea retained for emergency rollback
Container image re-push to Forgejo Operator — verify crictl pull before redeploy

T12 checklist

  • Operator chooses Option A (30-day rollback window)
  • No active remotes/webhooks/dashboards on Gitea (re-verified 2026-07-09)
  • Runbooks point to Forgejo (deploy-stack.md updated 2026-07-09)
  • Gitea intentionally retained — coulombcore Helm stays running
  • T04/T09 7-day gate 7/7 (workplan close gate; ETA 2026-07-12)
  • Final Gitea volume snapshot catalogued (recommended before 2026-08-07)
  • railiance-bootstrap hub alias resolved (2026-07-09)
  • Stale OCI/npm references migrated to forgejo.coulomb.social (2026-07-09)
  • After 2026-08-07: reassess Option B (Helm retirement)

Option B (deferred)

Helm retirement deferred until after the 30-day rollback window. See prior version of this checklist for Option B steps if reassessment proceeds.

References

  • workplans/RAIL-HO-WP-0005-forgejo-production-migration.md
  • docs/forgejo-cutover-rollback.md
  • docs/forgejo-migration-inventory.md
  • the-custodian/docs/forgejo-production-decisions.md