Gestionar las variables de entorno para diferentes entornos, como producción y desarrollo, es crucial para desplegar aplicaciones de forma efectiva. En este artículo voy a demostrar cómo utilizar Docker Compose con archivos .env para cambiar fácilmente entre estos entornos, con el ejemplo de la definición de una variable DEBUG_LEVEL para controlar el registro de la aplicación.
Para empezar, necesitaréis archivos .env distintos para cada entorno:
1. .env (configuración común)
ENVIRONMENT=prod
UBUNTU_VERSION=24.04
Este archivo .env común establece el ENVIRONMENT por defecto en prod (producción) y especifica la versión de Ubuntu. Estas variables se utilizan en todos los entornos.
2. .env.prod (configuración específica de producción)
DEBUG_LEVEL=ERROR
En el entorno de producción, DEBUG_LEVEL se establece en ERROR para minimizar la salida de registro y evitar exponer información sensible.
3. .env.dev (configuración específica de desarrollo)
DEBUG_LEVEL=DEBUG
En el entorno de desarrollo, DEBUG_LEVEL se establece en DEBUG para proporcionar registros detallados para la resolución de problemas y el desarrollo.
El archivo compose.yaml está configurado para cargar dinámicamente el archivo de entorno adecuado según la variable ENVIRONMENT, que se puede definir tanto en el shell como en el archivo .env:
services:
test:
image: ubuntu:${UBUNTU_VERSION}
command: ["sh", "-c", "env"]
env_file:
- .env.${ENVIRONMENT}
Esta configuración utiliza la directiva env_file para cargar el archivo específico del entorno (.env.prod o .env.dev) según el valor de la variable ENVIRONMENT.
Si la variable ENVIRONMENT está definida tanto en el archivo .env como en el shell, el valor establecido en el shell tendrá prioridad. Esto es útil para sobrescribir temporalmente la configuración del entorno sin modificar el archivo .env. Por ejemplo:
Establecer la variable ENVIRONMENT en el shell:
export ENVIRONMENT=dev
Si también tenéis ENVIRONMENT=prod establecido en el archivo .env, la configuración del shell lo sobrescribirá y se utilizarán los parámetros del entorno de desarrollo:
$ docker compose up
[+] Running 2/1
✔ Network tmp_default Created 0.1s
✔ Container tmp-test-1 Created 0.1s
Attaching to test-1
test-1 | DEBUG_LEVEL=DEBUG
test-1 | HOSTNAME=f9002b77bc79
test-1 | HOME=/root
test-1 | PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
test-1 exited with code 0
Si queréis utilizar los parámetros de producción, podéis desasignar la variable del shell y confiar en el valor del archivo .env:
unset ENVIRONMENT
Entonces, cuando volváis a ejecutar docker compose up, la salida reflejará el entorno de producción:
$ docker compose up
[+] Running 2/1
✔ Network tmp_default Created 0.1s
✔ Container tmp-test-1 Created 0.1s
Attaching to test-1
test-1 | DEBUG_LEVEL=ERROR
test-1 | HOSTNAME=f9002b77bc79
test-1 | HOME=/root
test-1 | PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
test-1 exited with code 0
Utilizando archivos .env y estableciendo la variable ENVIRONMENT en el shell, tenéis la flexibilidad de gestionar las variables de entorno de forma dinámica. Este enfoque simplifica el cambio entre entornos y garantiza parámetros de despliegue coherentes, minimizando el riesgo de errores de configuración y mejorando la fiabilidad de la aplicación.