سؤال مصاحبه

تفاوت‌های بازنگری تمیز و یک هوک pre-commit جدید

A clean diff and a new pre-commit hook

  • سطح ۲: میانی
  • اشکال‌یابی
  • ۸ دقیقه

اجازه می‌دهید یک ایجنت شبانه روی یک مخزن داخل یک ساندباکس با مانت (mount) پیش‌فرض فضای کاری کار کند. صبح که برمی‌گردید، خروجی git diff کاملاً تمیز است؛ اما یک فایل جدید داخل .git/hooks/pre-commit جا خوش کرده است. توضیح دهید ایجنت چگونه فایلی نوشته که در هیچ تفاوت‌های بازنگری (diff) دیده نمی‌شود، کدام حالت فضای کاری جلوی این اتفاق را می‌گیرد و در آن حالت، commitهای ایجنت چطور به دست شما می‌رسند.

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

پاسخ کوتاه

در مانت پیش‌فرض، مسیر هاست با دسترسی خواندن و نوشتن (read-write) در همان مسیر مطلق داخل ماشین مجازی مانت می‌شود. بنابراین، ایجنت می‌تواند هر چیزی را در درخت فایل‌ها تغییر دهد؛ از جمله هوک‌های Git، پیکربندی CI، اسکریپت‌های package.json و تنظیمات خود ایجنت. از طرفی، فایل‌های زیرمسیر .git/hooks هرگز در git diff نشان داده نمی‌شوند. استفاده از پرچم --clone هنگام ساخت ساندباکس، ایجنت را روی یک کلون اختصاصی اجرا می‌کند، در حالی که مخزن هاست به‌صورت فقط‌خواندنی (read-only) در مسیر /run/sandbox/source وارد ماشین مجازی می‌شود؛ بنابراین، push کردن تغییرات به مخزن هاست پذیرفته نمی‌شود. این commitها از طریق یک دیمن گیت (git daemon) درون ماشین مجازی منتقل می‌شوند؛ ابزار sbx این دیمن را روی یک پورت loopback منتشر کرده و آن را به‌عنوان مخزن راه‌دور (remote) با نام sandbox-<name> در مخزن هاست ثبت می‌کند. به این ترتیب، کافی است پیش از حذف ساندباکس، تغییرات را از آن مخزن راه‌دور fetch کنید.

پاسخ کامل

سه حالت فضای کاری

حالت آن‌چه ایجنت می‌بیند آن‌چه می‌تواند روی هاست تغییر دهد
مانت مستقیم دایرکتوری هاست در همان مسیر، از طریق virtiofs، با دسترسی خواندن و نوشتن همه‌چیز در کل درخت پروژه، از جمله هوک‌ها
بدون مانت دایرکتوری کاریِ الگو، یعنی /home/agent/workspace هیچ‌چیز
با پرچم --clone یک کلون اختصاصی در همان مسیر روی ولوم ext4 خودش، با origin در /run/sandbox/source هیچ‌چیز؛ مانت منبع فقط‌خواندنی است

مسیرهای اضافی بعد از مسیر اول می‌آیند و پسوند :ro یک مسیر (حتی یک فایل تکی) را فقط‌خواندنی می‌کند. اجرای sbx run بدون مشخص کردن مسیر، دایرکتوری جاری را مانت می‌کند که تله‌ی پنهان در این سؤال نیز همین است.

خروجی ثبت‌شده از اجرای حالت clone چه چیزی را نشان داد؟

درون ساندباکس، اجرای دستور touch /run/sandbox/source/x با خطای Read-only file system شکست خورد و دستور git push به سمت origin با خطای remote unpack failed پایان یافت. دیمن گیت داخل ماشین مجازی روی پورت 9418 گوش می‌دهد و CLI دو refspec برای fetch در فایل .git/config هاست می‌نویسد؛ در نتیجه با یک بار fetch، هر دو مسیر refs/remotes/sandbox-<name>/<branch> و refs/sandboxes/<name>/<branch> به‌روزرسانی می‌شوند. دستور sbx rm مخزن راه‌دور و دیمن را حذف کرده و دستور بازیابی را نمایش می‌دهد؛ در این میان، نسخه‌ی ذخیره‌شده در refs/sandboxes از fetch قبلی، پس از حذف ساندباکس دست‌نخورده باقی می‌ماند. دستور sbx stop دیمن را متوقف می‌کند و با راه‌اندازی مجدد، پورت جدیدی تخصیص داده شده و آدرس URL مخزن راه‌دور بازنویسی می‌شود.

