Bagaimana cara kerja Docker health checks dan mengapa itu penting?

Question

Accepted Answer

A **health check** memberi tahu Docker (atau orchestrator) tentang cara menentukan apakah aplikasi di dalam container **benar-benar berfungsi**, bukan hanya berjalan. Proses container bisa berjalan sementara aplikasi rusak (hang, tidak bisa terhubung ke database) — health checks mendeteksi ini sehingga platform dapat bereaksi.

## Mendefinisikan health check

```dockerfile
# in a Dockerfile
HEALTHCHECK --interval=30s --timeout=3s --retries=3 \
  CMD curl -f http://localhost:3000/health || exit 1
# → Docker runs this command periodically; exit 0 = healthy, non-zero = unhealthy
```

```yaml
# in docker-compose.yml
healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
  interval: 30s
  timeout: 3s
  retries: 3
  start_period: 10s    # grace period on startup before failures count
```

Docker secara berkala menjalankan perintah health-check; status container menjadi `healthy` atau `unhealthy` berdasarkan hasilnya (terlihat di `docker ps`).

## Running vs healthy (perbedaan kunci)

```text
RUNNING → the container's process is alive (but the APP might be hung/broken)
HEALTHY → the health check confirms the app actually WORKS (responds correctly)
→ A container can be RUNNING but NOT HEALTHY (e.g. the app deadlocked, lost its DB).
  Without a health check, the platform only knows "running" — and keeps sending traffic
  to a broken container.
```

## Mengapa health checks penting secara operasional

```text
✓ ORCHESTRATORS use them: restart unhealthy containers; route traffic only to healthy ones
✓ Compose depends_on: condition: service_healthy → wait for real readiness
✓ LIVENESS (is it alive? restart if not) vs READINESS (ready for traffic? hold traffic if not)
  → Kubernetes uses liveness + readiness probes (the same concept, more granular)
✓ Prevents serving requests from broken-but-running containers
```

## Mengapa ini penting

Memahami Docker health checks penting untuk **menjalankan aplikasi containerized yang dapat diandalkan**, sehingga ini adalah pengetahuan operasional yang berharga.

Wawasan yang krusial adalah perbedaan antara **running dan healthy**: proses container bisa **hidup sementara aplikasi sebenarnya rusak** (hang, deadlock, tidak bisa menjangkau database) — dan tanpa health check, platform hanya tahu container "berjalan" dan akan **terus mengarahkan traffic ke container yang rusak**, menyebabkan kegagalan.

Health checks mengatasi ini dengan mendefinisikan cara memverifikasi bahwa aplikasi **benar-benar berfungsi** (misalnya dengan memanggil endpoint `/health`), sehingga status container mencerminkan kesehatan sebenarnya, bukan hanya liveness proses.

Ini penting **secara operasional** karena orchestrator dan tools beraksi berdasarkannya: mereka **me-restart container yang unhealthy** (pemulihan otomatis dari hang/deadlock) dan **mengarahkan traffic hanya ke container yang healthy** (menghindari mengirim request ke instance yang rusak), dan Compose's `depends_on: condition: service_healthy` menggunakan health checks untuk menunggu kesiapan sejati (mengatasi startup races).

Memahami perbedaan terkait **liveness vs readiness** (apakah hidup dan harus di-restart, vs apakah siap menerima traffic) penting, karena **Kubernetes menggunakan liveness dan readiness probes** yang dibangun atas konsep yang sama — sehingga memahami Docker health checks dapat langsung diterapkan pada lingkungan yang di-orchestrate.

Karena operasi yang dapat diandalkan memerlukan pembedaan antara "berjalan" dan "benar-benar bekerja" serta bereaksi pada container yang rusak-tapi-berjalan (me-restart mereka, menahan traffic), dan karena health checks adalah mekanisme yang mengaktifkan ini — digunakan oleh orchestrator untuk self-healing dan routing traffic — memahami Docker health checks adalah pengetahuan yang berharga dan penting secara praktis untuk menjalankan container secara andal, praktik kunci untuk resiliensi produksi yang mencegah masalah umum container rusak terus menerima traffic secara senyap, dan konsep dasar tentang cara orchestrator menjaga kesehatan aplikasi.