Generator Docker Compose

Spec Compose modern

Compose V2 (plugin yang disertakan dengan Docker Desktop dan Docker Engine modern) mengikuti Compose Specification. Key version: sudah usang; generator menghilangkannya. Key tingkat atas adalah services, networks, volumes, configs, dan secrets.

Anatomi service

Sebuah service yang condong ke produksi tampak seperti ini:

services:
  web:
    image: nginx:1.27-alpine
    restart: unless-stopped
    ports:
      - "80:80"
    volumes:
      - ./public:/usr/share/nginx/html:ro
    depends_on:
      app:
        condition: service_healthy
    networks:
      - frontend
      - backend
    healthcheck:
      test: ["CMD", "wget", "--spider", "-q", "http://localhost/health"]
      interval: 30s
      timeout: 5s
      retries: 3

Volume: bind mount vs named

• Bind mount (./app:/var/www) mengikat container ke path di host; bagus untuk pengembangan lokal karena perubahan langsung tercermin.
• Named volume (pgdata:/var/lib/postgresql/data) dikelola Docker dan persisten tanpa bergantung pada path host mana pun; pilihan tepat untuk database dan apa pun yang tidak ingin Anda hapus tak sengaja dengan rm -rf.
• Anonymous volume - hindari. Ia bertahan saat restart tetapi menghilang pada docker compose down -v tanpa peringatan.

Network

Secara default Compose membuat network yang dinamai sesuai proyek dan menghubungkan setiap service ke sana. Mendeklarasikan network eksplisit berguna saat:

• Anda ingin mengisolasi database dari service yang menghadap publik.
• Anda butuh bridge dengan subnet kustom untuk selaras dengan infrastruktur yang ada.
• Anda ingin melampirkan container ke network eksternal yang sudah ada (external: true).

Kesalahan umum yang sebaiknya dihindari

• Konflik key version. version: "3.8" di atas mencegah fitur lebih baru seperti start_interval healthcheck berfungsi di Compose lama; generator menghilangkan key version.
• Kutipan port. 8080:80 terurai sebagai YAML base-60 dalam beberapa edge case; generator selalu mengutip pemetaan port.
• Secret yang di-hardcode. Secret yang ditulis langsung di compose.yml berakhir ter-commit ke git. Simpan dalam env_file atau di tempat penyimpanan secret platform.
• depends_on tanpa condition. depends_on: [db] biasa menunggu container mulai, bukan service siap. Gunakan condition: service_healthy dan tambahkan healthcheck pada dependensi.