محدودیت‌های حالت clone

این حالت جلوی نوشتن را می‌گیرد، نه خواندن را. فایل‌های ردیابی‌نشده (untracked) مانند .env در مسیر مخزن، داخل کلون هم قابل خواندن هستند؛ بنابراین اطلاعات حساس و کلیدها (secrets) را از مخزنی که در ساندباکس کلون می‌کنید دور نگه دارید. این پرچم در نسخه‌ی v0.31.0 جایگزین --branch شد و هنگام اتصال مجدد (re-attach) نیز اثری ندارد؛ بنابراین این تصمیم باید در همان مرحله‌ی sbx create گرفته شود.

سؤال‌های تکمیلی مصاحبه‌گر
  • سطح 2: آیا می‌توان یک ساندباکس موجود را به حالت clone تغییر داد؟ پاسخ مورد انتظار: خیر؛ حالت ساندباکس هنگام ساخت تعیین می‌شود و این پرچم در اتصال مجدد بی‌اثر است، بنابراین باید آن را حذف و دوباره بسازید.
  • سطح 3: ایجنت داخل ساندباکس روی branch با نام main کامیت زده است. این commit بعد از fetch در کجای هاست قرار می‌گیرد؟ پاسخ مورد انتظار: در refs/remotes/sandbox-<name>/main و refs/sandboxes/<name>/main، نه روی branch اختصاصی main خودِ هاست.
  • سطح 3: یک بار fetch کرده‌اید و سپس ساندباکس را حذف کرده‌اید. چه چیزی قابل بازیابی است؟ پاسخ مورد انتظار: commitهای fetch‌شده؛ مسیر refs/sandboxes/<name>/<branch> باقی می‌ماند و دستور git branch <local> refs/sandboxes/<name>/<branch> آن را بازیابی می‌کند. commitهایی که بعد از آخرین fetch ثبت شده‌اند همراه با کلون از بین می‌روند، بنابراین همیشه قبل از اجرای sbx rm حتماً fetch کنید.
  • سطح 4: حالت clone کدام ریسک امنیتی را باز می‌گذارد و چطور باید آن را مهار کرد؟ پاسخ مورد انتظار: خواندن داده‌ها؛ فایل‌های ردیابی‌نشده مثل .env از طریق مانت فقط‌خواندنی همچنان دیده می‌شوند، بنابراین باید آن‌ها را بیرون از مخزن نگه دارید یا مسیر محدودتری را مانت کنید.
جواب‌های اشتباهی که مصاحبه‌گرها زیاد می‌شنوند
  • «دستور git status هوک اضافه‌شده را نشان می‌داد.» فایل‌های زیرمسیر .git/ بخشی از درخت کاری (working tree) نیستند؛ نه status و نه diff آن‌ها را فهرست نمی‌کنند.
  • «مخزن را با :ro مانت کنید و بگذارید ایجنت commit کند.» مانت فقط‌خواندنی جلوی commitهای خود ایجنت را هم می‌گیرد؛ حالت clone یک کلون با قابلیت نوشتن به آن می‌دهد و هم‌زمان هاست را دست‌نخورده و فقط‌خواندنی نگه می‌دارد.
  • «از --branch استفاده کنید تا ایجنت روی یک branch کار کند.» این پرچم حذف شده است و حالا با خطایی خاتمه می‌یابد که پیشنهاد می‌کند از --clone استفاده کنید.

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

بخش حالت clone که خطای push ردشده، دو refspec و refهای باقی‌مانده را توضیح داده است.