Skip to content

Docker Compose untuk produksi, bukan sekadar docker compose up

Pengaturan Docker Compose yang membuat layanan di server tunggal lebih stabil, yaitu versi image yang dikunci, healthcheck, restart policy, batas resource, rotasi log, secret, dan jebakan Docker dengan UFW.

published
reading time
3 min

Docker Compose sering dianggap alat untuk development saja. Kenyataannya, banyak aplikasi kecil dan menengah berjalan dengan nyaman di satu VPS memakai Compose selama bertahun-tahun. Kubernetes tidak selalu dibutuhkan. Yang dibutuhkan adalah file Compose yang ditulis dengan mempertimbangkan apa yang terjadi saat container crash, disk penuh, atau server reboot.

Artikel ini membahas pengaturan yang membedakan file Compose "asal jalan" dengan file Compose yang siap dipakai di produksi.

Contoh awal yang umum

compose.yaml (sebelum)
services:
  app:
    image: myapp:latest
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgres://app:rahasia@db:5432/app
  db:
    image: postgres
    environment:
      POSTGRES_PASSWORD: rahasia

File ini berjalan, tapi punya setidaknya enam masalah. Kita perbaiki satu per satu.

1. Kunci versi image

latest dan image tanpa tag berarti versi yang dipakai bisa berubah setiap kali Anda menjalankan docker compose pull. Hari ini Postgres 16, bulan depan mungkin Postgres 17 yang format datanya tidak kompatibel. Database tidak akan bisa start, dan penyebabnya tidak jelas.

  db:
    image: postgres:16.4-alpine

Untuk image aplikasi sendiri, gunakan tag berdasarkan versi rilis atau hash commit git, misalnya myapp:1.8.2 atau myapp:3f9c2ab. Dengan begitu, rollback cukup dengan mengganti tag.

2. Restart policy

Tanpa restart policy, container yang crash akan tetap mati, dan setelah server reboot, tidak ada yang menyalakannya kembali.

    restart: unless-stopped

unless-stopped menyalakan ulang container setelah crash atau reboot, kecuali Anda sengaja menghentikannya dengan docker compose stop. Ini pilihan yang tepat untuk hampir semua layanan.

3. Healthcheck dan urutan start

depends_on biasa hanya menunggu container database dibuat, bukan siap menerima koneksi. Aplikasi yang start lebih dulu akan gagal terhubung dan crash.

  db:
    image: postgres:16.4-alpine
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U app -d app"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
 
  app:
    depends_on:
      db:
        condition: service_healthy

Tambahkan juga healthcheck untuk aplikasi Anda. Endpoint seperti /healthz yang memeriksa koneksi database adalah pola yang baik. Status kesehatan terlihat di docker compose ps, dan berguna untuk pemantauan.

4. Jangan simpan rahasia di file Compose

File Compose biasanya masuk git. Password di dalamnya akan ikut tersimpan di riwayat git selamanya. Pindahkan ke file .env yang tidak di-commit:

.env
POSTGRES_PASSWORD=isi-dengan-password-acak-panjang
  db:
    environment:
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?wajib diisi}

Sintaks ${VAR:?pesan} membuat Compose menolak berjalan jika variabel kosong. Ini mencegah layanan berjalan dengan password kosong secara tidak sengaja. Tambahkan .env ke .gitignore dan sediakan .env.example berisi nama variabel tanpa nilai.

Untuk rahasia yang lebih sensitif, Compose juga mendukung secrets yang dipasang sebagai file di /run/secrets/. Banyak image resmi, termasuk Postgres, mendukung variabel _FILE seperti POSTGRES_PASSWORD_FILE untuk membaca dari file tersebut.

5. Ikat port ke localhost

Ini jebakan yang paling banyak memakan korban. Saat Anda menulis "3000:3000", Docker membuka port 3000 di semua interface, termasuk IP publik. Docker menulis aturan iptables sendiri yang diproses sebelum aturan UFW. Artinya, meskipun ufw status menunjukkan port 3000 tertutup, port itu tetap bisa diakses dari internet.

Jika aplikasi diakses melalui reverse proxy di host yang sama, ikat port ke 127.0.0.1:

    ports:
      - "127.0.0.1:3000:3000"

Database hampir tidak pernah perlu port yang dipublikasikan. Aplikasi mengaksesnya melalui jaringan internal Compose dengan nama layanan db. Hapus bagian ports dari layanan database sepenuhnya.

6. Rotasi log

Secara default, Docker menyimpan log container di file JSON tanpa batas ukuran. Aplikasi yang banyak menulis log bisa memenuhi disk dalam beberapa minggu, dan disk penuh akan mematikan database.

    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "5"

Konfigurasi ini membatasi log setiap container maksimal 50 MB. Agar berlaku untuk semua container, atur juga di /etc/docker/daemon.json:

/etc/docker/daemon.json
{
  "log-driver": "json-file",
  "log-opts": { "max-size": "10m", "max-file": "5" }
}

7. Batasi resource

Satu container yang bocor memori bisa membuat seluruh server kehabisan RAM dan memicu OOM killer secara acak.

    deploy:
      resources:
        limits:
          memory: 512M
          cpus: "1.0"

Docker Compose versi 2 menerapkan deploy.resources.limits meskipun tidak memakai Swarm. Dengan batas memori, container yang bermasalah dihentikan sendiri, lalu dinyalakan ulang oleh restart policy, tanpa mengganggu layanan lain.

8. Volume bernama untuk data

  db:
    volumes:
      - pgdata:/var/lib/postgresql/data
 
volumes:
  pgdata:

Volume bernama tidak hilang ketika container dihapus. Tapi ingat, docker compose down -v akan menghapusnya. Jangan pernah menjalankan perintah itu di server produksi tanpa backup.

Hasil akhir

compose.yaml (sesudah)
x-logging: &default-logging
  driver: json-file
  options:
    max-size: "10m"
    max-file: "5"
 
services:
  app:
    image: registry.contoh.com/myapp:1.8.2
    restart: unless-stopped
    env_file: .env
    ports:
      - "127.0.0.1:3000:3000"
    depends_on:
      db:
        condition: service_healthy
    healthcheck:
      test: ["CMD", "wget", "-qO-", "http://localhost:3000/healthz"]
      interval: 30s
      timeout: 5s
      retries: 3
    deploy:
      resources:
        limits:
          memory: 512M
    logging: *default-logging
 
  db:
    image: postgres:16.4-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: app
      POSTGRES_DB: app
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?wajib diisi}
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U app -d app"]
      interval: 10s
      timeout: 5s
      retries: 5
    logging: *default-logging
 
volumes:
  pgdata:

Blok x-logging dengan anchor YAML (&default-logging) menghindari pengulangan konfigurasi yang sama di setiap layanan.

Alur deploy yang aman

docker compose pull
docker compose up -d
docker compose ps
docker image prune -f

up -d hanya membuat ulang container yang image atau konfigurasinya berubah. Periksa docker compose ps untuk memastikan semua layanan berstatus healthy, lalu bersihkan image lama agar disk tidak penuh.

Penutup

Docker Compose bisa sangat andal untuk produksi skala kecil asalkan file-nya ditulis dengan sadar. Versi terkunci, healthcheck, restart policy, port yang tidak terbuka sembarangan, log yang dibatasi, dan resource yang dikontrol mencegah sebagian besar insiden yang biasanya baru ketahuan pukul dua pagi. Jangan lupa bahwa semua ini tetap butuh backup data yang teruji, yang saya bahas di artikel tentang restic.

Docker Compose untuk produksi, bukan sekadar docker compose up · Rafli Anggoro