Zero-Downtime Deployment

Zero-downtime berarti pengguna tidak merasakan layanan berhenti saat deploy. Ini membutuhkan kombinasi arsitektur, health check, dan perilaku aplikasi yang benar.

PrasyaratCopy Anchor Link

• Minimal dua instance aplikasi.
• Load balancer/reverse proxy.
• Health check (readiness).
• Graceful shutdown.
• Migrasi database yang kompatibel.
• Proses deploy bertahap.

Alur rolling tanpa downtimeCopy Anchor Link

1. Instance baru dinyalakan
2. Health check lulus
3. Proxy mulai mengirim trafik
4. Instance lama berhenti menerima koneksi baru
5. Instance lama menyelesaikan request aktif
6. Instance lama dimatikan

Health check dan readinessCopy Anchor Link

Reverse proxy hanya boleh mengirim trafik ke instance yang siap.

upstream app_backend {
    server 10.10.10.11:3000 max_fails=3 fail_timeout=10s;
    server 10.10.10.12:3000 max_fails=3 fail_timeout=10s;
}

Dengan health check aktif, instance yang gagal dikeluarkan sementara.

Graceful shutdown Node.jsCopy Anchor Link

Aplikasi harus berhenti menerima koneksi baru, menyelesaikan request aktif, lalu keluar.

const server = app.listen(3000);

function shutdown(signal) {
  console.log(`Menerima ${signal}, mulai shutdown`);
  server.close(() => {
    console.log('Semua koneksi selesai');
    process.exit(0);
  });

  setTimeout(() => {
    console.error('Shutdown timeout, keluar paksa');
    process.exit(1);
  }, 10000);
}

process.on('SIGTERM', () => shutdown('SIGTERM'));
process.on('SIGINT', () => shutdown('SIGINT'));

Dengan PM2, pm2 reload mengirim sinyal dan menunggu proses baru siap.

Docker stop timeoutCopy Anchor Link

services:
  app:
    stop_grace_period: 30s

Pastikan stop_grace_period lebih besar dari waktu maksimum request.

Connection draining di proxyCopy Anchor Link

Saat instance dikeluarkan dari upstream, request yang sedang berjalan harus diselesaikan.

upstream app_backend {
    server 10.10.10.11:3000;
    server 10.10.10.12:3000;
    keepalive 32;
}

server {
    location / {
        proxy_pass http://app_backend;
        proxy_read_timeout 60s;
        proxy_next_upstream error timeout http_502 http_503;
    }
}

proxy_next_upstream membantu jika satu instance gagal.

Migrasi database tanpa downtimeCopy Anchor Link

Gunakan pola expand-contract:

1. Tambah kolom/tabel baru (kompatibel dengan kode lama).
2. Deploy kode yang menulis ke keduanya.
3. Migrasikan data.
4. Deploy kode yang hanya memakai struktur baru.
5. Hapus struktur lama setelah aman.

Blue-green zero downtimeCopy Anchor Link

1. Green dinyalakan dan diuji.
2. Health check green lulus.
3. Proxy diarahkan ke green.
4. Blue tetap hidup sebagai cadangan.
5. Setelah stabil, blue dimatikan.

Rollback hanya dengan mengarahkan proxy kembali ke blue.

Kubernetes readinessCopy Anchor Link

readinessProbe:
  httpGet:
    path: /health
    port: 3000
  initialDelaySeconds: 5
  periodSeconds: 5
  failureThreshold: 3

lifecycle:
  preStop:
    exec:
      command: ["sh", "-c", "sleep 10"]

Readiness menentukan kapan Pod menerima trafik; preStop memberi waktu draining.

Uji zero downtimeCopy Anchor Link

while true; do
  curl -s -o /dev/null -w "%{http_code}\n" https://app.example.com/health
  sleep 0.5
done

Jalankan saat deploy. Jika muncul 502/503, ada celah downtime.

ChecklistCopy Anchor Link

• Minimal dua instance.
• Health check tersedia.
• Graceful shutdown diimplementasikan.
• Stop timeout cukup.
• Proxy mendukung draining.
• Migrasi backward compatible.
• Rollback tersedia.
• Deploy diuji dengan traffic.

RingkasanCopy Anchor Link

• Zero-downtime membutuhkan lebih dari sekadar dua container.
• Health check, graceful shutdown, dan draining adalah kunci.
• Migrasi database harus kompatibel dengan versi lama dan baru.
• Uji dengan traffic nyata, bukan hanya asumsi.