Despliegues sin interrupciones con Docker y Nginx

Guía práctica para despliegues sin interrupciones con Docker y Nginx blue/green, CI/CD y monitoreo, asegurando alta disponibilidad para microservicios y monolitos.

19 sept 2025 • 5 min read • Q2BSTUDIO Team

Inteligencia-Artificial-

Despliegues sin interrupciones con Docker y Nginx

Para un responsable DevOps cada minuto de caída equivale a ingresos perdidos, usuarios frustrados y una pérdida de confianza en la marca. Los usuarios modernos esperan servicios disponibles 24 7 y la competencia está a un clic. Implementar despliegues sin interrupciones es clave para lanzar nuevas funcionalidades, parches de seguridad o cambios de configuración sin interrumpir el tráfico. A continuación se describe un proceso práctico y probado que combina Docker, técnicas de proxy inverso con Nginx y automatización CI CD. Al final dispondrás de un flujo de trabajo repetible aplicable a microservicios o monolitos y alineado con servicios como aplicaciones a medida y software a medida ofrecidos por Q2BSTUDIO.

Requisitos previos

Asegúrate de contar con lo siguiente antes de comenzar: Docker Engine actualizado en agentes y hosts objetivo, Docker Compose para pruebas locales opcional, Nginx 1 21 o superior actuando como proxy inverso con soporte para proxy_pass y bloques upstream, un sistema CI como GitHub Actions o GitLab CI que pueda subir imágenes a un registro, y un endpoint de salud en la aplicación que devuelva 200 OK cuando esté lista. Si falta alguno, detén el proceso y soluciona primero ese punto para evitar despliegues a medias.

Paso 1 Construir una imagen Docker inmutable

Escribe un Dockerfile que copie solo lo necesario y ejecute la aplicación como usuario no root. Usa multi stage builds para mantener la imagen pequeña. Etiqueta las imágenes con versión semántica y con el SHA del commit para trazabilidad. Verifica la imagen localmente ejecutando la imagen y comprobando el endpoint de salud. Las buenas prácticas de imagen facilitan auditoría y rollback y encajan con proyectos de software a medida y aplicaciones a medida.

Paso 2 Subir la imagen a un registro

Etiqueta y sube la imagen a un registro privado o gestionado. Asegúrate de que la pipeline CI tenga las credenciales como secretos y haga login antes del push. Esto garantiza que tus artefactos estén disponibles para los hosts de producción y que todo el flujo sea repetible.

Paso 3 Preparar Nginx para enrutado blue green

Configura un bloque upstream que apunte a dos servidores lógicos, por ejemplo app_blue y app_green, y deja uno comentado por defecto. En el bloque server configura proxy_pass al upstream y un location para el endpoint de salud que apunte al slot activo por defecto. Cuando quieras cambiar, modifica el upstream y recarga Nginx de forma segura. Esta técnica aprovecha la recarga elegante de Nginx para lograr cero interrupciones.

Paso 4 Desplegar el nuevo contenedor en paralelo

Levanta la nueva versión en el puerto inactivo, por ejemplo el puerto 3002 para la versión green, usando docker run o Docker Compose. Verifica el endpoint de salud en ese puerto. Si la instancia no responde correctamente, no pases al siguiente paso.

Paso 5 Pruebas de humo sobre la instancia green

Ejecuta un conjunto ligero de pruebas de integración contra la instancia green, centrado en caminos críticos como autenticación, conectividad a base de datos y formatos de respuesta. Si algo falla, detén el despliegue, corrige la imagen y repite los pasos previos. Mantén estas pruebas en la pipeline CI para automatizar calidad.

Paso 6 Cambiar el tráfico de forma atómica

Actualiza el bloque upstream de Nginx para apuntar al slot green y recarga Nginx. Gracias a la recarga elegante, las conexiones existentes terminan en blue mientras las nuevas solicitudes comienzan a llegar a green, logrando un corte sin interrupciones.

Paso 7 Drenar y eliminar el contenedor antiguo

Tras una ventana de observación segura de 5 a 10 minutos, detén y elimina el contenedor blue. Si detectas anomalías, puedes revertir reactivando blue en el upstream y recargando Nginx. Mantén un proceso de rollback claro y probado.

Paso 8 Registro, observabilidad y alertas

