Skipbox

سقف حجم کش GitHub Actions: چرا کش شما حذف می‌شود، دیر بازمی‌گردد یا پیدا نمی‌شود

GitHub Actions به هر مخزن ۱۰ GB کش می‌دهد. وقتی مخزن از آن بگذرد، GitHub باز هم ورودی تازه را ذخیره می‌کند و ورودی‌هایی را که از همه دیرتر خوانده شده‌اند حذف می‌کند تا دوباره زیر سقف برود، و هر ورودی‌ای را که هیچ جابی ۷ روز نخوانده حذف می‌کند. یک شاخه فقط کش‌های خودش و شاخه پیش‌فرض را می‌خواند، پس اولین اجرای یک شاخه تازه اغلب کش پیدا نمی‌کند. و پیدا شدن کش هم باز یک دانلود است: هر جاب روی رانر میزبانی‌شده GitHub روی یک ماشین مجازی تازه شروع می‌شود، پس آرشیو را دوباره دانلود و باز می‌کند. می‌توانید سقف را بالا ببرید، با ماهانه $0.07 برای هر GB بیش از ۱۰ GB، و کلیدهایتان را تنظیم کنید، ولی دانلود می‌ماند.

Skipbox دانلود را حذف می‌کند. جاب‌های شما روی ماشین اختصاصی حسابتان اجرا می‌شوند که بین جاب‌ها می‌ماند، پس کش‌های npm‏، pnpm‏، Gradle‏، Go و Cargo و لایه‌های Docker از جاب قبلی هنوز روی دیسکش هستند (۸۰ GB روی S، در برابر 14 GB روی رانر GitHub). آنچه actions/cache ذخیره می‌کند کنار ماشین می‌ماند، پس بازگرداندن یک خواندن محلی است. یک خط را به runs-on: skipbox تغییر دهید، با قیمت ثابت ماهانه $۳۹ و دقیقه‌های نامحدود.

قاعده‌های کش GitHub

از مرجع dependency caching، صورت‌حساب Actions و changelog آن درباره کش‌های بیش از ۱۰ GB در GitHub:

چرا کش حذف می‌شود

یک ۱۰ GB همه چیزهایی را که مخزن ذخیره می‌کند نگه می‌دارد. هر شاخه و هر pull request ورودی‌های خودش را ذخیره می‌کند. یک matrix از سه نسخه Node روی دو سیستم‌عامل شش ورودی ذخیره می‌کند. build cache از نوع type=gha در Docker هم در همان ۱۰ GB می‌نشیند. وقتی ذخیره‌های یک روز از سقف بیشتر شود، هر ذخیره تازه یک ورودی قدیمی‌تر را حذف می‌کند، اغلب همانی که جاب بعدی لازم دارد. GitHub این را cache thrashing می‌نامد.

برای دیدن اینکه چه چیزی آن را پر می‌کند، ورودی‌ها را بر اساس اندازه فهرست کنید:

gh cache list --sort size_in_bytes --limit 20

صفحه Actions › Caches مخزن همین را نشان می‌دهد، با شاخه و آخرین استفاده هر ورودی.

چرا بازگرداندن کند است

پیدا شدن کش روی رانر میزبانی‌شده GitHub یعنی دانلود روی یک ماشین مجازی تازه، بعد باز کردن آرشیو. زمانش با آرشیو بزرگ می‌شود، پس کشی که به چند GB رسیده می‌تواند به اندازه همان نصبی طول بکشد که قرار بود از آن بگذرد. دانلودی که گیر کند با timeout قطعه‌ها در actions/cache قطع می‌شود، به‌طور پیش‌فرض 10 دقیقه (SEGMENT_DOWNLOAD_TIMEOUT_MINS).

بیشتر چیدمان‌ها هم کمتر از آنچه فکر می‌کنید بازمی‌گردانند. ورودی cache: در setup-node کش دانلود package manager را ذخیره می‌کند، نه node_modules را: بعد از بازگرداندن، npm ci باز هم همه پکیج‌ها را نصب می‌کند. کش pip در setup-python هم همین‌طور است: دانلودها برمی‌گردند، محیط دوباره نصب می‌شود.

