Runbooks — índice¶
Fichas y documentos de este dominio¶
- RKE2 apply — fases 0-G (12.5k palabras, autoritativo) — Procedimiento verificado para aplicar cambios de configuración RKE2 en el cluster (mover de platform/ a operations/runbooks/ el 2026-09-06).
- OpenTofu PROD state loss & re-import recovery — What to do when the OpenTofu state for tofu/proxmox/environments/prod is lost: locate the phase-1 controller, source session-only provider tokens, re-import the 28 live resources from the untouched Proxmox API, patch the three kno…
- Observability apply — thin pointer — Thin pointer al procedimiento autoritativo de apply de la suite de observabilidad (apply-observability.sh operator-gated, fases, --allow-existing, ism-apply.sh). No duplica el procedimiento: vive en el README de platform-observabi…
¿Qué vive aquí?¶
Runbooks (RUN-*): procedimientos operativos paso a paso — backup/restore, escalado, rollback, recuperación de fallos. Cada runbook responde: precondiciones, pasos, verificación, rollback.
¿Qué NO pertenece aquí?¶
Descripción de servicios (→ platform/), incidentes pasados (→ operations/incidents/), decisiones de diseño (→ decisions/).
Runbooks¶
| ID | Ficha | Nota |
|---|---|---|
RUN-RKE2-APPLY |
rke2-apply-runbook.md | Aplicar cambios RKE2 (fases 0-G, gates) |
RUN-TOFU-STATE-LOSS |
tofu-prod-state-loss-and-reimport.md | Pérdida de tfstate PROD y re-import |
RUN-OBS-APPLY |
observability-apply.md | Apply observabilidad — thin pointer al procedimiento de platform-observability |
RUN-NEW-APP-GITOPS |
wetopi-platform-new-app-gitops.md | Onboarding de una nueva app por GitOps: contrato de repo, CI/CD, registro one-time en platform-gitops, verificación, stop conditions |
Estado¶
T1.5 (repo docs) migrado (2026-09-07) — fichas presentes. RUN-OBS-APPLY
añadido 2026-09-09 (thin pointer; drift fix OTLP/otlp.wetopi.net).
RUN-NEW-APP-GITOPS añadido 2026-09-23 (migrado desde
agent-control-plane@docs/runbooks, commit c393bf60).