Arquitectura de Software

CI/CD: cómo preparar un rollback seguro antes de desplegar cambios

Guía para preparar un rollback seguro en CI/CD: definir cuándo revertir, versionar artefactos, gestionar flags y migraciones, probar la reversión y distinguirla de la recuperación de datos.

CI/CD: cómo preparar un rollback seguro antes de desplegar cambios

Un despliegue puede completar todos sus pasos técnicos y aun así introducir errores en producción: una API que deja de aceptar el formato anterior, una migración de base de datos incompatible o una funcionalidad que falla solo bajo carga real. En ese momento, la pregunta no debería ser si el equipo puede volver a la versión anterior, sino qué significa volver atrás, qué riesgos implica y quién toma la decisión.

Preparar un rollback seguro requiere más que conservar una imagen anterior del servicio. También implica versionar artefactos, controlar la activación de funcionalidades, diseñar cambios de esquema compatibles, definir criterios operativos y comprobar que la reversión funciona antes de necesitarla. Esta guía presenta un enfoque práctico para equipos de backend, DevOps, SRE, QA y arquitectura.

Qué problema resuelve un rollback planificado

Un rollback es la reversión controlada de una versión de aplicación o de una parte del despliegue hacia un estado anterior conocido. Su objetivo principal es reducir el impacto de un cambio defectuoso mientras el equipo investiga la causa.

Sin un plan previo, la reversión suele convertirse en una secuencia improvisada de decisiones bajo presión:

  • se busca qué versión estaba activa;
  • se intenta reconstruir un artefacto que quizá ya no es reproducible;
  • se descubre que la base de datos cambió de forma irreversible;
  • se desactivan funcionalidades sin saber si existen dependencias entre servicios;
  • varias personas ejecutan acciones simultáneas sin una responsabilidad clara.

Un rollback preparado no elimina todos los incidentes. Lo que hace es limitar el tiempo de exposición, reducir decisiones ambiguas y evitar que una recuperación apresurada cause un problema mayor.

Rollback de aplicación no es recuperación de datos

Volver a una versión anterior del código no restaura automáticamente los datos modificados por la nueva versión. Esta distinción es fundamental:

  • Rollback de aplicación: desplaza el runtime hacia una versión anterior del artefacto.
  • Rollback de configuración: recupera valores anteriores de configuración, reglas o activaciones.
  • Rollback de esquema: intenta revertir cambios en tablas, índices o estructuras de persistencia.
  • Recuperación de datos: restaura información desde copias de seguridad, réplicas, registros de cambios u otros mecanismos de recuperación.

Si una nueva versión transforma datos, elimina información o produce efectos externos, cambiar el binario no deshace esas operaciones. Por eso, el diseño del rollback debe considerar el comportamiento de los datos y no únicamente el artefacto de la aplicación.

Define cuándo activar la reversión

Un equipo necesita criterios observables para decidir cuándo detener un despliegue o revertirlo. “Si algo parece raro” no es suficiente: deja demasiado espacio para interpretaciones y puede retrasar una decisión importante.

Criterios técnicos y de negocio

Los criterios pueden combinar señales de observabilidad con impacto funcional. Por ejemplo:

  • aumento sostenido de errores de servidor o de respuestas inválidas;
  • incremento de latencia por encima del umbral acordado para una operación crítica;
  • fallos en comprobaciones de salud o en pruebas sintéticas posteriores al despliegue;
  • pérdida de compatibilidad con clientes o consumidores de una API;
  • duplicación, pérdida o corrupción aparente de eventos;
  • incumplimiento de una regla de negocio relevante;
  • impacto en un flujo de ingresos, autenticación, pagos o procesamiento de pedidos.

Estos criterios deben indicar también el periodo de observación y la acción esperada. Una métrica aislada puede ser ruido; un patrón sostenido acompañado de impacto funcional puede justificar una reversión inmediata.

Responsables y autoridad para decidir

Antes del despliegue debe estar claro quién puede:

  • detener la promoción entre entornos;
  • activar o desactivar una feature flag;
  • ordenar un rollback de aplicación;
  • declarar un incidente;
  • comunicar el impacto a otras áreas;
  • aprobar una recuperación de datos.

La responsabilidad no tiene que recaer en una sola persona. Puede existir un responsable operativo, un referente técnico y una persona encargada de la comunicación. Lo importante es evitar que, durante el incidente, el equipo discuta quién tiene permiso para actuar.

Versiona artefactos y haz que la reversión sea reproducible

Un rollback seguro comienza con la capacidad de identificar exactamente qué se desplegó. Cada artefacto debería poder relacionarse con una versión de código, una configuración compatible y un conjunto de cambios conocido.

En lugar de depender de etiquetas ambiguas como latest o producción, conviene utilizar identificadores inmutables y trazables. El formato concreto depende de la plataforma, pero el principio es el mismo: una versión promovida debe poder recuperarse sin reconstrucciones inciertas.

