Variables de entorno y archivos .env

Escribir contraseñas y puertos directamente en un archivo de Compose es frágil y poco seguro. Las variables de entorno permiten cambiar el comportamiento según el entorno sin editar el YAML.

• Mantener los secretos fuera del control de versiones
• Reutilizar un mismo archivo de Compose en cualquier lugar
• Invalidar valores en tiempo de ejecución

Dentro de un servicio, declare las variables bajo environment como un mapa. Estas variables se inyectan en el contenedor al iniciarlo.

La misma clave también acepta una lista de cadenas KEY=VALUE. Elija el formato que le resulte más legible.

Compose lee automáticamente un archivo llamado .env en el directorio del proyecto. Defina allí los valores una sola vez y haga referencia a ellos mediante la sustitución ${VAR}.

Use ${VAR} en cualquier lugar del archivo de Compose. Compose lo sustituye por el valor de .env o del shell antes de analizar el archivo.

Proporcione un valor alternativo con ${VAR:-default}. Si la variable no está definida o está vacía, se utiliza el valor predeterminado, lo que permite que la pila funcione sin un archivo .env completo.

Use ${VAR:?message} para hacer que una variable sea obligatoria. Compose se detiene y muestra su mensaje si falta, lo que permite detectar pronto una configuración incorrecta.

Para pasar un archivo completo de variables directamente a un contenedor (no solo para realizar sustituciones), use env_file. Cada línea se convierte en una variable de entorno del contenedor.

Cuando una variable se define en varios lugares, Compose aplica un orden de precedencia. El entorno del shell tiene prioridad sobre .env; una entrada explícita de environment: tiene prioridad sobre env_file.

• Shell / CLI -e tiene prioridad
• después environment:
• después env_file
• por último, los valores predeterminados de la imagen

Ejecute docker compose config para mostrar el archivo de Compose completamente resuelto, con todas las sustituciones aplicadas. Es ideal para verificar qué se ejecutará realmente.

Confirme un archivo .env.example con marcadores de posición y añada el archivo .env real a .gitignore. Para los secretos de producción reales, prefiera Docker secrets a las variables de entorno.

¿Cómo funcionan los valores predeterminados en la sustitución?

Ahora puede configurar Compose de forma limpia con datos del entorno:

• environment: inyecta variables por servicio
• Un archivo .env proporciona valores para la sustitución de ${VAR}
• :- proporciona valores predeterminados y :? marca los valores obligatorios
• docker compose config muestra el resultado resuelto

Esto permite usar un mismo archivo de Compose en cualquier entorno.