سقف حجم کش 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:
| قاعده | GitHub چه میکند |
|---|---|
| اندازه | بهطور پیشفرض ۱۰ GB برای هر مخزن، مشترک بین همه شاخهها و ورکفلوها |
| بیش از اندازه | ورودی تازه را ذخیره میکند، بعد ورودیها را به ترتیب آخرین دسترسی، از قدیمیترین، حذف میکند تا مخزن زیر سقف برود. حذف هر ساعت اجرا میشود |
| ورودیهای بیاستفاده | هر ورودیای را که بیش از ۷ روز خوانده نشده حذف میکند |
| سقف بزرگتر | روی حساب Pro، Team یا Enterprise، مدیران میتوانند اندازه و روزها را بالا ببرند. بیش از ۱۰ GB، ماهانه $0.07 برای هر GB، بر اساس بیشینه هر ساعت. رسیدن به یک بودجه کش را تا چرخه صورتحساب بعدی فقطخواندنی میکند |
| شاخهها | یک اجرا کشها را از شاخه خودش و شاخه پیشفرض بازمیگرداند؛ اجرای یک pull request از شاخه پایهاش هم. هرگز از یک شاخه همسطح یا فرزند |
| pull requestها | کشهای یک pull request به merge ref آن محدودند: فقط اجراهای دوباره همان pull request آنها را میخوانند |
| ورودیها | تغییرپذیر نیستند. کلیدی که از قبل وجود دارد دوباره ذخیره نمیشود |
| پیدا شدن | cache-hit فقط برای تطابق دقیق key مقدار true دارد؛ تطابق restore-keys مقدار false است |
| نرخ | تا 200 آپلود و 1,500 دانلود در دقیقه برای هر مخزن |
چرا کش حذف میشود
یک ۱۰ 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. هر جاب اندازهاش را با لیبل انتخاب میکند:
| لیبل | ماشین | دیسک | طرح |
|---|---|---|---|
skipbox | ۴ vCPU · ۱۶ GB | ۸۰ GB | S، ماهانه $۳۹ |
skipbox-8x16 | ۸ vCPU · ۱۶ GB | ۱۶۰ GB | M، ماهانه $۷۹ |
skipbox-16x32 | ۱۶ vCPU · ۳۲ GB | ۳۲۰ GB | L، ماهانه $۱۴۹ |
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
- با GitHub وارد Skipbox شوید.
- اپ Skipbox در GitHub را نصب کنید و مخزنها را انتخاب کنید.
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 مقایسه کنید.
بهروزرسانی: ۲۵ آبان ۱۴۰۵