Centraliza logs en ELK, Loki o CloudWatch usando drivers de logs de Docker. Expone métricas Prometheus desde la app y configura scrapers. Define alertas sobre fallos en health checks, latencia elevada o picos de error. Un monitoreo adecuado te permitirá detectar regresiones y garantizar SLA para clientes de servicios cloud aws y azure y proyectos de inteligencia de negocio.

Peligros comunes

No omitas los health checks, evita hardcodear puertos, planifica migraciones de base de datos largas en ventanas de mantenimiento o con feature flags, y versiona la configuración de Nginx en Git para poder revertir rápidamente.

Resumen de la checklist

[ ] Dockerfile con multi stage y ejecución no root

[ ] Imagen etiquetada con versión y SHA y subida a registro seguro

[ ] Nginx upstream con slots blue y green, por defecto blue

[ ] Nuevo contenedor lanzado en puerto inactivo y pasa health checks

[ ] Pruebas de humo exitosas contra la nueva instancia

[ ] Upstream de Nginx intercambiado y recargado

[ ] Contenedor antiguo drenado y eliminado

[ ] Logs, métricas y alertas configuradas y verificadas

Reflexión final

Los despliegues sin interrupciones no son magia sino disciplina, automatización y buenas prácticas. Con la inmutabilidad de Docker, la recarga elegante de Nginx y una pipeline CI CD sólida puedes liberar cambios muchas veces al día sin molestar a tus usuarios. En Q2BSTUDIO somos especialistas en desarrollo de software y aplicaciones a medida, con experiencia en inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio y soluciones de automatización. Si buscas implementar despliegues continuos y resilientes contando con apoyo experto, podemos ayudarte a diseñar la arquitectura y la pipeline que mejor se adapte a tu negocio. Consulta nuestros servicios de servicios cloud AWS y Azure o descubre cómo integramos inteligencia artificial en soluciones empresariales para potenciar agentes IA, ia para empresas y proyectos con Power BI. Q2BSTUDIO ofrece servicios que cubren desde ciberseguridad y pentesting hasta desarrollo de software a medida, asegurando despliegues seguros y eficientes.

A BREAK?

Play for a moment before you go

OUR SERVICES

How we can help you

Artificial intelligence

AI agents, chatbots, and intelligent assistants that automate tasks and serve your customers 24/7 to improve the efficiency of your business.

More info

Software Development

Web, mobile, and desktop applications, intranets, e-commerce, SaaS, and management platforms designed for your company's specific needs.

More info

Cloud services

Migration, infrastructure, managed hosting, high availability, and security on Microsoft Azure and Amazon Web Services to help your business scale without limits.

More info

Cybersecurity and pentesting

Security audits, penetration testing and protection of applications, data and infrastructure on-premise and cloud, with ethical hacking and regulatory compliance.

More info

Business Intelligence

Dashboards and data analysis with Power BI: we integrate your sources, design dashboards and KPIs and turn your data into decisions.

More info

Process automation

We automate repetitive tasks and connect your applications with n8n, Power Automate, Make, and RPA, eliminating manual work and increasing productivity.

More info

Training for Companies

We train your teams in technology with criteria: web development, databases, Git, best practices and security, automation with n8n, artificial intelligence for companies and creation of AI solutions with Azure AI Foundry.

More info

Code Auditing

We audit the code that you, your team or an AI create: we tell you what is good and what to improve, we secure it and make it ready for production, web or app.

More info

AI Image Generation

We create for you the images that your business needs with artificial intelligence: product, networks, advertising, illustration and avatars. You tell us what you want and we deliver it ready to use.

More info

AI Video Generation

We create videos with artificial intelligence for you: promotional, networking, virtual presenters, dubbing and animations. You tell us the idea and we will deliver it assembled and ready to publish.

More info

AI Conversational Avatars

We create conversational avatars with AI – digital humans with a face and voice – that serve your customers and teams with the knowledge of your company, on your website, interactive monitors, WhatsApp or Teams.

More info

Online Marketing and AI

Google Ads, Meta Ads, LinkedIn Ads and AI Engine Positioning (GEO/AEO): we attract customers and make your brand appear where they search for you, also on ChatGPT, Gemini and Perplexity.

More info

Do you have a project in mind?

Tell us your vision and we'll turn it into a software solution. Whatever the scope, we make your idea real.

Live Chat