Cara Menggunakan Docker Rollout untuk Zero Downtime Deployment

Membedah Konsep: Bagaimana Docker Rollout Bekerja?

Tahap 1: Instalasi Docker Rollout Plugin

# 1. Buat direktori untuk plugin Docker CLI jika belum ada
mkdir -p ~/.docker/cli-plugins

# 2. Download script docker-rollout versi terbaru dari GitHub
curl https://raw.githubusercontent.com/wowu/docker-rollout/main/docker-rollout -o ~/.docker/cli-plugins/docker-rollout

# 3. Berikan hak akses eksekusi (executable) pada script tersebut
chmod +x ~/.docker/cli-plugins/docker-rollout

docker rollout --help

Tahap 2: Studi Kasus - Deployment API (Golang + PostgreSQL)

1. Persiapan Reverse Proxy (nginx-proxy)

services:
  nginx-proxy:
    image: nginxproxy/nginx-proxy
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /var/run/docker.sock:/tmp/docker.sock:ro
    networks:
      - web-network

networks:
  web-network:
    external: true

2. Refactor File Konfigurasi Aplikasi

# docker-compose.yml (Untuk Aplikasi)
services:
  api:
    image: my-registry.com/pos-api:latest
    # ANTI-PATTERN DOCKER ROLLOUT:
    # container_name: pos-api-1 (HAPUS INI)
    # ports: (HAPUS INI)
    #   - "8080:8080"
    expose:
      - "8080"
    environment:
      - VIRTUAL_HOST=api.notopos.id
      - VIRTUAL_PORT=8080
      - DB_HOST=postgres
    networks:
      - web-network
      - db-network
    # WAJIB ADA: Healthcheck
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 5s
      timeout: 3s
      retries: 3
      start_period: 10s

  postgres:
    image: postgres:15-alpine
    environment:
      - POSTGRES_PASSWORD=secret
    networks:
      - db-network
    volumes:
      - pgdata:/var/lib/postgresql/data

networks:
  web-network:
    external: true
  db-network:

volumes:
  pgdata:

1. Penghapusan container_name: Docker Rollout harus menjalankan 2 container sekaligus saat transisi. Jika nama di-hardcode, akan terjadi bentrok (conflict). Docker Rollout akan otomatis menamai container menjadi [project]-api-1 dan [project]-api-2.
2. Penghapusan ports dan Penggunaan expose: Sama seperti nama, port host tidak bisa dipakai berbarengan. Kita hanya meng-expose port 8080 ke dalam internal network Docker.
3. Environment VIRTUAL_HOST: Ini adalah magic variable yang ditangkap oleh nginx-proxy.
4. Kehadiran healthcheck: Ini adalah "nyawa" dari zero downtime. Docker Rollout akan menahan eksekusi penghapusan container lama sampai endpoint /health ini mengembalikan status HTTP 200 secara konsisten.

3. Eksekusi Deployment dengan Docker Rollout

# 1. Pull image terbaru dari registry
docker compose pull api

# 2. Lakukan rolling update khusus untuk service "api"
docker rollout api

Scaling service api to 2 instances...
Waiting for container project-api-2 to become healthy...
Container project-api-2 is healthy!
Stopping old container project-api-1...
Removing old container project-api-1...
Rollout completed successfully!

Tahap 3: "Cara Solve" - Menyelesaikan Masalah (Troubleshooting Playbook)

Masalah 1: Request Terputus Tiba-tiba di Tengah Transisi (Active Connection Drop)

    labels:
      docker-rollout.pre-stop-hook: "touch /tmp/drain && sleep 15"

http.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
    // Jika file drain eksis, kembalikan HTTP 503 (Unhealthy)
    if _, err := os.Stat("/tmp/drain"); err == nil {
        w.WriteHeader(http.StatusServiceUnavailable)
        return
    }
    w.WriteHeader(http.StatusOK)
    w.Write([]byte("OK"))
})

Masalah 2: Database Migration Locking

1. Pisahkan eksekusi: Migrasi database tidak boleh dijalankan di dalam container aplikasi (via entrypoint). Gunakan container terpisah atau jalankan sebelum rollout.
   
   
   Bash

   docker compose run --rm api migrate up
   docker rollout api
   

2. Aturan Backward Compatibility: Skema database Anda harus selalu mendukung 2 versi kode secara bersamaan (N dan N-1).
   
   
   • Jika Anda ingin menghapus sebuah kolom, rilis kode baru yang berhenti membaca/menulis kolom tersebut lebih dahulu (Deploy 1).
   • Setelah container lama mati, baru lakukan rilis migrasi yang men-drop kolom tersebut (Deploy 2).
   • Jangan pernah me-rename kolom secara langsung. Buat kolom baru, copy datanya, baca/tulis dari 2 kolom, lalu hapus kolom lama secara bertahap.

Masalah 3: Rollout Stuck (Timeout / Infinite Wait)

• Healthcheck URL salah atau memerlukan otentikasi.
• Aplikasi crash saat booting (misalnya karena kehilangan Environment Variable baru), sehingga tidak pernah mencapai status Healthy.

1. Investigasi Container Baru: Jangan hentikan proses rollout dulu. Buka terminal baru dan cek log container yang sedang booting:
   
   
   Bash

   docker logs project-api-2 -f
   

   Cari stack trace atau error yang menyebabkan API gagal berjalan.
2. Atur Parameter start_period: Jika aplikasi Anda adalah aplikasi raksasa berbasis Java Spring Boot atau monolith PHP besar yang butuh 30-40 detik untuk inisialisasi awal, tambah nilai start_period di file docker-compose.yml Anda (misal start_period: 60s).
3. Konfigurasi Timeout Rollout: Secara default, docker rollout menunggu 60 detik. Anda bisa memperpanjang toleransi waktunya melalui parameter -t:
   
   
   Bash

   docker rollout api -t 120
   

Masalah 4: Port Conflict Akibat Hardcoded Port di Codebase

Kesimpulan

1. Container yang Stateless: Hindari menyimpan file aset atau session di dalam file system container (gunakan S3 bucket atau Redis).
2. Reverse Proxy Dinamis: Traefik atau Nginx-Proxy adalah pendamping wajib agar IP internal container baru bisa terdeteksi otomatis.
3. Healthcheck yang Akurat: Jangan hanya mengandalkan pengecekan ping. Pastikan endpoint /health aplikasi Anda benar-benar mengecek kesiapan koneksi database dan cache sebelum merespon dengan status 200 OK.