چرا کش پیدا نمی‌شود

  • کلید تغییر کرده. کلیدی با hashFiles('**/package-lock.json') با هر تغییر فایل lock پیدا نمی‌شود. restore-keys یک تطابق جزئی می‌دهد، و آن وقت cache-hit مقدار false دارد.
  • یک شاخه تازه. می‌تواند کش‌های شاخه پیش‌فرض را بخواند، نه کش‌های یک شاخه feature دیگر را. اگر شاخه پیش‌فرض هیچ‌وقت ورک‌فلو را اجرا نکرده باشد، چیزی برای خواندن نیست.
  • حذف شده. سقف یا ۷ روز آن را برده.
  • هیچ‌وقت ذخیره نشده. ورودی‌ها تغییرپذیر نیستند، پس کلیدی که وجود دارد دیگر هیچ‌وقت ذخیره نمی‌شود و محتوای کش‌شده به قدمت اولین ذخیره‌اش می‌ماند. pull requestی از یک fork ممکن است اصلاً اجازه ذخیره نداشته باشد.

رد کردن فایل‌ها به جاب بعدی همان اجرا ابزار دیگری است. کش برای اجرای بعدی است؛ خروجی بیلدی که یک جاب بعدی در همان ورک‌فلو لازم دارد از actions/upload-artifact و actions/download-artifact می‌گذرد. artifactها فضای ذخیره‌سازی خودشان را دارند، جدا از ۱۰ GB، و آن‌ها هم دانلودی روی یک ماشین مجازی تازه هستند.

هر راه حل روی رانرهای GitHub چه هزینه‌ای دارد

  • سقف را بالا ببرید. حذف کمتر، با ماهانه $0.07 برای هر GB بیش از ۱۰ GB (مثال خود GitHub: 200 GB که کامل استفاده شود ماهانه $13.30 است)، روی حساب Pro‏، Team یا Enterprise. بازگرداندن‌ها همچنان دانلود می‌مانند، و کش‌های بزرگ‌تر دیرتر دانلود می‌شوند.
  • کمتر ذخیره کنید. ~/.npm یا store در pnpm را کش کنید، نه node_modules یا خروجی بیلد را. فقط روی شاخه پیش‌فرض ذخیره کنید، با actions/cache/restore در همه جاب‌ها و actions/cache/save در یکی. هزینه‌اش وقت شماست، و کش کوچک‌تر کمتر برمی‌گرداند.
  • کلیدها را درست کنید. کلید را روی فایل lock بگذارید، restore-keys اضافه کنید و ورک‌فلو را روی pushهای شاخه پیش‌فرض اجرا کنید تا شاخه‌های تازه چیزی برای خواندن داشته باشند.
  • یک رانر خودمیزبان که دیسکش را نگه می‌دارد. نه دانلودی، نه ۱۰ GB. ماشین را خودتان اداره می‌کنید: به‌روزرسانی سیستم‌عامل، پاک‌سازی بین جاب‌ها بدون حذف کش‌ها، و تعمیرش وقتی خراب می‌شود.

وقتی راه حل ماشینی است که دیسکش را نگه می‌دارد

کش به این دلیل وجود دارد که ماشین فراموش می‌کند. رانر میزبانی‌شده GitHub برای هر جاب یک ماشین مجازی تازه است، پس جاب وضعیتش را در فضای ذخیره‌سازی GitHub ذخیره می‌کند و دفعه بعد آن را برمی‌گرداند. روی ماشینی که می‌ماند، این وضعیت از قبل روی دیسکش است: کش package manager، کش ابزارها، ایمیج‌ها و build cache‏ Docker، حتی خروجی بیلد.

این تفاوت در CI پروژه‌های واقعی دیده می‌شود، از اجراهای ما روی جاب‌های خودشان:

  • astro (Node.js، Turborepo): روی GitHub‏ 528 ثانیه، روی ماشین اختصاصی Skipbox‏ 30 ثانیه، که کش turbo را نگه می‌دارد، پس اجراهای گرمش 40 task بیلد را به‌جای اجرا بازپخش می‌کنند.
  • helix (Rust): گام toolchain و کش روی ماشین اختصاصی 9 تا 10 ثانیه طول کشید، در برابر 41 تا 46 ثانیه روی GitHub.
  • tauri (Rust): روی GitHub‏ 246 ثانیه، روی ماشین اختصاصی 53 ثانیه، با target/ که بین جاب‌ها نگه داشته می‌شود.

Skipbox کش را روی ماشین شما نگه می‌دارد

