Environment Variable #

Environment variable adalah salah satu fondasi utama dalam praktik containerization modern. Dengan environment variable, kita bisa memisahkan konfigurasi dari kode aplikasi, sehingga image Docker tetap generik, reusable, dan aman digunakan di berbagai environment (development, staging, production).

Docker Compose menyediakan beberapa cara yang fleksibel untuk mendefinisikan dan mengelola environment variable, mulai dari inline definition, file .env, hingga integrasi dengan secret management.

Artikel ini akan membahas secara lengkap, rinci, dan praktis:

Apa itu environment variable dalam konteks Docker Compose
Cara mendefinisikannya
Urutan prioritas (precedence)
Best practice penggunaan di dunia nyata
Kesalahan umum yang sering terjadi

Apa Itu Environment Variable? #

Environment variable adalah pasangan key-value yang disediakan ke proses aplikasi saat runtime.

Contoh sederhana:

DB_HOST=localhost
DB_PORT=5432
APP_ENV=production

Dalam container:

Aplikasi tidak hardcode konfigurasi
Image tetap sama, yang berubah hanya environment variable

Ini sangat sejalan dengan prinsip Twelve-Factor App.

Peran Environment Variable di Docker Compose #

Docker Compose berfungsi sebagai orchestrator lokal yang:

Menjalankan banyak container
Mengatur networking
Mengatur dependency antar service
Menyuntikkan environment variable ke masing-masing service

Dengan Compose, environment variable bisa digunakan untuk:

Konfigurasi aplikasi (port, mode, feature flag)
Kredensial database atau third-party service
Mengatur perilaku image yang sama di environment berbeda

Cara Mendefinisikan Environment Variable di Docker Compose #

Menggunakan `environment` (Inline) #

services:
  app:
    image: myapp:latest
    environment:
      APP_ENV: production
      APP_PORT: 8080

Atau format list:

environment:
  - APP_ENV=production
  - APP_PORT=8080

Kelebihan:

Jelas dan eksplisit
Mudah dibaca

Kekurangan:

Tidak cocok untuk secret
Sulit dikelola jika jumlah variable banyak

Menggunakan File `.env` #

Docker Compose secara default akan membaca file .env di direktori yang sama dengan docker-compose.yml.

Contoh .env:

APP_ENV=production
APP_PORT=8080
DB_HOST=db
DB_USER=appuser
DB_PASSWORD=secret

Contoh penggunaan di docker-compose.yml:

services:
  app:
    image: myapp:latest
    environment:
      APP_ENV: ${APP_ENV}
      APP_PORT: ${APP_PORT}

Atau otomatis:

services:
  app:
    image: myapp:latest
    env_file:
      - .env

Catatan penting:

.env bukan untuk production secret
Biasanya di-gitignore

Menggunakan `env_file` #

Kita bisa memisahkan environment variable berdasarkan konteks:

services:
  app:
    image: myapp:latest
    env_file:
      - env/common.env
      - env/production.env

Docker Compose akan membaca file secara berurutan.

Use case umum:

common.env → konfigurasi umum
dev.env / staging.env / prod.env → spesifik environment

Variable Substitution #

Docker Compose mendukung variable substitution:

services:
  app:
    image: myapp:${APP_VERSION}
    ports:
      - "${APP_PORT}:8080"

Jika tidak diset:

image: myapp:${APP_VERSION:-latest}

Manfaat:

Compose file lebih dinamis
Satu file untuk banyak environment

Urutan Prioritas Environment Variable (Precedence) #

Dari tertinggi ke terendah:

Environment variable dari CLI (APP_ENV=prod docker compose up)
environment di docker-compose.yml
env_file
File .env
Default value (${VAR:-default})

Memahami urutan ini penting untuk menghindari konfigurasi yang tidak terduga.