Cara Membuat Healthcheck Docker dan Memilih Restart Policy

• Unhealthy berjam-jam, dan tidak terjadi apa-apa

  Cek yang gagal hanya mengubah status dan memunculkan event. Container tidak di-restart, tidak dihentikan, dan trafik tetap diarahkan ke sana, jadi aplikasi yang rusak terus melayani error sampai ada yang melihat. Buat sesuatu bertindak: --wait saat deploy, monitor yang memberi alert dari status itu atau dari URL di luar, atau Swarm mode, yang mengganti task yang container-nya gagal dicek.

• Connection refused di log health, padahal aplikasinya jalan

  Ceknya memanggil localhost, wget BusyBox mencoba ::1 lebih dulu, sedangkan aplikasinya listen di 0.0.0.0, yang hanya IPv4. Log-nya berisi can't connect to remote host: Connection refused di setiap cek. Tulis 127.0.0.1 di cek, seperti situs ini, atau buat aplikasinya juga listen di IPv6.

• curl: not found, di setiap cek

  Cek yang disalin dari tutorial memanggil curl, padahal image-nya tidak punya: node:20-alpine membawa wget BusyBox tanpa curl. Dalam uji coba, log-nya menampilkan /bin/sh: curl: not found dengan exit code 127, dan container menjadi unhealthy padahal aplikasinya menjawab dengan baik. Pakai tool yang ada di image, dan uji dulu perintah persisnya dengan docker exec.

• Crash loop yang tidak ada habisnya

  always dan unless-stopped me-restart container yang langsung berhenti, terus-menerus, dengan jeda yang makin panjang sampai satu menit. docker ps menampilkan Restarting, dan RestartCount terus naik. Baca docker logs untuk mencari penyebabnya, dan untuk job yang memang boleh menyerah, pakai on-failure dengan batas, misalnya on-failure:3.

1. 1

   Jalankan nginx dengan health check yang meniru milik situs ini, dengan angka waktu yang lebih pendek. Jalankan docker ps langsung dan sekali lagi 10 detik kemudian: starting, lalu healthy.

   docker run -d --name hc-web --restart unless-stopped -p 127.0.0.1:8090:80 \
     --health-cmd "wget --no-verbose --tries=1 --spider http://127.0.0.1/" \
     --health-interval 5s --health-timeout 3s --health-retries 3 --health-start-period 10s \
     nginx:alpine
   docker ps --filter name=hc-web --format '{{.Names}} {{.Status}}'

   Salin
2. 2

   Baca catatan health-nya: status, failing streak saat ini, serta exit code dan output dari setiap cek terbaru.

   docker inspect --format '{{.State.Health.Status}} streak={{.State.Health.FailingStreak}}' hc-web
   docker inspect --format '{{range .State.Health.Log}}{{.ExitCode}} {{.Output}}{{end}}' hc-web

   Salin
3. 3

   Rusak dengan menghapus halaman yang dicek. Sekitar 15 detik kemudian statusnya unhealthy, tetapi nginx masih menjawab (403) dan RestartCount tetap 0, walau memakai unless-stopped.

   docker exec hc-web rm /usr/share/nginx/html/index.html
   # about 15 seconds later:
   docker ps --filter name=hc-web --format '{{.Names}} {{.Status}}'
   curl -I http://127.0.0.1:8090/
   docker inspect --format 'restarts={{.RestartCount}}' hc-web

   Salin
4. 4

   Pulihkan. Satu cek yang lolos sudah cukup untuk kembali healthy. Daftar event menampilkan setiap perubahan status, bukan setiap cek; jika baris healthy terakhir belum muncul, jalankan lagi beberapa detik kemudian.

   docker exec hc-web sh -c 'echo ok > /usr/share/nginx/html/index.html'
   # about 10 seconds later:
   docker inspect --format '{{.State.Health.Status}}' hc-web
   docker events --since 5m --until 0s --filter container=hc-web --filter event=health_status

   Salin