هر طرح با ماشین اختصاصی حساب شما می‌آید که بین جاب‌ها می‌ماند:

  • کش پکیج‌ها روی دیسک می‌مانند: ~/.npm، store در pnpm، ~/.cache هر ابزار و کش‌های Go‏، Gradle‏، Cargo و Maven، همراه ابزارهایی که setup-* نصب کرده. چیزی برای بازگرداندن نیست.
  • ایمیج‌ها، لایه‌ها و build cache‏ Docker هم می‌مانند. docker build از لایه‌های بیلد قبلی استفاده می‌کند (کش لایه‌های Docker).
  • **actions/cache‏، setup-* و rust-cache تغییری لازم ندارند.** آنچه ذخیره می‌کنند به‌جای فضای ذخیره‌سازی GitHub کنار ماشین می‌ماند، با جای بیشتر از ۱۰ GB هر مخزن در GitHub، و بازگرداندن آن را محلی می‌خواند.
  • انقضای ۷ روزه روی دیسک نیست. تا وقتی دیسک بعد از یک جاب تقریباً پر نشود هیچ چیز حذف نمی‌شود؛ آن وقت آنچه از همه قدیمی‌تر استفاده شده اول می‌رود.

روی S دست‌کم ۷ برابر فضای کش GitHub. هر جاب اندازه‌اش را با لیبل انتخاب می‌کند:

ubuntu-latest یک مخزن خصوصی 2 CPU‏، 8 GB و 14 GB حافظه SSD دارد. دقیقه‌ها روی Skipbox نامحدودند. با 20,000 دقیقه در ماه روی 4 vCPU‏، GitHub‏ $۲۲۲ می‌گیرد؛ Skipbox S‏ $۳۹ است، یعنی $۱۸۳ کمتر.

انتقال یک خط است

jobs:
  test:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci && npm test
  1. با GitHub وارد Skipbox شوید.
  2. اپ Skipbox در GitHub را نصب کنید و مخزن‌ها را انتخاب کنید.
  3. runs-on را تغییر دهید و push کنید.

گام‌های کش را همان‌طور که هستند نگه دارید. اجرای دوم کش‌های اجرای اول را روی ماشین پیدا می‌کند.

امنیت

  • ماشین فقط مال حساب شماست. جاب هیچ شرکت دیگری روی آن اجرا نمی‌شود.
  • بعد از هر جاب، اعتبارنامه‌های رانر، پروسه‌ها و کانتینرها پاک می‌شوند. گزینه «ماشین تازه برای هر جاب» به‌جای آن به هر جاب یک ماشین تازه می‌دهد.
  • کد افرادی که دسترسی نوشتن ندارند (مثل pull requestها از forkها) روی یک ماشین مجازی تازه اجرا می‌شود که کش‌های شما را می‌خواند ولی نمی‌تواند تغییرشان دهد.

جزئیات در جداسازی جاب‌ها است.

روی جابی که کشش پیدا نمی‌شود امتحانش کنید

دوره آزمایشی به مدت ۷ روز یا ۳٬۰۰۰ دقیقه جاب رایگان است، هر کدام زودتر برسد، و کارت نمی‌خواهد. آن جاب را به runs-on: skipbox ببرید، دو بار اجرایش کنید و گام‌های بازگرداندن و نصب اجرای دوم را کنار GitHub بگذارید.

پرسش‌های متداول

سقف حجم کش GitHub Actions چقدر است؟

به‌طور پیش‌فرض ۱۰ GB برای هر مخزن، برای همه شاخه‌ها و ورک‌فلوها روی هم. بعد از آن، GitHub باز هم ورودی تازه را ذخیره می‌کند و ورودی‌ها را به ترتیب آخرین دسترسی، از قدیمی‌ترین، حذف می‌کند تا مخزن دوباره زیر سقف برود. ورودی‌هایی که هیچ جابی ۷ روز نخوانده، هر اندازه‌ای داشته باشند حذف می‌شوند. روی حساب Pro‏، Team یا Enterprise‏، مدیران می‌توانند سقف و روزها را بالا ببرند؛ فضای بیش از ۱۰ GB ماهانه $0.07 برای هر GB حساب می‌شود، بر اساس بیشینه هر ساعت، و وقتی به یک بودجه برسد کش تا چرخه صورت‌حساب بعدی فقط‌خواندنی می‌شود.

چرا کش GitHub Actions من این‌قدر زیاد حذف می‌شود؟

چون همه چیز در مخزن یک ۱۰ GB را شریک است: هر شاخه، هر pull request، هر جاب matrix و هر سیستم‌عامل ورودی‌های خودش را ذخیره می‌کند، و کش type=gha در Docker هم همان‌جا می‌نشیند. وقتی ذخیره‌های یک روز از سقف بیشتر شود، هر ذخیره یک ورودی قدیمی‌تر را حذف می‌کند و جاب بعدی همانی را که لازم داشت پیدا نمی‌کند. GitHub این را cache thrashing می‌نامد. ورودی‌ها را بر اساس اندازه فهرست کنید (gh cache list --sort size_in_bytes) تا ببینید چه چیزی آن را پر می‌کند.

