Saltar a contenido

Plantilla de runbook

Plantilla

Copiá este archivo a docs/runbooks/ para un incidente real. No dejes comandos de ejemplo en producción: reemplazalos o borralos.

cp docs/guia/plantillas/runbook.md docs/runbooks/mi-incidente.md

Registrá la página en mkdocs.yml y en el índice de runbooks en el mismo PR.

Severidad: P2 (reemplazar) Síntoma: Qué ve el usuario o el monitoreo Impacto: Qué deja de funcionar Dueño: Quién ejecuta este runbook Estado: borrador Última revisión: 2026-09-10

Diagnóstico

  1. Reproducí el síntoma (URL, log, captura).
  2. Confirmá el alcance: ¿un servicio o varios?
  3. Revisá el recurso en Coolify: estado del contenedor, último deploy, logs.
# ejemplo: logs del recurso desde el VPS, ajustar nombre
# docker logs --tail 200 NOMBRE_DEL_CONTENEDOR

Mitigación

Qué hacer ya para recortar el impacto (activar un fallback, avisar al equipo, desactivar un job). No es todavía la causa raíz.

Cambios destructivos

Si un paso borra datos o fuerza un restart en producción, escribilo acá con el comando exacto y el criterio para ejecutarlo.

Recuperación

  1. Paso para volver al estado sano.
  2. Verificación:
    • El dominio responde
    • El healthcheck de Coolify está verde
    • El flujo de negocio X volvió a correr

Postmortem

Cuando el fuego terminó:

  • Causa raíz (una frase)
  • Qué faltaba en monitoreo
  • Qué hay que cambiar en este runbook
  • Ticket / follow-up

Relacionado