La potència del fitxer .env a Docker Compose

Traducció de l’original en anglès. Llegeix-lo en: CastellanoEnglish

En aquest article demostraré com de potent i flexible pot arribar a ser el fitxer .env quan es configura un compose.yaml per a Docker Compose. Aquest enfocament permet gestionar fàcilment les variables d'entorn, fent que les vostres configuracions de Docker siguin més dinàmiques i manejables.

Comencem amb un fitxer .env senzill:

UBUNTU_VERSION=24.04

I un fitxer compose.yaml corresponent:

services:
  test:
    image: ubuntu:${UBUNTU_VERSION}
    command: ["sh", "-c", "env"]

Quan executeu la pila de Docker Compose amb la comanda docker compose up, veureu una sortida com aquesta:

$ 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  | HOSTNAME=f9002b77bc79
test-1  | HOME=/root
test-1  | PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
test-1  | PWD=/
test-1 exited with code 0

Tanmateix, per fer que les variables definides al fitxer .env estiguin disponibles dins del contenidor Docker, heu d'afegir un parell de línies al vostre fitxer compose.yaml:

services:
  test:
    image: ubuntu:${UBUNTU_VERSION}
    command: ["sh", "-c", "env"]
    env_file:
      - .env

Després d'actualitzar el fitxer compose.yaml, torneu a executar la comanda docker compose up. Aquesta vegada, veureu que la variable d'entorn UBUNTU_VERSION ara s'inclou a l'entorn del contenidor:

$ docker compose up
[+] Running 1/0
 ✔ Container tmp-test-1  Recreated                                                                        0.1s
Attaching to test-1
test-1  | HOSTNAME=069e3c4a4413
test-1  | HOME=/root
test-1  | PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
test-1  | UBUNTU_VERSION=24.04
test-1  | PWD=/
test-1 exited with code 0

Això és increïblement convenient, perquè mantenir el fitxer .env us permet gestionar fàcilment les variables d'entorn entre diferents serveis sense haver de modificar el fitxer compose.yaml cada vegada. Aquest exemple il·lustra clarament com de potent i útil és utilitzar fitxers .env a les configuracions de Docker Compose.