Saltar a contenido

Change Packet Template

Plantilla oficial para preparar, revisar y cerrar futuros updates de:

  • Docker
  • Portainer
  • OpenClaw
  • NPM

No reemplaza:

Sirve para concentrar en un solo paquete:

  • decision
  • alcance
  • compatibilidad
  • riesgo
  • backup
  • rollback
  • pruebas
  • evidencias
  • aprobaciones
  • resultado final

Reglas de uso

  1. Crear una copia de esta plantilla para cada update relevante.
  2. Completar el SAFE POINT antes de cualquier cambio.
  3. Citar siempre los TEST-* obligatorios que apliquen.
  4. No marcar PASS si falta evidencia.
  5. Si el cambio real modifica alcance, riesgo o validacion, actualizar Governance dentro del mismo cierre.

Nombre sugerido del archivo

YYYY-MM-DD-<servicio>-update-change-packet.md

Ejemplos:

  • 2026-06-10-docker-update-change-packet.md
  • 2026-06-10-portainer-update-change-packet.md
  • 2026-06-10-openclaw-update-change-packet.md
  • 2026-06-10-npm-update-change-packet.md

0. Identificacion del packet

  • change_packet_id: CP-YYYYMMDD-<SERVICIO>-001
  • fecha de preparacion: YYYY-MM-DD
  • responsable: pendiente
  • tipo de cambio: update / upgrade / patch
  • ventana propuesta: pendiente
  • estado: BORRADOR / LISTO PARA APROBACION / APROBADO / EJECUTADO / ROLLBACK

SAFE POINT obligatorio

  • git status -sb -> pendiente
  • git rev-parse HEAD -> pendiente

1. Servicio afectado

  • servicio principal: svc-...
  • servicios relacionados: pendiente
  • tipo: Docker / Portainer / OpenClaw / NPM

2. Version actual

  • version actual observada: pendiente
  • fuente de evidencia: pendiente

3. Version objetivo

  • version objetivo: pendiente
  • origen de la version objetivo: pendiente

4. Motivo del cambio

  • motivo: pendiente
  • problema o necesidad: pendiente

5. Beneficios esperados

  • beneficios esperados:
  • pendiente
  • pendiente

6. Riesgos identificados

  • riesgos tecnicos:
  • pendiente
  • riesgos operativos:
  • pendiente
  • impacto esperado si falla: pendiente

7. Release notes revisadas

  • release notes oficiales revisadas:
  • pendiente
  • breaking changes detectados: ninguno / pendiente
  • cambios relevantes para este VPS: pendiente

8. Compatibilidades verificadas

  • compatibilidad con Docker: si / no / pendiente
  • compatibilidad con Portainer: si / no / pendiente
  • compatibilidad con OpenClaw: si / no / pendiente
  • compatibilidad con NPM: si / no / pendiente
  • compatibilidad con volumenes, redes o persistencia: si / no / pendiente
  • evidencia: pendiente

9. Backups disponibles

  • backup requerido: si / no
  • ultimo backup valido: pendiente
  • artefactos confirmados:
  • pendiente
  • hash o manifest confirmado: si / no / pendiente
  • restore de referencia: pendiente

10. Plan de rollback

  • condicion de rollback: pendiente
  • punto de retorno: pendiente
  • procedimiento resumido: pendiente
  • runbook asociado: pendiente
  • owner del rollback: pendiente

11. Tests obligatorios pre-update

  • tests pre-update:
  • TEST-... -> pendiente
  • TEST-... -> pendiente
  • evidencia pre-update: pendiente

12. Tests obligatorios post-update

  • tests post-update:
  • TEST-... -> pendiente
  • TEST-... -> pendiente
  • criterio de aprobacion: pendiente
  • evidencia post-update: pendiente

13. Evidencias requeridas

  • evidencia de version antes: pendiente
  • evidencia de version despues: pendiente
  • evidencia de backups: pendiente
  • evidencia de tests: pendiente
  • evidencia de release notes y compatibilidad: pendiente
  • evidencia de rollback listo: pendiente

14. Aprobaciones requeridas

  • aprobacion tecnica: pendiente
  • aprobacion operativa: pendiente
  • aprobacion final para ejecutar: pendiente
  • fecha de aprobacion: pendiente

15. Resultado final

  • resultado: PASS / FAIL / ROLLBACK / CANCELADO
  • version final observada: pendiente
  • resumen de ejecucion: pendiente
  • incidentes observados: ninguno / pendiente
  • decision de cierre: pendiente

16. Lecciones aprendidas

  • que salio bien: pendiente
  • que conviene mejorar: pendiente
  • cambios a Governance derivados: ninguno / pendiente

Mapeo minimo por tipo de servicio

Si el packet es de Docker

  • revisar: operations/UPDATE-POLICY.md
  • tests minimos sugeridos:
  • TEST-DOCKER-UPDATE-001
  • TEST-OPENCLAW-HEALTH-001
  • TEST-NPM-UPSTREAM-001
  • TEST-PORTAINER-HTTPS-001
  • TEST-BACKUP-RECENCY-001

Si el packet es de Portainer

  • revisar: operations/UPDATE-POLICY.md
  • tests minimos sugeridos:
  • TEST-PORTAINER-UPDATE-001
  • TEST-PORTAINER-HTTPS-001
  • TEST-DOCKER-UPDATE-001
  • TEST-BACKUP-RECENCY-001

Si el packet es de OpenClaw

  • revisar: operations/UPDATE-POLICY.md
  • tests minimos sugeridos:
  • TEST-OPENCLAW-UPDATE-001
  • TEST-OPENCLAW-HEALTH-001
  • TEST-OPENCLAW-AUTH-001
  • TEST-OPENCLAW-HTTPS-001
  • TEST-WEBSOCKET-001

Si el packet es de NPM

  • revisar: operations/UPDATE-POLICY.md
  • tests minimos sugeridos:
  • TEST-NPM-UPDATE-001
  • TEST-NPM-HTTPS-001
  • TEST-NPM-UPSTREAM-001
  • TEST-SSL-EXPIRY-001
  • TEST-PUBLIC-PORTS-001

Cierre documental obligatorio

Antes de cerrar un packet ejecutado, revisar si corresponde actualizar:

  • ficha del servicio afectado
  • catalogos de services, domains, ports, volumes, backups
  • catalog/TESTS.md
  • REGRESSION-MATRIX.md
  • VALIDATION-STATE.md
  • PROJECT-STATE.md
  • ROADMAP.md

Si falta evidencia o aprobacion, el packet queda abierto.