أوامر حاويات Docker ودورة حياتها: من create إلى rm مع رموز الخروج

أوامر حاويات Docker ودورة حياتها: من create إلى rm مع رموز الخروج

أوامر حاويات Docker كثيرة في الظاهر: create وstart وstop وkill وpause وrestart وrm وغيرها، لكنها كلها تنقل الحاوية بين خمس حالات فقط، وفهم هذه الحالات يغنيك عن حفظ الأوامر. والأهم من الحالات ما لا يظهر في التوثيق المختصر: لماذا يأخذ docker stop أحياناً عشر ثوانٍ كاملة، وما معنى رمز الخروج 137 أو 143 أو 127، وكيف تتصرف سياسة إعادة التشغيل حين يفشل البرنامج مرة بعد أخرى. وفي هذا الدليل نشغل كل أمر على Docker 29.9 في المختبر، ونقرأ حالة الحاوية ورمز خروجها بعده، ونقيس زمن الإيقاف في أربع حالات مختلفة، ونسجل أحداث Docker كلها أثناء التجربة.

نمر بالحالات الخمس، والإنشاء والتشغيل والإيقاف المؤقت، ولغز العشر ثوانٍ في docker stop، ورموز الخروج، وسياسات إعادة التشغيل، ثم التنظيف والأحداث.

الحالات الخمس

الحالات الخمس للحاوية
الحالات الخمس للحاوية
created  --start-->  running  --pause-->  paused  --unpause-->  running
running  --stop / kill / process exits-->  exited  --start-->  running
any state  --rm (-f if running)-->  removed
restarting: between exits when a restart policy is set

الحاوية المنشأة لها نظام ملفات وإعدادات لكن لا عملية فيها، والحاوية العاملة لها عملية رقمها 1 داخلها، والمتوقفة مؤقتاً عمليتها مجمدة في الذاكرة، والمنتهية خرجت عمليتها وبقي نظام ملفاتها وسجلاتها حتى تحذفها. والحالة الخامسة restarting تظهر بين محاولات إعادة التشغيل. وكل شيء عن الحاوية تقرؤه بـ docker inspect، وفي هذا الدليل نطبع منه ثلاثة حقول بعد كل أمر: الحالة ورمز الخروج وعدد مرات إعادة التشغيل.

الإنشاء والتشغيل والإيقاف المؤقت

$ docker create --name c1 lab/busybox:1.0 sleep 300   status=created exit=0
$ docker start c1                                    status=running exit=0
$ docker pause c1                                    status=paused  exit=0
$ docker unpause c1                                  status=running exit=0
$ docker rm c1
Error response from daemon: cannot remove container "c1": container is running:
stop the container before removing or force remove                       rc=1

docker run في الحقيقة أمران: create ثم start. وفصلهما مفيد حين تريد تجهيز حاوية ثم تشغيلها لاحقاً. وpause لا يرسل أي إشارة للبرنامج، بل يجمد عملياته عبر مجموعات التحكم، فلا يعرف البرنامج أنه توقف، وهذا مفيد لأخذ نسخة متسقة من بيانات حاوية دون إيقافها. وحذف حاوية تعمل يرفضه Docker صراحة، ويقترح عليك الإيقاف أولاً أو rm -f.

لغز العشر ثوانٍ في docker stop

container                                  docker stop time   exit code
sleep 300 as PID 1                         10.166 s           137  (SIGKILL after timeout)
sleep 300 with --init (tini as PID 1)       0.130 s           143  (SIGTERM)
sh with trap "exit 0" TERM                  0.196 s             0  (clean exit, printed "got TERM")
sleep 300, docker stop -t 2                 2.135 s           137
زمن docker stop في أربع حالات
زمن docker stop في أربع حالات

docker stop يرسل SIGTERM للعملية رقم 1، وينتظر عشر ثوانٍ، ثم يرسل SIGKILL. والمشكلة أن النواة تعامل العملية رقم 1 معاملة خاصة: لا تطبق عليها السلوك الافتراضي للإشارات، فإن لم يكتب البرنامج معالجاً لـ SIGTERM فإنه يتجاهلها. ولهذا أخذ إيقاف sleep عشر ثوانٍ وخرج بالرمز 137. والحلول الثلاثة في الجدول: الخيار --init يضع برنامجاً صغيراً كعملية أولى يمرر الإشارات، فتوقفت الحاوية في 0.13 ثانية، أو يكتب برنامجك معالجاً للإشارة فيخرج نظيفاً بالرمز 0، أو تقصر المهلة بـ -t. وعلى سيرفر فيه حاويات كثيرة، عشر ثوانٍ لكل حاوية تعني دقائق عند كل نشر.

رموز الخروج

