سؤال مصاحبه

سه خطا در یک بار اجرای ایجنت در ساندباکس

Three failures in one sandboxed agent run

  • سطح ۳: ارشد
  • اشکال‌یابی
  • ۱۰ دقیقه

دستور docker-agent run --sandbox agent.yaml خلاصه‌ای از مشخصات راه‌اندازی را چاپ می‌کند، ماشین مجازی (VM) را می‌سازد و سپس با این خطا متوقف می‌شود: Error: creating session store: migration failed even after database reset: failed to create migrations table: attempt to write a readonly database (1032). تلاش قبلی به دلیل اشاره‌ی --data-dir به پوشه‌ی خانگی (home directory) رد شده بود، و اولین فراخوانی مدل در همان روز هم خطای 403 Blocked by network policy برگرداند. علت هر سه مورد را توضیح دهید و بگویید خلاصه‌ی راه‌اندازی باید پیش از اجرا چه نکاتی را به شما نشان می‌داد.

اول خودتان جواب بدهید، بعد پاسخ را باز کنید.

پاسخ کوتاه

سه دلیل وجود دارد که هیچ‌کدام به فایل ایجنت مربوط نمی‌شوند. با پرچم --sandbox، مسیر پوشه‌ی داده خارج از محیط کاری (workspace) رد می‌شود؛ چون از داخل ماشین مجازی فقط محیط کاری قابل نوشتن است. خطای 403 یعنی میزبانِ مدل در فهرست مجاز (allowlist) دائمی نبوده است: اجرای دستور docker-agent sandbox allow localhost:12434 مشکل را حل می‌کند، و پورت مربوط به localhost است چون پروکسی پیش از بررسی قانون، host.docker.internal را به localhost بازنویسی می‌کند. خطای پایگاه داده‌ی فقط‌خواندنی نیز به این دلیل رخ می‌دهد که SQLite نمی‌تواند روی نقطه‌ی اتصال (mount) محیط کاری از نوع virtiofs در این سیستم میزبان بنویسد، هرچند دستور mount آن را rw فهرست می‌کند؛ تلاش ساده‌ی پایتون با sqlite3 برای نوشتن روی همین مانت هم دقیقاً به همین شکل شکست می‌خورد. ماشین مجازی پس از بروز خطا همچنان روشن می‌ماند، بنابراین باید خودتان آن را حذف کنید.

پاسخ کامل

ابتدا خلاصه‌ی راه‌اندازی را بخوانید

خلاصه‌ی راه‌اندازی تمام مواردی را که این اجرا به آن‌ها اعتماد می‌کند مشخص می‌کند: Models gateway: none configured، میزبان کاتالوگ که برای پروکسی در فهرست مجاز قرار گرفته، فهرست مجاز کاربر با میزبان‌هایی که خودتان اضافه کرده‌اید، سپس نام ساندباکس، مانت‌ها همراه با حالت دسترسی‌شان، ایمیج، و منابع سخت‌افزاری. در اجرای ثبت‌شده، محیط کاری دارای دسترسی rw بود، و پوشه‌ی فایل ایجنت، کیت آماده‌شده در .m101/cache/sandbox-kits/<hash> و پوشه‌ی پیکربندی همگی ro بودند. ایمیج مورد استفاده docker/docker-agent-sbx-templates:latest با cpu 10 و memory 32 GiB بود. تمام خطاهای بعدی با یکی از همین سطرها توضیح داده می‌شوند.

پوشه‌ی داده

کیت ثبت اطلاعات با کمک پرچم‌های --data-dir، --cache-dir و --config-dir محیط اجرا (runtime) را از مسیر ~/.cagent دور نگه می‌دارد. در صورت استفاده از --sandbox، پیام امتناع صادر می‌شود: --data-dir must be inside the sandbox's writable workspace. به همین دلیل هر سه مسیر زیر پوشه‌ی .m101/ در محیط کاری قرار گرفتند. این کار پایگاه داده‌ی نشست (session) را روی مانت قرار داد، که دقیقاً ریشه‌ی خطای سوم است.

میزبان مدل و پروکسی

درون ماشین مجازی، آدرس 127.0.0.1 به خود ماشین مجازی اشاره دارد؛ بنابراین ارائه‌دهنده‌ی درون فایل ایجنت به host.docker.internal:12434 اشاره می‌کند. این درخواست از طریق HTTP_PROXY در آدرس gateway.docker.internal:3128 خارج می‌شود، زیرا این میزبان در NO_PROXY قرار ندارد، و پروکسی ساندباکس این نام را به localhost ترجمه می‌کند. در نتیجه، قانون حتماً باید شامل localhost:12434 باشد. فهرست مجاز داخل ماشین مجازی خالی است، زیرا میزبان‌های مجاز به‌صورت قوانین پروکسی روی سیستم میزبان اعمال می‌شوند، نه به‌شکل یک فهرست درون ماشین مجازی. کلیدهای ارائه‌دهنده در داخل ماشین مجازی عبارت proxy-managed را نشان می‌دهند.

