Tema 14 · Configuración de Compose

14. Gestión Avanzada de Volúmenes, Redes y Archivos .env en Compose

Organiza proyectos modulares con sustitución de variables de entorno, redes privadas separadas por capas (frontend/backend) y volúmenes declarativos.

Sustitución Automática de Variables con Archivos .env

Docker Compose lee de forma nativa un archivo llamado .env ubicado en el mismo directorio donde se ejecuta el comando. Esto te permite parametrizar puertos, nombres de imágenes, versiones y credenciales usando la sintaxis ${VARIABLE} o con valores por defecto ${VARIABLE:-valor_defecto}.

# Fragmento en compose.yaml con interpolación:
services:
  web:
    image: nginx:${NGINX_VERSION:-alpine}
    ports:
      - "${HOST_HTTP_PORT:-80}:80"

Aislamiento de Redes en Múltiples Capas (Multi-Tier)

En arquitecturas de seguridad avanzadas, la base de datos nunca debe compartir red con el mundo exterior. Podemos declarar dos redes separadas:

  • red-frontend: Conecta el Proxy Inverso (Nginx) y la aplicación web.
  • red-backend: Conecta la aplicación web y la base de datos (MariaDB/Redis).

De esta forma, si el contenedor de Nginx sufriera una vulnerabilidad, un atacante no podría alcanzar la base de datos de manera directa porque se encuentran en redes virtuales totalmente aisladas.

⚡ Proyecto con Sustitución .env y Redes de Seguridad Frontend/Backend

Ejemplo de archivo .env y su integración limpia dentro del archivo de orquestación compose.yaml:

.env.ejemplo
Solo lectura
# Archivo .env
APP_NAME=kilopolis-saas
APP_ENV=production
APP_PORT=8080

DB_DATABASE=kilo_prod
DB_USER=app_user
DB_PASSWORD=SuperPasswordSecreta9988!

# -------------------------------------------------------------
# Fragmento en compose.yaml:
# services:
#   web:
#     image: nginx:alpine
#     ports:
#       - "${APP_PORT}:80"
#     networks:
#       - frontend_net
#
#   app:
#     image: mi-app-backend:latest
#     networks:
#       - frontend_net
#       - backend_net
#     environment:
#       - DB_PASS=${DB_PASSWORD}
#
#   db:
#     image: mariadb:11
#     networks:
#       - backend_net
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Qué archivo busca automáticamente Docker Compose en el directorio local para sustituir variables con sintaxis ${VARIABLE}?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Docker & Contenedores: De Cero a Producción y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.