Busca en todas las páginas de la documentación
No todos los despliegues erróneos se pueden revertir. Los equipos de entrega eligen entre revertir la imagen anterior, corregir hacia adelante con un parche o desactivar una feature flag, basándose en la compatibilidad de las migraciones y el tiempo para mitigar.
Tarjeta de receta de referencia rápida, lista para copiar y pegar.
## Decisión de reversión (2 minutos)
1. ¿Impacto en el cliente activo? → mitigar primero
2. ¿Despliegue < 2h y existe sha-prev de imagen? → candidata a reversión
3. ¿Migración destructiva o de contrato? → solo corrección hacia adelante
4. ¿Error aislado detrás de una flag? → desactivar flag, luego planificar corrección
5. Registrar decisión + comandos en el hilo de #incidenteCuándo usar esto:
"""rollback_decision.py - codificar la política del equipo como helpers testeables."""
from __future__ import annotations
from dataclasses import dataclass
from enum import Enum
class Mitigation(str, Enum):
FLAG_OFF = "flag_off"
ROLLBACK_IMAGE = "rollback_image"
FORWARD_FIX = "forward_fix"
@dataclass(frozen=True)
class DeployState:
minutes_since_deploy: int
migration_contract: bool # columna eliminada o destructiva
migration_expand: bool
flag_isolates_bug: bool
previous_image_available: bool
def choose_mitigation(state: DeployState) -> Mitigation:
if state.flag_isolates_bug:
return Mitigation.FLAG_OFF
if state.migration_contract:
return Mitigation.FORWARD_FIX
if state.previous_image_available and state.minutes_since_deploy < 120:
return Mitigation.ROLLBACK_IMAGE
return Mitigation.FORWARD_FIX
if __name__ == "__main__":
s = DeployState(25, migration_contract=False, migration_expand=True, flag_isolates_bug=False, previous_image_available=True)
print(choose_mitigation(s))Lo que esto demuestra:
rollout undo.| Situación | Estrategia preferida |
|---|---|
| Lógica errónea, migración de expansión | Desactivar flag o reversión de imagen |
| Bloqueo de índice erróneo | Migración de corrección hacia adelante + quizás reversión |
| Columna eliminada en producción | Solo corrección hacia adelante |
| Error tipográfico en la configuración | Revertir configuración + reiniciar |
| Trabajador incompatible | Pausar trabajadores, revertir API |
# Mantener la imagen anterior de Gunicorn a mano
docker pull $REGISTRY/orders-api:sha-prev
kubectl set image deploy/orders-api api=$REGISTRY/orders-api:sha-prev| Alternativa | Usar Cuando | No Usar Cuando |
|---|---|---|
| Reversión automática ante fallo de canario | Métricas maduras | Esquema no compatible |
| Intercambio Blue-green | Pila anterior precalentada | Flota pequeña sensible al costo |
| Drenaje de tráfico | Solicitudes de larga duración | Necesidad de corrección instantánea |
| Desactivar función en LB | Enrutamiento basado en ruta | Error en middleware compartido |
Objetivo de menos de 10 minutos desde la decisión; practicar en un "game day" trimestral.
La reversión es el artefacto anterior promovido; revertir commit es el siguiente despliegue hacia adelante, más lento.
Migraciones destructivas, migraciones de datos ya aplicadas o imagen de reversión no disponible.
Desplazar el peso de la alias a la versión anterior; el mismo árbol de decisiones sobre el esquema.
Desplegar en un entorno efímero, ejecutar prueba de humo, rollout undo, volver a ejecutar prueba de humo - opcionalmente nocturno.
La reversión de la aplicación no deshace DDL; usar expandir-contrato y PITR para desastres.
Ingeniero individual durante un incidente; capitán de lanzamiento pre-producción. Documentar en el hilo.
Revertir la versión del artefacto del modelo en el registro; puede requerir validación en sombra primero.
Seguir la tasa de fallo de cambios y el MTTR; la reversión rápida mejora ambos.
La imagen incrusta el hash del bloqueo; la reversión restaura automáticamente las dependencias anteriores.
Versiones de Stack: Esta página fue escrita para Python 3.14.0 (estable 3.14, mantenimiento 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, y uv 0.6+.
Revisado por Chris St. John·Última actualización: 16 jul 2026