$ docker kill c5                                   exit=137   (128 + 9, SIGKILL)
$ docker run lab/busybox:1.0 sh -c "exit 3"         rc=3       (the program's own code)
$ docker run lab/busybox:1.0 nosuchcmd              rc=127     (command not found, container stays "Created")
docker stop with --init                             exit=143   (128 + 15, SIGTERM)
docker run --memory 32m ... (memory exceeded)       exit=137   OOMKilled=true
رموز الخروج ومعانيها
رموز الخروج ومعانيها

رمز الخروج أول ما تنظر إليه حين تنتهي حاوية فجأة. والرموز فوق 128 تعني أن إشارة قتلت البرنامج، ورقم الإشارة هو الفرق: 137 للإشارة 9، و143 للإشارة 15. لكن 137 وحده لا يكفي للتشخيص، فقد يكون docker kill أو انتهاء مهلة stop أو قاتل الذاكرة، والفاصل الحقل OOMKilled في docker inspect. والرمز 127 يعني أن الأمر نفسه غير موجود في الصورة، والرمز 125 من Docker نفسه قبل أن تبدأ الحاوية، كمنفذ مستخدم. وأي رمز آخر هو رمز برنامجك.

سياسات إعادة التشغيل

$ docker run -d --name c8 --restart on-failure:3 lab/busybox:1.0 sh -c "exit 1"
events: start die start die start die start die      (4 runs within ~2 s)
final:  status=exited exit=1 restarts=3

policy           restarts when
no               never (default)
on-failure[:N]   exit code != 0, at most N times
always           always; also after the daemon restarts, unless removed
unless-stopped   like always, but not after you ran docker stop

مع on-failure:3 شغل Docker البرنامج الفاشل أربع مرات، الأولى وثلاث إعادات، ثم تركه منتهياً برمز 1 وعداد إعادات 3. والمحاولات تتباعد بمهلة تتضاعف بين كل محاولة وأخرى، وكانت قصيرة هنا فجرت الأربع في ثانيتين تقريباً. والسياسة always على خدمة فيها خطأ دائم تجعلها تدور بلا نهاية وتملأ السجلات، فاستخدم on-failure بحد، أو unless-stopped للخدمات الطويلة. وإن كانت الخدمة تُدار أصلاً بـ systemd على المضيف، فلا تجمع بين مديرين لإعادة التشغيل، وطريقة systemd في إدارة الخدمات بـ systemctl.

التنظيف والأحداث

$ docker ps -a
c8  Exited (1)    c7 Created    c6 Exited (3)    c5 Exited (137)
c4  Exited (137)  c3 Exited (0)  c2 Exited (143)  c1 Exited (137)
$ docker container prune -f                 # removed all 8 stopped containers
$ docker events --filter type=container     # recorded during this lab: 52 events
start 10  die 10  destroy 8  create 8  kill 7  stop 4  attach 2  pause 1  unpause 1  prune 1
التنظيف وسجل الأحداث
التنظيف وسجل الأحداث

الحاويات المنتهية لا تختفي وحدها، وتبقى بطبقات كتابتها وسجلاتها، فبعد التجربة كانت ثماني حاويات بحالاتها ورموزها. والأمر docker container prune حذفها كلها، والخيار --rm عند التشغيل يحذف الحاوية تلقائياً حين تنتهي، وهو مناسب للمهام القصيرة. وأمر docker events يبث كل ما يحدث، وسجلنا به 52 حدثاً طوال التجربة، منها 10 تشغيلات و10 خروجات و7 إشارات قتل. وهو أداة تشخيص ممتازة حين تتساءل لماذا أعيد تشغيل حاوية في منتصف الليل. والفرق بين الحاوية والصورة وما تحت الحالات في أساسيات حاويات Docker.

أخطاء شائعة

برنامج لا يعالج SIGTERM كعملية أولى

عشر ثوانٍ ثم قتل بالرمز 137، والحل --init أو معالج للإشارة.

قراءة 137 على أنه نقص ذاكرة دائماً

انظر إلى OOMKilled قبل الحكم.

restart always على برنامج معطوب

يدور بلا نهاية، وon-failure بحد أوضح.

ترك الحاويات المنتهية تتراكم

استخدم --rm أو prune بانتظام.

أسئلة يطرحها الناس

ما الفرق بين stop وkill؟

stop يطلب الخروج ثم يقتل بعد مهلة، وkill يقتل فوراً بـ SIGKILL افتراضياً.

هل يحفظ restart الحاوية نفسها؟

نعم، يعيد تشغيل الحاوية نفسها بطبقة كتابتها، بخلاف حذفها وإنشاء أخرى.

الخلاصة

الحاوية تمر بخمس حالات. وإيقاف sleep كعملية أولى أخذ 10.17 ثانية وانتهى بالرمز 137، ومع --init أخذ 0.13 ثانية وبالرمز 143، ومع معالج للإشارة 0.2 ثانية وبالرمز 0. ورمز 127 للأمر الغائب و3 لرمز البرنامج، وon-failure:3 شغل البرنامج أربع مرات ثم توقف، وprune حذف ثماني حاويات، وسجلت الأحداث 52 حدثاً.