Diseño
Dibuje una secuencia de migración y reversión de una release
Un diagrama de secuencia de lanzamiento que hace explícitos el orden de migración, las ventanas de compatibilidad, las puertas de verificación, los desencadenantes de reversión y la propiedad de recuperación de datos antes del despliegue.
El proceso
Hazlo en este orden.
- Define el responsable y el sistema de lanzamiento y migración, los entornos, las versiones actuales y objetivo, la pregunta exacta del diagrama y las restricciones de pérdida de datos, seguridad, accesibilidad, privacidad y tiempo de inactividad.
- Separa la secuencia planificada de los comandos que realmente se ejecutarían; no accedas a producción ni ejecutes comandos de migración, validación o reversión.
- Define precondiciones, actores, estados de versión o esquema y invariantes que deben cumplirse antes del cambio.
- Disponga los pasos hacia adelante en orden, incluyendo copias de seguridad o instantáneas, comprobaciones de compatibilidad, migración, cambio de la aplicación, validación y observación.
- Ramifica cada fallo o punto de parada hacia una reversión o recuperación, marca los pasos irreversibles y la persona que decide, y no prometas reversión después de una pérdida de datos.
- Añade comprobaciones de validación, monitorización, accesibilidad, seguridad e integridad de datos y produce un diagrama estático accesible con alternativa textual; no ensayes ni pruebes comandos.
- Empaqueta el origen del diagrama autocontenido, los supuestos versionados, los enlaces del runbook, los límites de cobertura y un resultado explícito de no ejecución, y detente antes de cualquier lanzamiento o migración real.
Trae esto
Datos que el gato va a pedir.
- versiones de lanzamiento y migración
- mapa de entornos y dependencias
- puertas de compatibilidad y verificación
- responsable de reversión y objetivos de recuperación
Router + un playbook
Enruta primero. Elige uno.
Cat Paw carga un playbook por tarea, no mezcla varios. Empieza por este router; el resto son candidatos específicos del workflow.
- Router:
diagram-design-pack skills/diagram-design-pack/release-migration-rollback-sequence-diagram/SKILL.md
Límites
Los límites viajan con el prompt.
- Verifica las herramientas, cuentas, permisos y el espacio de trabajo reales antes de empezar; nunca afirmes que exista una herramienta, cuenta, fuente o capacidad no disponible.
- Usa Latch/target-workspace para código privado, artefactos, sondeos en vivo o datos no públicos; si ese acceso no está disponible, detente en el límite e informa del bloqueo en lugar de sustituirlo por una suposición.
- Pausa para obtener aprobación explícita antes de acciones externas con consecuencias; devuelve evidencias, riesgos no resueltos, supuestos y cualquier acción que aún esté esperando aprobación.
Listo significa
Un cierre que se puede comprobar.
Un diagrama de secuencia estático, accesible y versionado define estados ordenados, ventanas de compatibilidad, puertas de validación, ramas de recuperación, puntos irreversibles y límites de cobertura, con un resultado explícito de no ejecución.
Fuentes
De dónde sale este proceso.
- github.com/cathrynlavery/diagram-design/tree/dc1ace47b99a419e42d01a03cb6ace5346efa8ae/
- sre.google/sre-book/release-engineering/
- kubernetes.io/docs/concepts/workloads/controllers/deployment/
Las fuentes fijan el patrón del workflow. Los posts de Reddit y de la comunidad, cuando aparecen, se tratan como anécdotas de quien lo practica, no como hechos universales.