سناریوی رخداد

ساندباکس خودبه‌خود متوقف شد

The sandbox stopped itself

  • سطح ۱: غربالگری
  • سناریوی رخداد
  • ۱۵ دقیقه

وضعیت

توسعه‌دهنده‌ای یک ساندباکس (Sandbox) شل روی یک مخزن (Repository) باز می‌کند، فرایند طولانی نصب وابستگی‌ها را راه می‌اندازد و ترمینال را می‌بندد تا به جلسه‌اش برسد. یک ساعت بعد، خروجی دستور sbx ls وضعیت ساندباکس را stopped نشان می‌دهد. فرایند نصب کامل نشده و هیچ خطایی هم در جایی که توسعه‌دهنده بررسی کرده، چاپ نشده است. او نتیجه می‌گیرد که دیمن (Daemon) کرش کرده یا کسی ساندباکس را حذف کرده است، بنابراین می‌خواهد همه‌چیز را از صفر بسازد.

شما دو خروجی فهرست ساندباکس‌ها، خطوط لاگ دیمن مربوط به آن ساندباکس و خروجی یک توقف دستی و پاک‌سازی (Prune) از روزی دیگر را در اختیار دارید.

نسخه
sbx v0.47.0
مدل
none; shell commands inside the sandbox
سخت‌افزار
one Mac with the microVM runtime

شواهد

running-then-stopped.txt
title: sbx ls before and after the last session closed
source: manuals/docker-sandboxes-101/capture/out/04-auto-stop.txt
lines: 1-9
lang: console
note: The sandbox is still listed, with a new status.
---
$ sbx ls
SANDBOX     AGENT   STATUS    PORTS   WORKSPACE
m101-demo   shell   running           $CAPTURE/fixtures/repo
[exit 0]

$ sbx ls
SANDBOX     AGENT   STATUS    PORTS   WORKSPACE
m101-demo   shell   stopped           $CAPTURE/fixtures/repo
[exit 0]
stop-prune-and-the-empty-list.txt
title: an explicit stop, a prune, and the list after it
source: manuals/docker-sandboxes-101/capture/out/04-prune.txt
lang: console
note: The stop message says what is kept and how to come back; the prune removes both stopped sandboxes.
---
$ sbx stop m101-demo
Sandbox 'm101-demo' stopped; state preserved. Restart with: sbx run --name m101-demo
[exit 0]

$ sbx prune --force
Deleting sandbox m101-demo...
Sandbox 'm101-demo' removed
Deleting sandbox m101-demo-2...
Sandbox 'm101-demo-2' removed
[exit 0]

$ sbx ls --json
{
  "sandboxes": []
}
[exit 0]
the-daemon-log.txt
title: the two auto-stop lines of the daemon log for m101-demo
source: manuals/docker-sandboxes-101/capture/out/04-auto-stop.txt
lines: 11-13
lang: console
note: Read the level and the msg field of each line.
---
$ grep auto-stop daemon.log | grep m101-demo | tail -2
{"time":"<ts>","level":"INFO","msg":"auto-stop grace period expired, stopping runtime","version":"v0.47.0 0411f50ee4700fe7bd37e6e7e3aced563e850ca9","runtime":"m101-demo"}
{"time":"<ts>","level":"INFO","msg":"auto-stopped runtime after last session disconnected","version":"v0.47.0 0411f50ee4700fe7bd37e6e7e3aced563e850ca9","runtime":"m101-demo"}

سؤال‌ها

  1. ساندباکس کرش کرد، حذف شد، یا متوقف شد؟ کدام خروجی تکلیف را مشخص می‌کند؟
  2. دو خط لاگ دیمن چه اتفاقی را گزارش می‌کنند و سطح لاگ (Log level) آن‌ها چیست؟
  3. چه چیزهایی پس از توقف ساندباکس باقی می‌مانند و چه چیزهایی از بین می‌روند؟
  4. چطور باید دوباره وارد این ساندباکس شد، و اگر prune اجرا می‌شد چه اتفاقی می‌افتاد؟
  5. چطور می‌توان کاری کرد که بعد از قطع اتصال، فرایند همچنان در حال اجرا بماند؟

اول شواهد را بخوانید و به سؤال‌ها جواب بدهید، بعد راه‌حل را باز کنید.