5. 5

   Buat folder kosong bernama health-lab dan simpan ini sebagai compose.yaml. CHECK_PATH memungkinkan Anda merusak cek dari command line, dan worker menunggu api healthy.

   services:
     api:
       image: nginx:alpine
       restart: unless-stopped
       ports:
         - "127.0.0.1:8091:80"
       healthcheck:
         test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://127.0.0.1/${CHECK_PATH:-}"]
         interval: 5s
         timeout: 3s
         retries: 3
         start_period: 10s
     worker:
       image: alpine:3
       command: sleep 600
       depends_on:
         api:
           condition: service_healthy

   Salin
6. 6

   Di folder itu, jalankan dengan --wait: exit 0 dalam hitungan detik. Lalu jalankan lagi dengan cek yang tidak mungkin lolos. Setelah sekitar 20 detik Compose mencetak dependency failed to start, exit 1, dan worker hanya Created tanpa pernah dijalankan.

   docker compose up -d --wait; echo "exit=$?"
   docker compose ps
   docker compose down
   CHECK_PATH=missing docker compose up -d --wait; echo "exit=$?"
   docker compose ps -a

   Salin
7. 7

   Buat container crash di bawah tiga policy, masing-masing berhenti setelah 2 detik. Sekitar 20 detik kemudian: no punya 0 restart, on-failure:3 menyerah di angka 3, dan always terus jalan. Lalu hentikan yang always secara manual: ia tetap mati.

   docker run -d --name hc-no --restart no alpine:3 sh -c 'sleep 2; exit 1'
   docker run -d --name hc-onf --restart on-failure:3 alpine:3 sh -c 'sleep 2; exit 1'
   docker run -d --name hc-always --restart always alpine:3 sh -c 'sleep 2; exit 0'
   # about 20 seconds later:
   docker inspect --format '{{.Name}} restarts={{.RestartCount}}' hc-no hc-onf hc-always
   docker stop hc-always
   docker ps -a --filter name=hc- --format '{{.Names}} {{.Status}}'

   Salin
8. 8

   Bersihkan container-nya, lalu, di dalam health-lab, project Compose-nya.

   docker rm -f hc-web hc-no hc-onf hc-always
   docker compose down

   Salin

Dari: 22. Cara Membaca Permission File Linux: ls -l, chmod, chown · 20. Docker Volume untuk Pemula: Volume, Bind Mount, dan tmpfs

1. 1.Apa arti exit code 0, 1, dan 2 bagi health check?Lihat jawabannya

   Jawaban:0 berarti healthy, 1 berarti unhealthy, dan 2 dicadangkan, jadi jangan dipakai. Dalam uji coba, kode bukan nol lainnya, seperti 127 untuk perintah yang tidak ada, juga dihitung gagal.

2. 2.worker punya depends_on: api dengan condition: service_healthy. Satu jam setelah startup, api menjadi unhealthy. Apa yang dilakukan Compose?Lihat jawabannya

   Jawaban:Tidak ada. Compose hanya mengecek kondisi itu saat menjalankan service. Dalam uji coba, service yang bergantung tetap berjalan setelah dependency-nya menjadi unhealthy.

3. 3.Anda menghentikan container dengan docker stop, lalu server reboot. Apakah ia menyala lagi dengan always? Dengan unless-stopped?Lihat jawabannya

   Jawaban:Dengan always, ya: penghentian manual hanya berlaku sampai daemon di-restart. Dengan unless-stopped, tidak: ia tetap mati sampai Anda menyalakannya sendiri. Perbedaan itulah alasan memilih unless-stopped untuk service yang kadang Anda hentikan untuk maintenance.

• apa yang perlu dicek endpoint health, dengan NestJS Terminus
• health check dan failover di load balancer nginx
• Docker Swarm, tempat health check yang gagal mengganti container