يكشف Healthcheck هذا الفرق لكنه لا يصلح التطبيق أو يعيد تشغيله بنفسه. صمّم probe خفيفاً بعقد صحة واضح ومسار عملي للتحقيق في الإخفاق.
النطاق والمتطلبات
يتطلب المثال endpoint محلياً /health وأداة curl داخل الصورة. تجنب الكتابة والاستعلامات الثقيلة والمعلومات الحساسة. افصل عقود liveness وreadiness وصحة التبعيات؛ لا تجعل فشل خدمة خارجية يسبب عاصفة إعادة تشغيل لجميع النسخ.
١. اجمع الأدلة
اقرأ حالة Health وسجل probe لا docker ps فقط. توضّح رموز الخروج والمهلة والمخرجات الفرق بين أداة مفقودة ومنفذ خاطئ واستجابة غير صالحة. اختبر داخل الحاوي نفسه؛ نجاح طلب من المضيف لا يثبت الوصول من namespace الحاوي.
docker inspect --format "{{json .State.Health}}" web
docker exec web curl -fsS --max-time 3 http://127.0.0.1:8080/health
٢. نفّذ تغييراً مضبوطاً
يستهدف probe في Dockerfile localhost:8080. اختر start-period وفق زمن البدء الحقيقي ونسّق interval وtimeout وretries. يعتبر curl -f استجابات 4xx/5xx فشلاً لكنه لا يكتشف محتوى غير صالح مع 200؛ تحقّق من المحتوى عند الحاجة.
# 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. لا يعيد Docker Engine تشغيل الحاوي لمجرد unhealthy؛ تتعلق سياسة restart بخروج العملية الرئيسية. اختبر توجيه المرور والمعالجة مستقلة في Orchestrator.
docker inspect --format "{{.State.Status}} {{.State.Health.Status}}" web
docker inspect --format "{{json .State.Health.Log}}" web
التراجع والوقاية
إذا سبّب probe حملاً أو إنذارات كاذبة، استعد تعريف الصورة السابق وانشره. إزالة الفحص لا تصلح التطبيق. اجعل المخرجات قصيرة وخالية من الأسرار، ورقّم العقد وراقب النتائج الكاذبة. غياب probe يجب ألا يبدو صحةً صامتة.
لفحص الجوانب المرتبطة بهذا المسار، راجع تشخيص DNS واتصال الخدمات في شبكة Docker ومنع امتلاء القرص عبر تدوير سجلات Docker.
