Cómo separar las migraciones de la base de datos del inicio de la aplicación durante los despliegues de contenedores

Eva Wong es la redactora técnica y manitas residente en ZimaSpace. Es una geek de toda la vida apasionada por los laboratorios domésticos y el software de código abierto, y se especializa en traducir conceptos técnicos complejos en guías prácticas y fáciles de seguir. Eva cree que alojar servicios propios debería ser divertido, no intimidante. A través de sus tutoriales, ayuda a la comunidad a desmitificar la configuración del hardware, desde montar su primer NAS hasta dominar los contenedores Docker.

Es más fácil evitar las migraciones duplicadas de la base de datos cuando los cambios del esquema se ejecutan como un único paso explícito del despliegue, en lugar de formar parte del inicio de cada contenedor de la aplicación.

El diseño preventivo consiste en asignar a las migraciones un único responsable, un conjunto de credenciales y una señal de finalización antes de que las nuevas réplicas comiencen a atender tráfico. Evita que los contenedores web y de trabajo tengan que reiniciarse con permisos para modificar el esquema, haz que el despliegue espere a que el trabajo de migración se complete correctamente y diseña los cambios del esquema para que las versiones antigua y nueva de la aplicación puedan coexistir brevemente. Así se elimina la condición de carrera, en vez de limitarse a confiar en que cada réplica detecte primero el mismo historial de migraciones.

Elimina los comandos de migración del inicio normal de la aplicación

Inspecciona el punto de entrada de la imagen, el comando de Compose, el comando del trabajador, el contenedor auxiliar de comprobación de estado y el script de despliegue para encontrar llamadas automáticas a las migraciones. La aplicación debe poder reiniciarse sin modificar el esquema, a menos que ese reinicio sea el paso de migración elegido deliberadamente.

Un artículo de Octopus sobre despliegues sostiene que las migraciones necesitan un ciclo de vida independiente, en lugar de vincularse al inicio de cada proceso de microservicio.

Mantén el binario de migración disponible donde sea necesario, pero no lo invoques tanto desde el punto de entrada web como desde un segundo trabajo. Es más fácil auditar un único responsable explícito que varias rutas de inicio que dependen del bloqueo del framework.

Ejecuta un solo trabajo de migración antes del despliegue

Crea un trabajo de ejecución única que use los mismos archivos de migración que la versión y finalice correctamente solo cuando la base de datos de destino alcance el estado de esquema esperado. Haz que el despliegue de la aplicación dependa de ese resultado.

Una guía de despliegue actual muestra cómo se ejecuta un solo trabajo antes del despliegue, en lugar de dejar que todas las réplicas compitan al iniciarse.

No escales la tarea de migración como el servicio de la aplicación. El trabajo debe tener un único responsable de ejecución por base de datos de destino, un tiempo de espera limitado, registros y un estado de error claro que bloquee la nueva versión de la aplicación.

Impide el inicio de la aplicación hasta que la migración se complete correctamente

Haz que los nuevos contenedores web y de trabajo esperen hasta que la etapa de migración indique que se completó correctamente, pero no hagas que cada contenedor en espera vuelva a ejecutar la migración. La dependencia es del resultado, no de volver a ejecutar el cambio del esquema.

El patrón de despliegue de Andrew Lock usa pods de la aplicación que esperan a la migración mientras la lógica de migración permanece centralizada.

En una pequeña infraestructura de servidor doméstico, el mismo principio se puede aplicar con un servicio Compose dedicado y un script de despliegue controlado. Mantén el mecanismo lo bastante simple para que una migración fallida detenga el despliegue de forma visible.

Usa cambios de esquema compatibles con versiones anteriores durante el período de coexistencia

Durante los despliegues graduales, es posible que las versiones antigua y nueva de la aplicación funcionen temporalmente con la misma base de datos. Evita las migraciones que eliminen o cambien el nombre de un campo antes de que la versión antigua haya dejado de usarlo.

Una guía reciente sobre migraciones sin tiempo de inactividad recomienda ampliar antes de contraer, de modo que los cambios aditivos del esquema se apliquen antes de la limpieza destructiva.

Cuando sea necesario, divide los cambios grandes en fases de ampliación, relleno de datos, cambio y contracción. El trabajo de migración no debería crear un esquema que solo entienda el contenedor nuevo mientras las réplicas antiguas siguen atendiendo solicitudes.

Mantén las credenciales de migración fuera de las réplicas de la aplicación

Cuando sea viable, usa una cuenta de base de datos con privilegios para modificar el esquema solo durante la fase de migración de una sola ejecución. Los contenedores normales de la aplicación deberían conservar únicamente los permisos de lectura y escritura más limitados que necesitan para los datos de la aplicación.

Un artículo sobre despliegues con Liquibase describe que los cambios de la base de datos deben formar parte de la automatización, con una aplicación de cambios controlada y repetible.

Esta separación reduce la probabilidad de que las migraciones se ejecuten accidentalmente, incluso si se reinicia o se duplica un proceso de la aplicación. Guarda la credencial con privilegios elevados en la ruta de secretos del despliegue, no en el entorno habitual del servicio de larga duración.

Verifica que el despliegue no pueda aplicar el lote dos veces

Prueba el despliegue en una base de datos desechable o en una instantánea restaurada: inicia varias réplicas de la aplicación, reinícialas y vuelve a ejecutar el comando de despliegue. La fase de migración debería indicar el estado actual del esquema sin volver a modificarlo.

JetBrains resume la regla operativa así: ejecutar las migraciones como paso del despliegue antes del inicio normal de la aplicación.

La política de prevención está completa cuando los reinicios de la aplicación no pueden modificar el esquema, una migración fallida bloquea el lanzamiento y las ejecuciones repetidas del despliegue no modifican la base de datos. El artículo relacionado de ZimaSpace sobre diagnóstico de migraciones duplicadas es la vía de recuperación si ya se produjo una ejecución duplicada.

Soporte y consejos

Más para leer

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.