الإيقاف السلس
معالجة إشارات نظام التشغيل واستنزاف الاتصالات
الإيقاف السلس درس مجاني في Go Academy على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Go Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Go Academy 4 دروس في المجموع.
لماذا الإيقاف التدريجي؟
يؤدي استدعاء os.Exit أو إيقاف الخادم ببساطة إلى إسقاط جميع الطلبات قيد التنفيذ. ينتظر الإيقاف التدريجي اكتمال الطلبات النشطة قبل الخروج.
http.Server.Shutdown
يوقف srv.Shutdown(ctx) قبول الاتصالات الجديدة، وينتظر انتهاء الطلبات النشطة، ثم يعود. مرّر سياقًا له مهلة نهائية للحد من مدة الانتظار.
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
srv.Shutdown(ctx)معالجة الإشارات
استمع إلى SIGINT/SIGTERM داخل goroutine واستدعِ Shutdown عند استلام الإشارة:
quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit
log.Println("shutting down...")
srv.Shutdown(ctx)النمط الكامل للإيقاف التدريجي
ابدأ تشغيل الخادم داخل goroutine؛ وانتظر على قناة الإشارة؛ ثم أوقف الخادم:
go func() {
if err := srv.ListenAndServe(); err != http.ErrServerClosed {
log.Fatal(err)
}
}()
quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit
srv.Shutdown(ctx)http.ErrServerClosed
بعد استدعاء Shutdown، تُرجع ListenAndServe القيمة http.ErrServerClosed. تعامل معها على أنها خروج طبيعي، لا خطأ.
تصريف الاتصالات
ينتظر Shutdown جميع الاتصالات التي استولت عليها المعالجات واتصالات WebSocket النشطة فقط إذا كان المعالج نفسه يحترم إلغاء السياق. يجب على معالجات الاستطلاع الطويل أو البث التحقق من r.Context().Done().
مهلة الإيقاف
اضبط مهلة إيقاف معقولة (من 10 إلى 30 ثانية). إذا ظلت الطلبات قيد التنفيذ بعد انقضاء المهلة النهائية، يُرجع Shutdown القيمة context.DeadlineExceeded وتُغلق الاتصالات المتبقية قسرًا.
التنظيف عند الإيقاف
بعد عودة Shutdown، أغلق تجمعات قواعد البيانات، وافرغ مخازن السجلات، وحرّر الموارد الأخرى بالترتيب. استخدم defer أو تسلسلًا صريحًا.
srv.Shutdown(ctx)
db.Close()
logger.Sync()Server.Close مقابل Server.Shutdown
يغلق srv.Close() جميع الاتصالات فورًا من دون انتظار. استخدمه فقط عندما يكون الإيقاف القسري مقبولًا، مثلًا في الاختبارات.
فحص جاهزية Kubernetes
أثناء الإيقاف، حدّث فحص الجاهزية ليُرجع 503 قبل استدعاء Shutdown. يشير ذلك إلى موازن التحميل لإيقاف توجيه الطلبات الجديدة إلى pod.
خوادم متعددة
إذا كنت تشغّل خوادم متعددة (HTTP وgRPC والمقاييس)، فأوقف كل خادم بالتزامن باستخدام goroutines، واستخدم WaitGroup للانتظار حتى تُصرّف جميع الطلبات.
تحقق سريع
ماذا يفعل http.Server.Shutdown؟
مراجعة: الإيقاف التدريجي
النقاط الرئيسية:
- يوقف srv.Shutdown(ctx) الاتصالات الجديدة وينتظر الاتصالات النشطة
- استمع إلى SIGINT/SIGTERM باستخدام signal.Notify
- تُرجع ListenAndServe القيمة http.ErrServerClosed عند الإيقاف — وهذا ليس خطأ
- اضبط مهلة نهائية للإيقاف لتجنب الانتظار إلى ما لا نهاية
تعلم Go مع معلم ذكاء اصطناعي — مجانًا
اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.
- الدورات
- 51
- الدروس
- 203
الأسئلة الشائعة
هل درس «الإيقاف السلس» مجاني؟
نعم — نص درس «الإيقاف السلس» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Go Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Go Academy 4 دروس في المجموع.
ماذا ستتعلم في «الإيقاف السلس»؟
معالجة إشارات نظام التشغيل واستنزاف الاتصالات تتمرن على Go Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Go Academy؟
لا تُشترط خبرة سابقة. Go Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.
كم من الوقت يستغرق درس «الإيقاف السلس»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Go Academy هذا؟
نعم. كل درس في Go Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.