راه‌حل گام‌به‌گام
  1. وضعیت را بخوانید. در فهرست اول وضعیت running و در فهرست دوم stopped است. ساندباکسی که حذف شده باشد اصلاً در لیست نمی‌آید. دیمنی هم که کرش کرده باشد نمی‌تواند به دستور sbx ls پاسخ بدهد. ساندباکس متوقف شده است.
  2. لاگ دیمن را بخوانید. هر دو خط با سطح INFO ثبت شده‌اند، نه خطا. خط اول می‌گوید مهلت توقف خودکار (Grace period) تمام شده و محیط اجرا (Runtime) در حال متوقف شدن است. خط دوم می‌گوید محیط اجرا پس از قطع اتصالِ آخرین نشست (Session)، به‌طور خودکار متوقف شد. بستن ترمینال نقش محرک را داشت؛ چون همان آخرین نشست بود. شماره‌ی نسخه‌ی دیمن در هر خط آمده است؛ بنابراین دقیقاً می‌دانید کدام نسخه این کار را انجام داده است.
  3. بدانید توقف ساندباکس چه چیزهایی را حفظ می‌کند. توقف دستی عبارت state preserved و دستور راه‌اندازی مجدد را چاپ می‌کند. در مستندات آمده است که چه چیزهایی پس از توقف و راه‌اندازی مجدد باقی می‌مانند: بسته‌های نصب‌شده، ایمیج‌های Docker، تغییرات پیکربندی، تاریخچه‌ی دستورات و فایل‌های فضای کاری که روی مانت (Mount) نیستند. فرایند (Process) در حال اجرا در این فهرست نیست؛ در نتیجه فرایند نصب همراه با میکرو‌وی‌ام (MicroVM) از بین رفته است.
  4. مسیر درست را برای بازگشت انتخاب کنید. اجرای دستور sbx run --name m101-demo اتصال مجدد به نشست (Reattach) را برقرار و ساندباکس متوقف‌شده را راه‌اندازی می‌کند. دستور sbx prune آن را پاک می‌کرد؛ در لاگ ضبط‌شده دیدیم که هر دو ساندباکسِ متوقف را حذف کرد و لیست خالی تحویل داد. علاوه بر این، دستورهای rm و prune کلیدهای امنیتی (Secrets) در دامنه‌ی (Scope) آن ساندباکس را هم حذف می‌کنند.
  5. فرایند را آگاهانه در حال اجرا نگه دارید. اگر sbx run -d را روی یک ساندباکس موجود اجرا کنید، حتی پس از قطع نشست‌ها به کارش ادامه می‌دهد، تا زمانی که خودتان آن را متوقف یا حذف کنید. یک کیت (Kit) هم می‌تواند برای رسیدن به همین نتیجه قابلیت long-running@1 را تعریف کند. در جدول مستندات، رفتار توقف خودکار صرفاً به‌عنوان یک رفتار مشاهده‌شده ثبت شده و توضیح رسمی برای آن وجود ندارد؛ بنابراین منتظر اخطار در هیچ صفحه‌ای از مستندات نباشید.
نتیجه

دیمن پس از بسته‌شدن آخرین نشست و سپری شدن زمان مهلت، ساندباکس را از قصد متوقف کرد و این موضوع را با سطح INFO در لاگ خود نوشت. نه چیزی کرش کرده و نه چیزی حذف شده است. توسعه‌دهنده با دستور sbx run --name اتصال مجدد به نشست را برقرار می‌کند، می‌بیند بسته‌هایی که نصبشان تمام شده بود هنوز سر جایشان هستند و فرایند نصب را دوباره راه می‌اندازد. برای تسک‌های طولانی بعدی، او ساندباکس را در حالت جدا از نشست (Detach) اجرا می‌کند تا هیچ نشستی «آخرین نشست» به حساب نیاید. دستور prune هم تا زمانی که واقعاً نخواهیم ساندباکسی برای همیشه پاک شود، جایی در ران‌بوک (Runbook) نخواهد داشت.

مسیرهای اشتباه رایج
  • «دستور sbx prune را برای تمیزکاری اجرا کنید و بعد ساندباکس را دوباره بسازید.» دستور Prune تمام ساندباکس‌های متوقف‌شده را به همراه وضعیت و کلیدهای امنیتی‌شان پاک می‌کند؛ در حالی که شما دقیقاً به یکی از همین ساندباکس‌های متوقف نیاز دارید.
  • «دیمن کرش کرده است.» دیمن دو خط لاگ با سطح INFO نوشته و به دستور فهرست‌گیری پاسخ داده است. اگر کرش می‌کرد، خروجی دوم اصلاً وجود نداشت.
  • «یک ساندباکس جدید با همان نام بسازید.» این نام متعلق به همان ساندباکس متوقف‌شده است و ساخت ساندباکس جدید، وضعیت بسته‌های نصب‌شده را از بین می‌برد. به‌جای این کار، اتصال مجدد به نشست را انجام دهید.
درس کلی

وقتی چیزی که اجرا کرده‌اید ناپدید می‌شود، قبل از بازسازی همه‌چیز از اول، بپرسید: آیا متوقف شده، با خطا مواجه شده یا حذف شده است؟ بعد لاگ مؤلفه‌ای را بخوانید که چرخه‌ی حیات آن بخش را مدیریت می‌کند. پلتفرمی که کارهای بیکار را خودبه‌خود متوقف می‌کند، دفعه‌ی بعد هم همین کار را خواهد کرد. فلگ یا قابلیتی را پیدا کنید که کارها را طولانی‌مدت (Long-running) علامت‌گذاری می‌کند و آگاهانه از آن بهره بگیرید.

کجای دوره آموزش داده می‌شود

صفحه‌ی چرخه حیات رفتار توقف خودکار و مواردی را که پس از توقف حفظ می‌شوند ثبت کرده است؛ و دفتر ثبت ادعاها برای این رفتار حکم ارزیابی (Verdict) «مشاهده‌شده» را ثبت کرده، بدون آن‌که صفحه‌ای از سمت سازنده برای توضیح آن وجود داشته باشد.