Variables de entorno
100%

Docker Compose · Lección 5

Variables de entorno

Aprende a distinguir entre un valor que Compose inserta en el archivo y uno que pasa a un contenedor.

Una variable de entorno es un valor con nombre que un programa puede leer. Compose puede usar variables de dos maneras: para insertar un valor al leer el archivo o para pasar valores a un programa dentro del contenedor.

Insertar un valor en el archivo

Guarda el ejemplo como compose.env.yaml en la carpeta de prácticas. La expresión ${PAGE_MODE:-demo} indica que se usa el valor de PAGE_MODE si la variable está definida y no está vacía. En caso contrario, se usa demo.

services:
  toolbox:
    image: busybox:1.36
    environment:
      PAGE_MODE: "${PAGE_MODE:-demo}"

Compose resuelve la expresión antes de crear el contenedor. A esto se le llama interpolación. En otros archivos puedes encontrar la misma técnica para elegir el puerto del anfitrión o la etiqueta de una imagen.

Si PAGE_MODE no está definida, ¿qué valor aparece en la configuración procesada?

Consultar el valor resuelto

Al asignar una variable antes de un comando, el valor se aplica solo a esa ejecución. Usa esta forma para ver cómo cambia la configuración con otro valor. El comando config muestra los ajustes resueltos sin crear ningún contenedor.

$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml config

Busca PAGE_MODE: review en las variables de entorno del servicio. El valor review solo sirve para el ejemplo. Evita incluir secretos en los archivos de ejemplo o en la salida de los comandos.

La configuración procesada muestra review. ¿Qué ha ocurrido hasta ahora?

Pasar un valor al contenedor

La sección environment pasa el valor resuelto a un contenedor nuevo. Usa printenv para que el programa dentro del contenedor temporal muestre ese valor.

$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml run --rm toolbox printenv PAGE_MODE

Deberías ver review. La interpolación eligió el valor y la entrada de entorno lo pasó al contenedor. Una variable que solo se usa para elegir un puerto del anfitrión no pasa automáticamente al entorno del programa.

¿Cómo puedes comprobar qué valor recibe el programa del contenedor de herramientas?

Lección completada

Has completado Variables de entorno

Ya puedes distinguir los dos usos de las variables de entorno.

  • Lee una expresión con valor predeterminado en un archivo de Compose.

  • Revisa la configuración resuelta antes de iniciar un contenedor.

  • Comprueba un valor en el entorno del programa que se ejecuta.

Guarda tu progreso

Crea una cuenta gratuita para guardar esta lección y continuar en cualquier dispositivo.

Crear una cuenta gratuita
Siguiente Lección
Volver a Docker Compose