همه مقالات تخصصی

Healthcheck در Docker؛ تفاوت Running و Healthy

فرآیند کانتینر ممکن است زنده باشد ولی برنامه هیچ درخواست سالمی پاسخ ندهد.

Healthcheck در Docker؛ تفاوت Running و Healthy

Healthcheck این تفاوت را آشکار می‌کند، اما به‌تنهایی برنامه را تعمیر یا restart نمی‌کند. یک probe سبک، معیار صحیح آماده‌بودن و مسیر بررسی خطا برای سرویس HTTP طراحی کنید.

دامنه و پیش‌نیازها

مثال به endpoint محلی /health و ابزار curl داخل image نیاز دارد. endpoint نباید عملیات نوشتن، کوئری سنگین یا داده حساس انجام دهد. برای liveness، readiness و وابستگی دیتابیس قرارداد جدا بنویسید؛ شکست یک وابستگی بیرونی نباید بی‌فکر به طوفان restart منجر شود.

۱. شواهد را جمع‌آوری کنید

Status و Log مربوط به Health را بخوانید، نه فقط docker ps. Exit code، timeout و پیام probe معمولاً تفاوت بین کمبود ابزار، پورت اشتباه و پاسخ نامعتبر را روشن می‌کند. probe را از داخل همان کانتینر اجرا کنید؛ سالم‌بودن درخواست روی میزبان تضمین‌کننده همان namespace نیست.

docker inspect --format "{{json .State.Health}}" web
docker exec web curl -fsS --max-time 3 http://127.0.0.1:8080/health

۲. تغییر کنترل‌شده

در Dockerfile، probe زیر روی localhost:8080 اجرا می‌شود. startup طولانی به start-period مناسب نیاز دارد؛ interval، timeout و retries را با زمان واقعی تطبیق دهید. curl -f پاسخ‌های 4xx/5xx را ناموفق می‌داند، ولی خروجی 200 نامعتبر را تشخیص نمی‌دهد؛ اگر لازم است body را نیز اعتبارسنجی کنید.

# Add to the application Dockerfile; curl must already be installed.
HEALTHCHECK --interval=30s --timeout=5s --start-period=40s --retries=3 \
  CMD curl -fsS --max-time 3 http://127.0.0.1:8080/health || exit 1

۳. نتیجه را آزمایش کنید

در محیط آزمایش یک شکست قابل‌کنترل ایجاد کنید و انتقال starting→healthy و سپس unhealthy را ببینید. Healthcheck به‌تنهایی در Docker Engine کانتینر unhealthy را restart نمی‌کند؛ restart policy به خروج فرآیند اصلی مربوط است. رفتار traffic routing و remediation را در Orchestrator خود جدا آزمایش کنید.

docker inspect --format "{{.State.Status}} {{.State.Health.Status}}" web
docker inspect --format "{{json .State.Health.Log}}" web

بازگشت و پیشگیری

اگر probe باعث فشار یا خطای کاذب شد، تعریف قبلی را در image برگردانید و rollout کنید. حذف Healthcheck مشکل برنامه را حل نمی‌کند. خروجی کوتاه و بدون Secret نگه دارید، برای تغییر قرارداد نسخه بدهید و نرخ false positive را پایش کنید؛ توقف بی‌دلیل probe نباید در مانیتورینگ نامرئی شود.

برای بررسی بخش‌های مرتبط این مسیر، راهنماهای عیب‌یابی DNS و ارتباط سرویس‌ها در شبکه Docker و جلوگیری از پرشدن دیسک با چرخش لاگ Docker را نیز ببینید.

منابع فنی