Orquesta contenedores de forma fiable con Docker Swarm y Docker Compose: crea una imagen de Nginx, define servicios con réplicas, políticas de reinicio y redes overlay, y despliega con docker stack para mantener todo disponible aunque una instancia falle.
¿Cómo preparar el proyecto con Docker Compose y Swarm?
Empezamos organizando el proyecto en una carpeta stacks con una subcarpeta app y un dockerfile para Nginx. Se construye la imagen primero y luego se usa en Docker Compose; aquí se trabaja con imágenes, no con build. En el archivo compose se agregan servicios con la sección deploy: réplicas, paralelismo y retraso de diez segundos para reponer instancias caídas, además de políticas de reinicio y dos networks: frontend y backend, ambas de tipo overlay.
- Se crea la imagen local del frontend con Nginx.
- En compose se usa image: frontend:latest, sin build.
- En deploy se define replicas, paralelismo y delay de 10 segundos.
- Se ajusta la política de reinicio: en un servicio aplica a todo, en otro solo si hay fallo.
- Se definen redes overlay para los servicios.
Comandos ejecutados en terminal.
cd stacks
cd app
ls
# construir la imagen local
docker build -t frontend .
# verificar imágenes
docker images
clear
Decisiones clave en docker-compose.yml.
- Usar la imagen local: frontend:latest.
- Evitar build: se trabaja con imágenes ya creadas o públicas como Nginx.
- En deploy: replicas, paralelismo y un retraso de 10 segundos para recreación.
- Dos redes: frontend y backend.
- Tipo de red requerido por Docker Swarm: overlay.
Despliegue del stack con compose y Swarm.
# desplegar usando el archivo compose
docker stack deploy -c docker-compose.yml mi dispatched
¿Qué pasa cuando caen réplicas en Docker Swarm?
Tras el despliegue, se crean las redes y los servicios definidos. En Docker Desktop se visualizan las réplicas: tres de Nginx y cinco del frontend. Al detener o eliminar una instancia, Swarm detecta la caída y crea una nueva. El estado pasa por “created” en color naranja y luego a verde cuando se ejecuta, manteniendo el servicio disponible todo el tiempo. Esta es la característica más importante de un orquestador: compensar fallos de forma automática.
- Creación automática de redes frontend y backend.
- Ocho contenedores activos: 3 Nginx y 5 frontend.
- Estados visibles: created (naranja) y ejecutándose (verde).
- Si una réplica falla, se repone sola tras el retraso configurado.
¿Cómo verificar y limpiar un stack?
Para inspeccionar y desmontar el despliegue se usan los comandos de stack. Al eliminar el stack, también se limpian las redes. Finalmente, se cierra Docker Swarm.
# listar stacks
docker stack ls
# eliminar el stack y sus redes
docker stack rm mi despliegue
# cerrar Swarm
docker swarm live --force
¿Cuál es el alcance y las limitantes de Docker Swarm?
Funciona muy bien como mini orquestador de servicios en local y para sistemas pequeños o ligeramente medianos. Se manejan con comodidad entre tres y diez réplicas por servicio y el máximo de contenedores permitidos es de 100. Es un gran “entrenador” y puerta de entrada antes de pasar a opciones más robustas.
- Ideal para primeros pasos con orquestadores.
- Manejo sencillo de réplicas y autorecuperación.
- Límite operativo: 100 contenedores.
¿Tienes dudas sobre tu configuración con Docker Swarm y Docker Compose? Comparte tu caso y comenta cómo definirías tus servicios, réplicas y redes overlay.