Qué debería quedar registrado
  • identificador único del artefacto desplegado;
  • commit o referencia exacta del código fuente;
  • versión de cada servicio involucrado;
  • configuración relevante y cambios de parámetros;
  • migraciones ejecutadas y su estado;
  • fecha, responsable y entorno de la promoción;
  • dependencias externas o contratos modificados.

También es importante que el pipeline no dependa de cambios manuales no registrados. Si una persona modifica una configuración directamente en producción y esa modificación no queda asociada a la versión, la reversión puede restaurar el código pero conservar un entorno incompatible.

El artefacto anterior debe seguir siendo utilizable

Conservar una versión anterior no garantiza que pueda ejecutarse. Puede depender de una variable eliminada, de una imagen base que ya no está disponible o de un contrato que cambió en otro servicio.

Por eso, la preparación debe incluir la retención de artefactos durante el periodo necesario, la documentación de dependencias y una comprobación periódica de que una versión candidata a rollback todavía puede iniciarse y operar contra el entorno actual.

Diseña cambios compatibles con feature flags y despliegues graduales

Separar el despliegue del código de la activación de una funcionalidad reduce el riesgo. Una versión puede instalarse en producción sin exponer inmediatamente el comportamiento nuevo a todos los usuarios.

Las feature flags pueden servir para:

  • activar una función para un grupo limitado;
  • comparar el comportamiento nuevo y el anterior;
  • desactivar una capacidad sin reinstalar la aplicación;
  • mantener una ruta de compatibilidad durante una migración.

Sin embargo, una feature flag también introduce complejidad. Debe tener un propietario, una condición de activación clara, una estrategia de salida y un comportamiento definido si el sistema no puede consultar su estado. Las flags permanentes pueden generar combinaciones difíciles de probar y convertirse en deuda operativa.

Compatibilidad hacia atrás y hacia adelante

En sistemas distribuidos, las versiones no siempre se actualizan al mismo tiempo. Durante una transición pueden coexistir consumidores y productores antiguos y nuevos. Por esa razón, un cambio debe evaluarse en ambos sentidos:

  • ¿la versión nueva puede leer datos producidos por la versión anterior?
  • ¿la versión anterior puede seguir leyendo datos producidos por la versión nueva?
  • ¿los mensajes publicados mantienen un contrato compatible?
  • ¿un cliente antiguo puede comunicarse con el endpoint actualizado?

Los despliegues graduales ayudan a observar el comportamiento antes de ampliar la exposición, pero no reemplazan el diseño de compatibilidad. Si la primera instancia nueva escribe un formato que las instancias antiguas no entienden, el problema puede aparecer incluso durante una promoción parcial.

Trata las migraciones de base de datos como parte del rollback

La base de datos suele ser el punto que limita la reversión. El código puede volver atrás en segundos, pero un cambio de esquema puede haber alterado datos de forma que la versión anterior ya no pueda utilizarlos.

El patrón expandir y contraer

Para cambios con riesgo de incompatibilidad, una estrategia habitual es dividir la transición en fases:

  • Expandir: agregar estructuras nuevas sin eliminar ni modificar de forma incompatible las existentes.
  • Migrar: adaptar progresivamente los datos, preferiblemente de forma controlada y verificable.
  • Cambiar la aplicación: hacer que el código utilice la nueva estructura, manteniendo temporalmente la compatibilidad necesaria.
  • Contraer: retirar columnas, índices o rutas antiguas cuando ya no existan consumidores dependientes.

Este enfoque reduce la necesidad de que un rollback dependa de deshacer inmediatamente una migración. A cambio, exige convivir durante un tiempo con más de una representación del dato y definir cómo se mantiene la consistencia entre ellas.

Qué cambios son difíciles de revertir
  • eliminación de columnas o tablas;
  • transformaciones destructivas de valores;
  • cambios de significado en un campo existente;
  • reemplazo de identificadores utilizados por otros sistemas;
  • publicación de eventos que desencadenan acciones irreversibles;
  • escrituras duplicadas o incorrectas que ya fueron procesadas por consumidores.

Una migración reversible no siempre es la mejor opción. En algunos casos, reconstruir los datos desde una fuente de verdad o restaurar una copia puede ser más seguro que ejecutar una migración inversa. La decisión debe documentarse antes del despliegue.

Ejemplo: un cambio incompatible en una API

Imaginemos una API de pedidos que antes devuelve un campo customerName y que una nueva versión lo reemplaza por un objeto customer. El equipo despliega el cambio junto con una modificación en la base de datos y descubre que una aplicación móvil antigua no puede procesar la nueva respuesta.

Un rollback simple del servicio podría no resolver el problema si la migración eliminó o transformó la información que la versión anterior esperaba. También podría producir inconsistencias si otros componentes ya escribieron usando el nuevo formato.

