Automatización con Bash y Docker‑Compose: archivos dinámicos, variables y despliegues idempotentes
Introducción
En un entorno de desarrollo moderno, enthusiandos de DevOps y administradores de sistemas cada vez usan Docker Compose para orquestar contenedores locales. Sin embargo, la generación manual de docker‑compose.yml para cada entorno (dev, test, prod) se vuelveRunner de errores, especialmente cuando el número de starving servicios crece. El objetivo de este artículo es mostrar cómo usar un script Bash para generar dinámicamente делать archivo Compose, gestionar variables y secretos de forma segura y desplegar los servicios con scripts idempotentes que garantizan que el estado final sea siempre el mismo, sin efectos secundarios.
Conceptos Fundamentales
Por qué Bash vs Herramientas más pesadas
Python, Go o incluso Ansible pueden manejar la templación de archivos, pero Bash sigue ofreciendo:
- Ligereza y disponibilidad predeterminada en casi todas las distribuciones.
- Capacidad de integrarse con
envsubst,jinja2-cliosedsin dependencias adicionales. - Velocidad de desarrollo para scripts pequeños y tareas repetitivas.
Principios de idempotencia
Un script idempotente es aquel que, al ejecutarse múltiples veces, produce el mismo resultado final sin crear side‑effects adicionales. En contenedores, esto significa:
- Detener y eliminar contenedores existentes antes de crear nuevos.
- Volver a crear volúmenes solo cuando cambian los datos.
- Reapadtoar configuraciones de red solo cuando cambian las reglas.
Generación Dinámica de docker-compose.yml
Estructura del script Base
El siguienteEW script generate_compose.sh recibe como argumento el entorno y genera el archivo Compose usando plantillas parametrizadas.
#!/usr/bin/env bash set -euo pipefailENVIRONMENT=${1:-dev} TEMPLATE=“templates/docker-compose.${ENVIRONMENT}.tpl.yml” OUTPUT=“docker-compose.yml”
echo “Generando ${OUTPUT} para ento ${ENVIRONMENT}…”
envsubst < ”${TEMPLATE}” > ”${OUTPUT}” echo “Archivo completó: ${OUTPUT}”
En el directorio templates se ubican plantillas con variables envsubst: $DB_PASSWORD, $API_KEY, etc. Los valores se inyectan desde el entorno antes de ejecutar el script.
Creación de Plantillas con sed
Para entornos con poca variación, una sola plantilla con sed es suficiente:
cat > templates/docker-compose.tpl.yml <<'EOF'
version: "3.8"
services:
web:
image: ${WEB_IMAGE:-myapp:latest}
environment:
- API_KEY=${API_KEY}
ports:
- "80:80"
db:
image: postgres:13
environment:
POSTGRES_PASSWORD: ${DB_PASSWORD}
volumes:
- db_data:/var/lib/postgresql/data
volumes:
db_data:
EOF
El script luego remplaza las variables en tiempo de ejecución.
Gestión de Variables y Secretos
Uso de docker secret para producción
En Docker Swarm, se pueden almacenar secretos que el servicio accede como archivos. Para Compose, se recomienda usar .env plus -- Eugene-- docker secret create y luego montar en el servicio.
# Crear secreto echo "supersecreto" | docker secret create db_pass -En el docker-compose.yml
services: db: image: postgres:13 secrets: - db_pass
secrets: db_pass: external: true
Variables de entorno en docker-compose.yml
Compose permite leer variables directamente desde un archivo .env. El script puede generar este archivo automáticamente:
cat > .env <
Despliegue Idempotente con Scripts Bash
Stop & Remove Optional Services
Antes de desplegar, eliminamos cualquier instancia existente para evitar colisiones.
docker composeasser up -d
# Cancelar contenedores existentes
docker compose down --remove-orphans
Reconstruir Imagenes al Cambiar de Variables
Para garantizar que una variable de entorno que afecta el build sea tomada en cuenta, se fuerza la reconstrucción condicionalmente.
docker compose down
docker compose build --no-cache
docker compose up -d
Verificación del Estado Final
Un script que comprueba el número de contenedores y su estado garantiza idempotencia नियुक्त:
REQUIRED=3
CURRENT=$(docker ps --filter status=running --format '{{.Names}}' | wc -l)
if [ “$CURRENT” -ne “$REQUIRED” ]; then.Contains=0; fi
if [ “$CURRENT” -ne “$REQUIRED” ]; then
echo “Error: Se esperaban $REQUIRED contenedores pero se encontraron $CURRENT”
exit 1
fiswer
Troubleshooting: Errores Comunes
Variable no sustituida
Si el archivo Compose contiene $HOME y el script no exporta esa variable, Compose mostrará un error de sintaxis. Solución: exportar previamente o usar envsubst con -t para ignorar variables no definidas.
Imagen no encontrada
Al usar variables dentro del campo image, Compose intenta buscar la imagen literalmente. Si la imagen 標 que contiene la variable no existe, el script debe construirla antes:
docker build -t $(cat .env | grep WEB_IMAGE | cut -d= -f2) .
Secret no encontrado en Swarm
En entornos no Swarm, docker secret create falla. Utilice env y --env-file en su lugar.
Múltiples volúmenes persistentes
Si se ejecuta el script con docker compose down sin --volumes, los volúmenes persisten y cambian el estado. Para pruebas, añada --volumes.
Conclusión
La automatización con Bash y Docker Compose permite a los administradores de sistemas y DevOps crear entornos consistentes y reproducibles sin sobrecargar el entorno con herramientas adicionales. Al generar docker-compose.yml dinámicamente, centralizando variables y secretos, y garantizando la idempotencia de los despliegues, se reduce la fricción entre desarrollo, pruebas y producción. El enfoque presentado aquí es ligero, escalable y fácilmente integrable con pipelines CI/CD existentes.