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
services:
app:
image: myapp:latest
ports:
- "3000:3000"
environment:
DATABASE_URL: postgres://app:rahasia@db:5432/app
db:
image: postgres
environment:
POSTGRES_PASSWORD: rahasiaFile 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-alpineUntuk 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-stoppedunless-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_healthyTambahkan 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:
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:
{
"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
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 -fup -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.