چرا rust-cache CI شما در Rust را سریع نمیکند (tauri: از 246 ثانیه به 53 ثانیه)
Swatinem/rust-cache، گام کش در بیشتر CIهای Rust، وابستگیهای شما را ذخیره میکند و عمداً crateهای workspace شما را کنار میگذارد. CARGO_INCREMENTAL=0 را هم تنظیم میکند. روی رانرهای GitHub هر جاب روی یک ماشین مجازی تازه شروع میشود، پس هر جاب گرم، حتی با cache hit کامل، crateهای خودتان را دوباره کامپایل میکند. هیچ تنظیمی در rust-cache این را از بین نمیبرد. چیزی که از بین میبرد target/ی است که از جاب قبلی هنوز آنجاست: آن وقت Cargo هر crateی را که تغییر نکرده رد میکند.
Skipbox آن را برایتان نگه میدارد. جاب شما روی ماشین اختصاصی حسابتان اجرا میشود، که checkout و target/ در Cargo را بین جابها نگه میدارد. جاب CI در tauri روی GitHub 246 ثانیه طول کشید و آنجا 53 ثانیه، و از اولین اجرای گرم هیچکدام از crateهایش را کامپایل نکرد، بدون هیچ تغییری در ورکفلویش جز runs-on: skipbox، با قیمت ثابت ماهانه $۳۹.
rust-cache چه چیزی را نگه میدارد و چه چیزی را کنار میگذارد
از README در rust-cache و سورس آن:
- چه چیزی را کش میکند:
~/.cargo(registry، وابستگیهای git، باینریهای نصبشده) و./targetبا خروجی بیلد وابستگیهایتان. - چه چیزی را کنار میگذارد: خود crateهای workspace کش نمیشوند. پیش از save، پاکسازی آن هر چیزی در
target/را که وابستگی نباشد حذف میکند، پس artifactهای crateهای شما از خودtarget/برداشته میشوند. - کامپایل افزایشی: گام restore برای بقیه جاب
CARGO_INCREMENTAL=0را export میکند. - کی save میکند: فقط وقتی هنوز هیچ کشی کلید جاب را ندارد. کلید از toolchain، محیط و
Cargo.lockوCargo.tomlشما میآید. فایلهای سورس شما بخشی از آن نیستند.
روی یک ماشین مجازی تازه نتیجه یک چیز است. جاب گرم وابستگیهایتان را بازمیگرداند، بعد crateهای workspace شما و هر چیزی که روی آنها ساخته شده را، کامل، هر بار کامپایل میکند.
سازوکار، در لاگهای tauri
جاب test در tauri پنج گام cargo test را روی Ubuntu با rust-cache اجرا میکند. این اجراهای گرم آن است، هر کدام یک cache hit کامل (full match: true در لاگ):
| اجرای گرم | خطوط Compiling | زمان بیلد Cargo | جاب |
|---|---|---|---|
| GitHub | 32 | 118 ثانیه | 271 ثانیه |
| Skipbox، ماشین مجازی تازه | 32 | 62 ثانیه | 146 ثانیه |
| Skipbox، ماشین اختصاصی، اجرای گرم اول | 0 | حدود 1.5 ثانیه | 53 ثانیه |
| Skipbox، ماشین اختصاصی، اجرای گرم دوم | 0 | حدود 1.9 ثانیه | 53 ثانیه |
آن 32 خط crateهای خود tauri هستند، و دو plugin که روی آنها ساخته شدهاند. وابستگیها هرگز نشان داده نمیشوند: از کش میآیند. زمان بیلد Cargo جمع زمانهای Finished … in در پنج گام است.
ماشین مجازی تازه همان CPUهای ماشین اختصاصی و همان کش را دارد، و همان 32 crate را مثل GitHub کامپایل کرد: target/ آن فقط چیزی را داشت که کش بازگردانده بود. روی ماشین اختصاصی، اجرای گرم اول از همان اول هیچ خط Compiling چاپ نمیکند. Cargo فقط بررسی کرد که چیزی تغییر نکرده باشد، و هر Finished 0.2 تا 0.7 ثانیه طول کشید.
اجرای گرم اول ماشین اختصاصی قبلاً همه 32 crate را دوباره کامپایل میکرد (یک جاب 114 ثانیهای)، چون save در rust-cache بعد از اجرای سرد آنها را از target/ حذف کرده بود. از 13 نوامبر 2026، ماشینهای اختصاصی آنچه را restore و save در rust-cache از دیسک حذف میکنند، به محض پایان گام برمیگردانند. کشی که ذخیره میکند همان است، و crateهای شما در target/ میمانند.
زمان جابها: سه پروژه Rust، شش پروژه دیگر
جابهای CI خود پروژههای واقعی در یک commit ثابت، با گامهایی بایت به بایت یکسان؛ فقط trigger و runs-on تغییر کرد. یک اجرای سرد، بعد دو اجرای گرم، در هر طرف:
- GitHub:
ubuntu-24.04، رانر استاندارد یک مخزن عمومی: 4 vCPU، 16 GB. - Skipbox، ماشین مجازی تازه: یک ماشین مجازی تازه برای هر جاب از ایمیج رانر production، با 4 vCPU و 8 GB، کشها از طریق کش Skipbox بازگردانده شدند.
- Skipbox، ماشین اختصاصی: همان اندازه روی همان CPUهای میزبان، نگهداشتهشده بین جابها، با نگهداری و پاکسازیای که ماشینهای اختصاصی از 13 نوامبر 2026 انجام میدهند: checkout و
target/میمانند، و آنچه rust-cache حذف میکند برگردانده میشود.
اجراهای Skipbox روی یک میزبان Skipbox بودند، در یک پروژه آزمایشگاهی جدا از ماشینهای مشتریان. زمانها از شروع هر جاب تا پایانش است، از API GitHub. هر عدد میانه دو اجرای گرم است. اجراهای سرد ماشین اختصاصی برای tauri 285 ثانیه، برای ripgrep 161 ثانیه و برای helix 442 ثانیه طول کشیدند.
| پروژه | GitHub | Skipbox، ماشین مجازی تازه | Skipbox، ماشین اختصاصی | GitHub ÷ ماشین اختصاصی |
|---|---|---|---|---|
| tauri | 246 ثانیه (220، 271) | 210 ثانیه (273، 146) | 53 ثانیه (53، 53) | 4.6 برابر |
| ripgrep | 200 ثانیه (194، 206) | 156 ثانیه (155، 156) | 40 ثانیه (39، 40) | 5.0 برابر |
| helix | 330 ثانیه (293، 366) | 350 ثانیه (439، 260) | 224 ثانیه (222، 226) | 1.5 برابر |
ripgrep داخل ایمیج Docker ابزار cross بیلد میشود. cross خودش target/ را میسازد و برچسب "created by cross" به آن میزند. ماشینهای اختصاصی قبلاً آن target/ را چیزی غیر از مال Cargo میگرفتند و بعد از هر جاب حذفش میکردند، پس Cargo در هر اجرا همه crateها را دوباره کامپایل میکرد (یک جاب 108 ثانیهای). حالا target/ ساخته cross میماند: اجراهای گرم هیچ خط Compiling چاپ نمیکنند، و هر Finished 0.04 تا 0.05 ثانیه طول میکشد. GitHub ایمیج cross را هم در هر اجرا دانلود میکند (در اجرای گرم دوم 30 ثانیه)؛ ماشین اختصاصی آن را روی دیسک نگه میدارد.
helix هم 1.5× سریعتر اجرا میشود. از crateهای آن، فقط helix-term (و xtask که به آن وابسته است) دوباره بیلد میشود، چون build script در helix-term در هر جاب اجرا میشود: در پروفایل test 16 ثانیه و در پروفایل integration 61 ثانیه. هیچ crate دیگری کامپایل نمیشود. بیشتر جاب helix تستهای آن است: فقط مجموعه تست یکپارچهسازی آن 112 ثانیه اجرا میشود. گام آمادهسازی آن، یعنی toolchain و بازگردانی کش، 9 تا 10 ثانیه طول کشید، در برابر 41 تا 46 ثانیه روی GitHub.
زبانهای دیگر:
| پروژه | زبان | GitHub | Skipbox، ماشین اختصاصی |
|---|---|---|---|
| astro | Node.js | 528 ثانیه | 30 ثانیه |
| vite | Node.js | 141 ثانیه | 100 ثانیه |
| prometheus | Go | 335 ثانیه | 273 ثانیه |
| cli | Go | 163 ثانیه | 137 ثانیه |
| pytest | Python | 416 ثانیه | 365 ثانیه |
| guava | Java | 818 ثانیه | 651 ثانیه |
astro همان داستان target/ است، با Turborepo: ماشین اختصاصی کش turbo را نگه میدارد (turbo 2)، پس اجراهای گرمش همه 40 تسک بیلد و تسک تست را بهجای اجرا از آن بازپخش میکنند (31 ثانیه، 28 ثانیه).
ubuntu-latest یک مخزن خصوصی 2 CPU و 8 GB دارد: نصف هستههای اجراهای GitHub در بالا.
CI خودتان را بررسی کنید
- یک اجرای گرم جاب Rust خود را باز کنید، اجرایی که گام rust-cache آن
full match: trueدر لاگ مینویسد. - در گامهای بیلد و تست، خطوط
Compilingرا بشمارید. وابستگیهای کششده هیچ خطی چاپ نمیکنند. هر crate workspace شما یک خط چاپ میکند، و هر crateی که روی آنها ساخته شده هم. - زمانهای
Finished … inگامها را جمع بزنید. این همان چیزی است که crateهای خودتان در هر اجرا هزینه دارند، و همان چیزی کهtarget/نگهداشتهشده وقتی تغییر نکردهاند صرفهجویی میکند.
روی رانرهای GitHub چه کاری میتوانید بکنید
cache-workspace-crates: true(rust-cache نسخه v2.8.0 و بعدتر). crateهای شما هم در کش میروند. ولی اجرایی که کلیدش وجود دارد save را رد میکند، و کلید با سورس شما تغییر نمیکند، پس crateهای کششده به قدمت آخرین save هستند. کامپایل افزایشی خاموش میماند، و کش داخل ۱۰ GB GitHub برای هر مخزن بزرگ میشود.- sccache. هر کامپایل را بر اساس ورودیهایش کش میکند، پس یک crate کتابخانهای تغییرنکرده از فضای ذخیره برمیگردد. crateهایی که linker را فراخوانی میکنند کش نمیشوند: باینریها و crateهای
dylib،cdylibو proc-macro هر بار کامپایل میشوند، و هر hit یک دانلود است. - رانر خودمیزبانی که
target/را نگه دارد. ماشین را خودتان اداره میکنید: وصلهاش کنید، بین جابها بدون حذفtarget/تمیزش کنید، و روی actions/checkout مقدارclean: falseرا تنظیم کنید، چونgit clean -ffdxپیشفرض آنtarget/را همراه با همه فایلهای ignoreشده دیگر حذف میکند.
Skipbox پوشه target/ را برایتان نگه میدارد
هر طرح با ماشین اختصاصی حساب شما میآید که بین جابها نگه داشته میشود. از 13 نوامبر 2026، checkout شما را با زمانهای فایلهایش، و target/ در Cargo را نگه میدارد:
- clean در actions/checkout طبق معمول اجرا میشود، جز اینکه پوشههای
target/در Cargo را دست نمیزند. - rust-cache در ورکفلوی شما میماند. restore آن دیگر artifactهای قدیمیتر کش را روی جدیدترهای روی دیسک نمینویسد.
- آنچه save و restore در rust-cache از
target/و~/.cargoحذف میکنند، ماشین به محض پایان گام برمیگرداند. کش ذخیرهشده همان است، و از جاب بعد از اجرای سرد، crateهایی که تغییر نکردهاند کامپایل نمیشوند. target/ی که cross میسازد (با برچسب "created by cross") هم میماند.- actions/checkout در هر جاب
.git/HEADرا بازنویسی میکند. تا وقتی هنوز به همان commit اشاره کند، فایل زمان قبلیاش را پس میگیرد، پس build scriptی که.git/HEADرا زیر نظر دارد (vergen این کار را میکند) فقط به همین خاطر دوباره اجرا نمیشود.
ماشین ایمیجهای Docker، کش پکیجها و ابزارهای نصبشده را هم نگه میدارد، پس بقیه جاب هم همراه آن سریعتر میشود. هر جاب اندازهاش را با لیبل انتخاب میکند:
| لیبل | ماشین | طرح |
|---|---|---|
skipbox | ۴ vCPU · ۱۶ GB | S، ماهانه $۳۹ |
skipbox-8x16 | ۸ vCPU · ۱۶ GB | M، ماهانه $۷۹ |
skipbox-16x32 | ۱۶ vCPU · ۳۲ GB | L، ماهانه $۱۴۹ |
دقیقهها نامحدودند. با 20,000 دقیقه در ماه روی 4 vCPU، GitHub $۲۲۲ میگیرد؛ Skipbox S $۳۹ است، $۱۸۳ کمتر.
انتقال یک خط است
jobs:
test:
runs-on: skipbox # was ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: dtolnay/rust-toolchain@stable
- uses: Swatinem/rust-cache@v2
- run: cargo test --workspace
- با GitHub وارد Skipbox شوید.
- اپ Skipbox در GitHub را نصب کنید و مخزنها را انتخاب کنید.
runs-onرا تغییر دهید و push کنید.
امنیت
- ماشین فقط مال حساب شماست. جاب هیچ شرکت دیگری روی آن اجرا نمیشود.
- بعد از هر جاب، اعتبارنامههای رانر، پروسهها و کانتینرها پاک میشوند، و همینطور اعتبارنامههای git، hookها و فایلهای ردیابینشده در checkout نگهداشتهشده. گزینه «ماشین تازه برای هر جاب» بهجای آن به هر جاب یک ماشین تازه میدهد.
- کد افرادی که دسترسی نوشتن ندارند (مثل pull requestها از forkها) روی یک ماشین تازه و دورریختنی اجرا میشود، بدون
target/نگهداشتهشده.
جزئیات در جداسازی جابها است.
روی جاب Rust خود امتحانش کنید
دوره آزمایشی به مدت ۷ روز یا ۳٬۰۰۰ دقیقه جاب رایگان است، هر کدام زودتر برسد، و کارت نمیخواهد. جاب Rust خود را به runs-on: skipbox ببرید، دو بار اجرایش کنید و خطوط Compiling اجرای دوم را کنار خطوط GitHub بگذارید.
پرسشهای متداول
Swatinem/rust-cache crateهای workspace من را کش میکند؟
نه، بهطور پیشفرض نه. README آن میگوید خود crateهای workspace کش نمیشوند، و گام save آن پیش از آپلود کش، خروجی بیلدشان را از target/ حذف میکند. ~/.cargo و خروجی بیلد وابستگیهایتان را کش میکند، و برای بقیه جاب CARGO_INCREMENTAL=0 را تنظیم میکند. پس روی یک ماشین مجازی تازه GitHub، هر اجرای گرم crateهای workspace شما را دوباره کامپایل میکند، حتی با cache hit کامل. در CI tauri روی GitHub این یعنی 32 خط Compiling در هر اجرای گرم.
باید cache-workspace-crates: true را تنظیم کنم؟
crateهای شما را هم در کش میگذارد (rust-cache نسخه v2.8.0 و بعدتر)، ولی کلید کش از toolchain، محیط و Cargo.lock و Cargo.toml شما میآید، نه از سورس. اجرایی که کلیدش از قبل وجود دارد save را رد میکند، پس نسخه کششده crateهایتان به قدمت آخرین save است و با هر commit از کدتان فاصله میگیرد. کامپایل افزایشی خاموش میماند. لاگ یک اجرای گرم را بررسی کنید: اگر crateهایتان هنوز Compiling نشان میدهند، کمکی نمیکند.
sccache مشکل CI کند Rust در GitHub Actions را حل میکند؟
برای crateهای کتابخانهای که ورودیهایشان تغییر نکرده کمک میکند. sccache نمیتواند crateهایی را که linker را فراخوانی میکنند کش کند (crateهای bin، dylib، cdylib و proc-macro)، و هر hit یک دانلود از فضای ذخیره کش آن است. target/ نگهداشتهشده بین جابها دانلودی لازم ندارد: crateی که Cargo آن را تغییرنکرده ببیند اصلاً کامپایل نمیشود.
برای نگه داشتن target/ روی Skipbox باید ورکفلویم را تغییر دهم؟
نه. runs-on را به skipbox تغییر دهید و rust-cache و actions/checkout را همانطور که هستند بگذارید. ماشین اختصاصی شما checkout و target/ در Cargo را بین جابها نگه میدارد، و clean در checkout پوشههای target/ را دست نمیزند. وقتی save در rust-cache crateهای شما را از target/ حذف میکند، ماشین آنها را برمیگرداند، و restore آن دیگر artifactهای قدیمیتر را روی جدیدترها نمینویسد. پس از اولین اجرای گرم، crateهایی که تغییر نکردهاند کامپایل نمیشوند.
امتحان کردنش چقدر هزینه دارد؟
هیچ. دوره آزمایشی ۷ روز یا ۳٬۰۰۰ دقیقه جاب است، هر کدام زودتر برسد، بدون کارت. جاب Rust خود را به runs-on: skipbox ببرید، دو بار اجرایش کنید و خطوط Compiling و گامهای بیلد اجرای دوم را با GitHub مقایسه کنید.
بهروزرسانی: ۲۵ آبان ۱۴۰۵