اجتياز Healthcheck قبل النشر لا يثبت سلامة إيقاف التطبيق. يجب وقف استقبال عمل جديد وإنهاء العمل الجاري أو حفظ حالته وإغلاق الموارد. يتتبع الدليل إشارة Docker داخل شجرة العمليات ويختبر سلامة البيانات بدلاً من اعتبار زيادة المهلة ضماناً.
النطاق والسلوك الافتراضي
نفّذ اختبارات الإيقاف في Staging أو نافذة صيانة معتمدة؛ يوقف docker stop الخدمة. استبدل r89-api والصورة التوضيحية بخدمة اختبار. هذا دليل لسلوك التطبيق، وليس إذناً لإيقاف قاعدة بيانات إنتاج بلا خطة استعادة.
يرسل Docker أولاً SIGTERM إلى العملية الرئيسية ما لم تُضبط إشارة مخصصة. إذا لم تخرج العملية خلال المهلة، يرسل SIGKILL. الإعداد المعتاد عشر ثوانٍ في Linux وثلاثون في Windows، لكن إعداد الحاوية وخيار timeout قد يغيّران ذلك.
١. افحص العملية الرئيسية والتوقيت
سجّل أمر البدء وإشارة الإيقاف وسياسة إعادة التشغيل والأحداث. طابق أوقات سجلات التطبيق مع stop وkill وdie. قد لا تحتوي صور distroless على sh أو ps؛ يمكن استخدام docker top من المضيف لمشاهدة العمليات.
يرتبط رمز 137 عادةً بـSIGKILL، لكنه لا يثبت أن مهلة الإيقاف هي السبب؛ قد يكون OOM أو kill خارجياً. قارن OOMKilled وسجلات النواة وأحداث Docker. قد يكشف inspect الكامل متغيرات حساسة، لذا اطلب الحقول الضرورية فقط.
docker inspect --format 'StopSignal={{.Config.StopSignal}} Restart={{.HostConfig.RestartPolicy.Name}}' r89-api
docker top r89-api
docker logs --since 10m --tail 200 r89-api
docker events --since 10m --until "$(date -Iseconds)" --filter container=r89-api
٢. أوصل الإشارة إلى التطبيق
استخدم صيغة exec في ENTRYPOINT مثل ENTRYPOINT ["node", "server.js"] حتى لا يحجب shell غير مسؤول التطبيق. عند الحاجة إلى سكربت بدء، اختمه بـexec أو نفّذ تمرير الإشارات والإشراف صراحة. تعديل CMD وحده لا يصلح ENTRYPOINT خاطئاً.
يضيف init: true في Compose عملية init صغيرة لتمرير الإشارات وجمع العمليات الأبناء، لكنه لا ينشئ منطق cleanup. يحتاج التطبيق نفسه إلى معالجة SIGTERM لوقف العمل الجديد وتصريف الاتصالات وإنهاء العمل الجاري أو حفظ حالته ضمن مهلة داخلية محدودة.
٣. حدّد المهلة وفق العمل الحقيقي
مقتطف Compose توضيحي وليس مشروعاً كاملاً. ثلاثون ثانية ليست توصية عامة؛ قِس مدد الطلبات والمعاملات والمهام وراعِ مهل موزّع الحمل. يجب أن ينتهي cleanup قبل مهلة الحاوية مع سياسة واضحة لإعادة المحاولة عند عدم اكتمال العمل.
تحقق من الإعداد وطبّقه بنشر مخطط؛ إعادة تشغيل الحاوية الموجودة لا تطبّق بالضرورة إعدادات إنشائها الجديدة. طابق StopSignal المخصصة مع وثائق الصورة. لا يمكن التقاط SIGKILL للتنظيف، وقد تؤخر المهلة غير المحدودة النشر إلى أجل غير معروف.
# Compose fragment: use your real, tested application image.
services:
api:
image: registry.example.com/team/api:tested-tag
init: true
stop_signal: SIGTERM
stop_grace_period: 30s
# Validate the merged project before a planned deployment.
# docker compose config --quiet
اختبار القبول والتراجع
في بيئة اختبار، ابدأ طلباً قصيراً ومهمة طويلة مضبوطة ثم أوقف الحاوية. يجب أن تظهر بداية shutdown ونهاية cleanup في السجلات. افحص الحالة النهائية للبيانات وتأكيدات الصف وإمكانية تشغيل الخدمة مجدداً؛ هدوء السجلات لا يثبت سلامة البيانات.
عند تراجع المنطق أو التوقيت، أعد الإعداد والصورة السابقين بإجراء النشر نفسه بدلاً من زيادة المهلة باستمرار. راقب مدة الإيقاف والعمل غير المكتمل وkill القسري. تجنّب تكرار التجارب على بيانات الإنتاج بلا نسخة احتياطية وخطة استعادة.
# Test environment only: this stops the named service.
docker stop --timeout 30 r89-api
docker inspect --format 'Status={{.State.Status}} Exit={{.State.ExitCode}} OOMKilled={{.State.OOMKilled}}' r89-api
قراءة ذات صلة
- Healthcheck في Docker: التشغيل لا يعني الصحة
- تشخيص DNS واتصال الخدمات في شبكة Docker
- منع امتلاء القرص عبر تدوير سجلات Docker