پایگاه داده‌ی فقط‌خواندنی

پوشه‌ی داده روی مانت محیط کاری قرار دارد که با حالت rw فهرست شده است. SQLite نتوانست جدول مایگریشن‌های خود را آنجا ایجاد کند، و یک آزمون ارزیابی (probe) با sqlite3 در پایتون روی همان مانت نیز دقیقاً با همین خطا روبه‌رو شد؛ بنابراین مشکل از مسیر نوشتن از طریق virtiofs روی این سیستم میزبان است، نه خود ایجنت. این ثبت عملیاتی صحت ادامه‌ی مسیر را ثابت کرد: اجرای دستی همان فایل ایجنت درون ماشین مجازی با ذخیره‌ی وضعیت در مسیر /tmp/m101 بدون مشکل انجام شد؛ فراخوانی مدل از طریق پروکسی خارج شد و پاسخ درست برگشت. محیط اجرا هنگام بروز خطا خارج می‌شود اما ماشین مجازی را متوقف یا حذف نمی‌کند؛ دستور sbx ls وضعیت آن را همچنان running نشان می‌دهد و دستور sbx rm --force به کار آن پایان می‌دهد. اجرای بعدی از همان محیط کاری، ماشین مجازی را دوباره به کار می‌گیرد مگر اینکه مجموعه‌ی مانت‌ها تغییر کرده باشد.

سؤال‌های تکمیلی مصاحبه‌گر
  • سطح 3: چرا استفاده از 127.0.0.1:12434 در فایل ایجنت درون ماشین مجازی خطا می‌دهد اما روی سیستم میزبان کار می‌کند؟ پاسخ مورد انتظار: لوپ‌بک داخل ماشین مجازی به خود ماشین اشاره دارد؛ باید از host.docker.internal استفاده کنید و localhost:12434 را در فهرست مجاز قرار دهید، چون پروکسی نام را بازنویسی می‌کند.
  • سطح 3: شما میزبانی را مجاز کرده‌اید اما ایجنت درون ماشین مجازی یک فهرست مجاز خالی را چاپ می‌کند. آیا قانون اعمال نشده است؟ پاسخ مورد انتظار: خیر؛ قانون در پروکسی سیستم میزبان قرار دارد و اعمال محدودیت‌ها در فهرست درون ماشین مجازی انجام نمی‌شود.
  • سطح 4: چگونه ثابت می‌کنید که خطای SQLite ناشی از مانت است؟ پاسخ مورد انتظار: تلاش برای نوشتن با sqlite3 پایتون روی همان مانت دقیقاً به همین شکل شکست می‌خورد، mount همچنان وضعیت را rw نشان می‌دهد، و همان ایجنت با ذخیره‌ی وضعیت در /tmp درون ماشین مجازی اجرا می‌شود.
  • سطح 4: اجرای ناموفق چه چیزی از خود به جا می‌گذارد و چه چیزی آن را پاک‌سازی می‌کند؟ پاسخ مورد انتظار: یک ماشین مجازی در حال اجرا که محیط اجرا نه آن را متوقف می‌کند و نه حذف؛ باید با sbx rm ساندباکس را پاک کنید، یا بگذارید اجرای بعدی مجدداً از آن استفاده کند.
جواب‌های اشتباهی که مصاحبه‌گرها زیاد می‌شنوند
  • «محیط کاری فقط‌خواندنی است، پس سطح دسترسی آن را تغییر دهید.» مانت روی حالت rw قرار دارد؛ مشکل مربوط به مسیر نوشتن SQLite روی مانت است که یک آزمون مستقیم نیز آن را بازتولید می‌کند.
  • «همان‌طور که راهنما پیشنهاد می‌کند، --data-dir را روی پوشه‌ی خانگی تنظیم کنید.» با پرچم --sandbox این کار رد می‌شود؛ تنها محیط کاری قابل نوشتن است.
  • «آدرس host.docker.internal:12434 را در فهرست مجاز قرار دهید.» پروکسی پیش از بررسی قانون، نام را به localhost ترجمه می‌کند، بنابراین قانون باید نام localhost را مشخص کند.

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

بخش اجرای سرتاسری هر سه خطا و خلاصه‌ی راه‌اندازی را ثبت کرده است، و بخش اول به معرفی دو مسیر راه‌اندازی می‌پردازد.