Admin-Sistemas ·

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-cli o sed sin 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 pipefail

ENVIRONMENT=${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:

RESET
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.