Decisiones preventivas
  • mantener temporalmente ambos formatos de respuesta;
  • introducir el nuevo contrato detrás de una activación controlada;
  • agregar la nueva estructura de datos sin eliminar la anterior;
  • verificar que ambas versiones de la aplicación pueden operar durante la transición;
  • probar el rollback con datos representativos;
  • definir qué ocurre con los pedidos creados mientras la versión nueva estuvo activa.

Si el incidente ocurre, el equipo podría desactivar la funcionalidad nueva, detener la promoción y volver a la versión anterior de la aplicación. Si ya existen datos escritos únicamente en el formato nuevo, será necesario ejecutar una transformación compatible, reconstruir información desde una fuente confiable o iniciar un proceso de recuperación. El rollback del binario, por sí solo, no resuelve esa parte.

Prueba la reversión y monitorea después del cambio

Un plan de rollback que nunca se ensaya suele contener supuestos ocultos. La prueba no necesita reproducir todos los detalles de producción, pero debe validar las partes críticas del procedimiento.

Qué comprobar antes del despliegue
  • que el artefacto anterior puede localizarse y ejecutarse;
  • que las instrucciones de reversión están actualizadas;
  • que los permisos necesarios están disponibles;
  • que las migraciones y sus dependencias están identificadas;
  • que los health checks detectan fallos relevantes y no solo que el proceso está activo;
  • que las métricas y logs permiten comparar la versión anterior con la nueva;
  • que el procedimiento de desactivación de feature flags funciona;
  • que las personas responsables conocen su rol.

Cuando sea posible, conviene realizar una prueba controlada de reversión en un entorno representativo. El objetivo no es demostrar que siempre se puede volver atrás, sino descubrir qué partes no son reversibles y convertir esa información en una decisión explícita.

Monitoreo posterior al despliegue

La observación debe cubrir tanto la salud técnica como el resultado funcional. Algunas señales útiles son:

  • errores por endpoint, operación o versión;
  • latencia y saturación de recursos;
  • tasas de reintentos y timeouts;
  • lag o acumulación en consumidores de eventos;
  • fallos de validación de contratos;
  • métricas de negocio relacionadas con el flujo modificado;
  • divergencias entre lecturas y escrituras durante una migración dual.

Después de un rollback también hay que monitorizar. Una versión anterior puede reducir el error visible y, al mismo tiempo, generar incompatibilidades con datos o mensajes producidos por la versión nueva.

Checklist para preparar un rollback seguro

Antes de aprobar un despliegue, el equipo puede revisar las siguientes preguntas:

  • ¿Cuál es el artefacto exacto que se desplegará y cuál es el anterior?
  • ¿Cómo se identifica y recupera cada versión?
  • ¿Qué métricas o eventos activan una pausa o una reversión?
  • ¿Quién tiene autoridad para tomar la decisión?
  • ¿El cambio mantiene compatibilidad con clientes, consumidores y otras instancias?
  • ¿La migración de base de datos es reversible, compatible o requiere recuperación?
  • ¿Qué datos podrían haberse escrito con el nuevo formato?
  • ¿Existe una feature flag o una alternativa para reducir la exposición?
  • ¿Se probó la reversión con datos y dependencias representativas?
  • ¿Qué comunicación debe enviarse si el rollback afecta a usuarios o equipos?

Si alguna respuesta no está clara, el despliegue no necesariamente debe cancelarse, pero sí requiere una decisión consciente. El riesgo puede aceptarse, mitigarse con una fase adicional o posponerse hasta contar con un mecanismo de recuperación adecuado.

Conclusión: el rollback se diseña antes del despliegue

Una reversión segura no consiste únicamente en ejecutar una versión anterior. Requiere artefactos reproducibles, contratos compatibles, migraciones planificadas, feature flags cuando aporten control, criterios de activación, monitoreo y responsables definidos.

La decisión más importante es distinguir qué puede deshacerse automáticamente y qué requiere una estrategia de recuperación de datos. En sistemas distribuidos y despliegues frecuentes, diseñar para la compatibilidad suele ser más seguro que depender de migraciones inversas ejecutadas bajo presión.

Antes del próximo despliegue, ensaya la reversión de una versión y documenta qué cambios de datos no pueden deshacerse automáticamente. Este ejercicio puede convertirse en una práctica de capacitación técnica y de mejora operativa para equipos que trabajan en arquitectura, backend, DevOps y confiabilidad.

Siguiente paso

Profundiza en patrones de arquitectura

Este artículo explica el concepto. El ebook junta los patrones, cuándo usar cada uno y cómo compararlos. Cuesta USD 15.

Crear cuenta

Recibe recursos puntuales por correo (paso opcional).

Whatsapp Mentores Tech