چرا بازگرداندن کش به اندازه نصب از صفر طول می‌کشد؟

چون پیدا شدن کش هم باز یک دانلود است. هر جاب روی رانر میزبانی‌شده GitHub روی یک ماشین مجازی تازه شروع می‌شود، پس actions/cache هر بار آرشیو را دانلود و باز می‌کند، و هر چه کش بزرگ‌تر باشد بیشتر طول می‌کشد. کش setup-node کش دانلود package manager را برمی‌گرداند، نه node_modules را، پس npm ci بعد از بازگرداندن باز هم همه پکیج‌ها را نصب می‌کند. روی رانری که دیسکش را نگه می‌دارد کش‌ها از قبل آنجا هستند و چیزی دانلود نمی‌شود.

چرا actions/cache روی یک شاخه تازه پیدا نمی‌شود؟

یک اجرا می‌تواند کش‌ها را از شاخه خودش و از شاخه پیش‌فرض بازگرداند، و اجرای یک pull request از شاخه پایه‌اش هم. نمی‌تواند کش‌های یک شاخه هم‌سطح را بخواند. پس اولین اجرای یک شاخه feature فقط وقتی کش پیدا می‌کند که شاخه پیش‌فرض آن کلید را ذخیره کرده باشد. ورک‌فلو را روی pushهای شاخه پیش‌فرض اجرا کنید تا ذخیره کند، و برای تطابق جزئی restore-keys اضافه کنید؛ cache-hit فقط برای تطابق دقیق key مقدار true دارد.

Skipbox چقدر کش Actions نگه می‌دارد؟

بیشتر از ۱۰ GB هر مخزن در GitHub، کنار ماشین شما به‌جای فضای ذخیره‌سازی GitHub. روی ماشین ابری، آنچه جاب‌ها با actions/cache‏، setup-* و rust-cache ذخیره می‌کنند روی دیسک خود ماشین می‌ماند، تا نصف آن دیسک (۸۰ GB روی S‏، ۱۶۰ GB روی M‏، ۳۲۰ GB روی L)؛ روی یک میزبان Skipbox، کش میزبان برای هر مخزن 20 GB نگه می‌دارد. در هر دو حالت یک ورودی تا ۷ روز پس از آخرین استفاده نگه داشته می‌شود، با قاعده‌های شاخه GitHub. کش پکیج‌ها و لایه‌های Docker از این مسیر نمی‌گذرند: روی خود دیسک می‌مانند.

چه چیزی کش‌های یک ماشین Skipbox را پاک می‌کند؟

بین جاب‌ها هیچ چیز: کش‌ها روی ماشین می‌مانند، و فقط وقتی یک جاب دیسک را تقریباً پر بگذارد، آنچه از همه قدیمی‌تر استفاده شده اول می‌رود. ماشین در یک بازنشانی تمیز شروع می‌شود: وقتی «بازنشانی ماشین» را بزنید، وقتی ایمیجش به‌روز شود (دست‌کم ماهی یک بار)، وقتی بعد از یک جاب از health check رد نشود، و وقتی یک جاب به سقف ۶ ساعت برسد. وقتی طرح تمام شود، ماشین همراه دیسکش حذف می‌شود.

امتحان کردنش چقدر هزینه دارد؟

هیچ. دوره آزمایشی ۷ روز یا ۳٬۰۰۰ دقیقه جاب است، هر کدام زودتر برسد، و کارت نمی‌خواهد. جابی را که کشش پیدا نمی‌شود یا دیر بازمی‌گردد به runs-on: skipbox ببرید، دو بار اجرایش کنید و گام‌های بازگرداندن و نصب اجرای دوم را با GitHub مقایسه کنید.

به‌روزرسانی: ۲۵ آبان ۱۴۰۵

CI/CD سریع‌تر با کشی که همیشه آماده است

رانر همیشه آماده شما با قیمت ثابت

میزبانی با ماست. شما یک خط را عوض می‌کنید. 1/12 هزینه GitHub با استفاده کامل. قیمت ثابت است، پس تمام روز اجرایش کنید. ۷ برابر فضای کش GitHub.

  • بدون کارت
  • ورود با GitHub
  • لغو در هر زمان