Had saiz cache GitHub Actions: kenapa cache anda diusir, lambat dipulihkan, atau tidak kena
GitHub Actions memberi setiap repositori cache 10 GB. Sebaik repositori melepasinya, GitHub tetap menyimpan entri baharu dan memadam entri yang paling lama tidak dibaca sehingga ia kembali di bawah had, dan ia memadam sebarang entri yang tidak dibaca oleh mana-mana job selama 7 hari. Cabang hanya membaca cache-nya sendiri dan cache cabang lalai, jadi larian pertama cabang baharu sering tidak kena. Dan cache yang kena masih merupakan muat turun: setiap job pada runner yang dihoskan GitHub bermula pada VM baharu, jadi ia memuat turun dan membuka arkib sekali lagi. Anda boleh menaikkan had, pada $0.07 bagi setiap GB sebulan melebihi 10 GB, dan menala key anda, tetapi muat turun itu kekal.
Skipbox membuang muat turun itu. Job anda berjalan pada mesin khusus akaun anda, yang dikekalkan antara job, jadi cache npm, pnpm, Gradle, Go dan Cargo serta lapisan Docker masih ada pada cakeranya daripada job sebelumnya (80 GB pada S, berbanding 14 GB pada runner GitHub). Apa yang disimpan actions/cache kekal bersebelahan dengan mesin, jadi pemulihan ialah bacaan setempat. Tukar satu baris, runs-on: skipbox, pada harga tetap $39 sebulan dengan minit tanpa had.
Peraturan cache GitHub
Daripada rujukan dependency caching GitHub, pengebilan Actions dan changelog-nya tentang cache melebihi 10 GB:
| Peraturan | Apa yang dilakukan GitHub |
|---|---|
| Saiz | 10 GB bagi setiap repositori secara lalai, dikongsi oleh setiap cabang dan workflow |
| Melepasi saiz | Menyimpan entri baharu, kemudian memadam entri mengikut akses terakhir, yang paling lama dahulu, sehingga repositori di bawah had. Pengusiran berjalan setiap jam |
| Entri tidak digunakan | Memadam sebarang entri yang tidak dibaca lebih daripada 7 hari |
| Had lebih besar | Pada akaun Pro, Team atau Enterprise, pentadbir boleh menaikkan saiz dan bilangan hari. Melebihi 10 GB, $0.07 bagi setiap GB sebulan, mengikut puncak setiap jam. Bajet yang dicapai menjadikan cache baca sahaja sehingga kitaran pengebilan seterusnya |
| Cabang | Larian memulihkan cache daripada cabangnya dan cabang lalai; larian pull request juga daripada cabang asasnya. Tidak pernah cabang adik-beradik atau cabang anak |
| Pull request | Cache pull request terhad kepada merge ref-nya: hanya larian semula pull request itu yang membacanya |
| Entri | Tidak boleh diubah. Key yang sudah wujud tidak disimpan semula |
| Hit | cache-hit hanya true bagi padanan tepat key; padanan restore-keys ialah false |
| Kadar | Sehingga 200 muat naik dan 1,500 muat turun seminit bagi setiap repositori |
Kenapa cache diusir
Satu 10 GB memuatkan semua yang disimpan repositori. Setiap cabang dan setiap pull request menyimpan entrinya sendiri. Matrix tiga versi Node pada dua sistem pengendalian menyimpan enam. Cache build type=gha Docker mendarat dalam 10 GB yang sama. Apabila simpanan sehari melebihi had, setiap simpanan baharu memadam entri yang lebih lama, selalunya entri yang diperlukan job seterusnya. GitHub memanggilnya cache thrashing.
Untuk melihat apa yang memenuhinya, senaraikan entri mengikut saiz:
gh cache list --sort size_in_bytes --limit 20
Halaman Actions › Caches repositori menunjukkan perkara yang sama, dengan cabang dan penggunaan terakhir setiap entri.
Kenapa pemulihan lambat
Cache yang kena pada runner yang dihoskan GitHub ialah muat turun ke VM baharu, kemudian pembukaan arkib. Masanya bertambah dengan saiz arkib, jadi cache yang membesar kepada beberapa GB boleh mengambil masa sama lama dengan pemasangan yang sepatutnya dilangkau. Muat turun yang tersekat dipotong oleh tamat masa segmen actions/cache, 10 minit secara lalai (SEGMENT_DOWNLOAD_TIMEOUT_MINS).
Kebanyakan persediaan juga memulihkan kurang daripada yang disangka. Input cache: setup-node menyimpan cache muat turun pengurus pakej, bukan node_modules: selepas pemulihan, npm ci masih memasang setiap pakej. Cache pip setup-python juga sama: muat turun kembali, persekitaran dipasang semula.
Kenapa cache tidak kena
- Key berubah. Key dengan
hashFiles('**/package-lock.json')tidak kena pada setiap perubahan lockfile.restore-keysmemberi padanan separa, dancache-hitkemudian membacafalse. - Cabang baharu. Ia boleh membaca cache cabang lalai, bukan cache cabang ciri lain. Jika cabang lalai tidak pernah menjalankan workflow itu, tiada apa-apa untuk dibaca.
- Diusir. Had atau 7 hari telah mengambilnya.
- Ia tidak pernah disimpan. Entri tidak boleh diubah, jadi key yang wujud tidak pernah disimpan semula, dan kandungan dalam cache kekal setua simpanan pertamanya. Pull request daripada fork mungkin tidak dibenarkan menyimpan langsung.
Menghantar fail ke job seterusnya dalam larian yang sama ialah alat yang berbeza. Cache adalah untuk larian seterusnya; output build yang diperlukan oleh job kemudian dalam workflow yang sama melalui actions/upload-artifact dan actions/download-artifact. Artifact mempunyai storannya sendiri, berasingan daripada 10 GB itu, dan ia juga muat turun ke VM baharu.
Kos setiap pembetulan pada runner GitHub
- Naikkan had. Kurang pengusiran, pada $0.07 bagi setiap GB sebulan melebihi 10 GB (contoh GitHub sendiri: 200 GB yang digunakan sepenuhnya ialah $13.30 sebulan), pada akaun Pro, Team atau Enterprise. Pemulihan kekal sebagai muat turun, dan cache yang lebih besar mengambil masa lebih lama untuk dimuat turun.
- Simpan kurang. Simpan
~/.npmatau stor pnpm dalam cache, bukannode_modulesatau output build. Simpan hanya pada cabang lalai, denganactions/cache/restoredalam setiap job danactions/cache/savedalam satu. Ia memakan masa anda, dan cache yang lebih kecil memulihkan lebih sedikit. - Betulkan key. Gunakan lockfile sebagai key, tambah
restore-keys, dan jalankan workflow pada push ke cabang lalai supaya cabang baharu ada sesuatu untuk dibaca. - Self-hosted runner yang mengekalkan cakeranya. Tiada muat turun, tiada 10 GB. Anda menjalankan mesinnya: kemas kini OS, pembersihan antara job tanpa memadam cache, dan membaikinya apabila rosak.
Apabila penyelesaiannya ialah mesin yang mengekalkan cakeranya
Cache wujud kerana mesin itu lupa. Runner yang dihoskan GitHub ialah VM baharu bagi setiap job, jadi job menyimpan keadaannya ke storan GitHub dan mengambilnya semula pada kali seterusnya. Pada mesin yang kekal, keadaan itu sudah ada pada cakeranya: cache pengurus pakej, cache alat, imej dan cache build Docker, malah output build.
Perbezaannya kelihatan dalam CI projek sebenar, daripada larian kami bagi job mereka sendiri:
- astro (Node.js, Turborepo): 528 s di GitHub, 30 s pada mesin khusus Skipbox, yang mengekalkan cache turbo, jadi larian hangatnya memainkan semula 40 tugas build dan bukannya menjalankannya.
- helix (Rust): step toolchain dan cache mengambil masa 9-10 s pada mesin khusus, berbanding 41-46 s di GitHub.
- tauri (Rust): 246 s di GitHub, 53 s pada mesin khusus, dengan
target/dikekalkan antara job.
Skipbox mengekalkan cache pada mesin anda
Setiap pelan disertakan dengan mesin khusus akaun anda, dikekalkan antara job:
- Cache pakej kekal pada cakera:
~/.npm, stor pnpm,~/.cachesetiap alat, dan cache Go, Gradle, Cargo dan Maven, dengan alat yang dipasang olehsetup-*. Tiada apa-apa untuk dipulihkan. - Imej, lapisan dan cache build Docker juga kekal.
docker buildmenggunakan semula lapisan build sebelumnya (cache lapisan Docker). - **actions/cache, setup-* dan rust-cache tidak perlu diubah.** Apa yang disimpannya kekal bersebelahan dengan mesin dan bukannya dalam storan GitHub, dengan lebih banyak ruang daripada 10 GB GitHub bagi setiap repositori, dan pemulihan membacanya secara setempat.
- Tiada luput 7 hari pada cakera. Tiada apa-apa dipadam sehingga cakera hampir penuh selepas job; kemudian apa yang paling lama tidak digunakan dibuang dahulu.
Sekurang-kurangnya 7× ruang cache GitHub pada S. Job memilih saiznya melalui label:
| Label | Mesin | Cakera | Pelan |
|---|---|---|---|
skipbox | 4 vCPU · 16 GB | 80 GB | S, $39 sebulan |
skipbox-8x16 | 8 vCPU · 16 GB | 160 GB | M, $79 sebulan |
skipbox-16x32 | 16 vCPU · 32 GB | 320 GB | L, $149 sebulan |
ubuntu-latest repositori peribadi mempunyai 2 CPU, 8 GB dan SSD 14 GB. Minit tanpa had di Skipbox. Pada 20,000 minit sebulan pada 4 vCPU, GitHub mengecaj $222; Skipbox S ialah $39, $183 lebih murah.
Beralih hanya satu baris
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
- Log masuk ke Skipbox dengan GitHub.
- Pasang GitHub App Skipbox dan pilih repositori.
- Tukar
runs-ondan push.
Kekalkan step cache anda seperti sedia ada. Larian kedua menemui cache larian pertama pada mesin.
Keselamatan
- Mesin itu milik akaun anda seorang. Tiada job syarikat lain berjalan padanya.
- Selepas setiap job, bukti kelayakan, proses dan container runner dipadam. “VM baharu bagi setiap job” memberi setiap job mesin baharu sebaliknya.
- Kod daripada orang tanpa akses tulis (seperti pull request daripada fork) berjalan pada VM baharu yang membaca cache anda tetapi tidak boleh mengubahnya.
Butirannya dalam cara job diasingkan.
Cuba pada job yang cache-nya tidak kena
Percubaan adalah percuma selama 7 hari atau 3,000 minit job, yang mana dahulu, dan tidak memerlukan kad. Pindahkan job itu ke runs-on: skipbox, jalankan dua kali, dan letakkan step pemulihan dan pemasangan larian kedua bersebelahan dengan GitHub.
Soalan lazim
Apakah had saiz cache GitHub Actions?
10 GB bagi setiap repositori secara lalai, untuk semua cabang dan workflow bersama. Melepasinya, GitHub tetap menyimpan entri baharu dan memadam entri mengikut akses terakhir, yang paling lama dahulu, sehingga repositori kembali di bawah had. Entri yang tidak dibaca oleh mana-mana job selama 7 hari dipadam tanpa mengira saiz. Pada akaun Pro, Team atau Enterprise, pentadbir boleh menaikkan had dan bilangan hari; storan melebihi 10 GB dicaj $0.07 bagi setiap GB sebulan, diukur mengikut puncak setiap jam, dan sebaik bajet dicapai cache menjadi baca sahaja sehingga kitaran pengebilan seterusnya.
Kenapa cache GitHub Actions saya kerap diusir?
Kerana segala-galanya dalam repositori berkongsi satu 10 GB: setiap cabang, setiap pull request, setiap job matrix dan setiap OS menyimpan entrinya sendiri, dan cache type=gha Docker mendarat di tempat yang sama. Apabila simpanan sehari melebihi had, setiap simpanan memadam entri yang lebih lama, dan job seterusnya terlepas entri yang diperlukannya. GitHub memanggilnya cache thrashing. Senaraikan entri mengikut saiz (gh cache list --sort size_in_bytes) untuk melihat apa yang memenuhinya.
Kenapa pemulihan cache mengambil masa sama lama dengan pemasangan dari awal?
Kerana cache yang kena masih merupakan muat turun. Setiap job pada runner yang dihoskan GitHub bermula pada VM baharu, jadi actions/cache memuat turun arkib dan membukanya setiap kali, dan semakin besar cache semakin lama masanya. Cache setup-node memulihkan cache muat turun pengurus pakej, bukan node_modules, jadi npm ci masih memasang setiap pakej selepas pemulihan. Pada runner yang mengekalkan cakeranya, cache sudah ada dan tiada apa-apa dimuat turun.
Kenapa actions/cache tidak kena pada cabang baharu?
Larian boleh memulihkan cache daripada cabangnya sendiri dan daripada cabang lalai, dan larian pull request juga daripada cabang asasnya. Ia tidak boleh membaca cache cabang adik-beradik. Jadi larian pertama cabang ciri hanya kena jika cabang lalai telah menyimpan key itu. Jalankan workflow pada push ke cabang lalai supaya ia menyimpan, dan tambah restore-keys untuk padanan separa; cache-hit hanya true bagi padanan tepat key.
Berapa banyak cache Actions yang dikekalkan Skipbox?
Lebih daripada 10 GB GitHub bagi setiap repositori, bersebelahan dengan mesin anda dan bukannya dalam storan GitHub. Pada mesin awan, apa yang disimpan job dengan actions/cache, setup-* dan rust-cache kekal pada cakera mesin itu sendiri, sehingga separuh cakera tersebut (80 GB pada S, 160 GB pada M, 320 GB pada L); pada hos Skipbox, cache hos menyimpan 20 GB bagi setiap repositori. Kedua-duanya mengekalkan entri 7 hari selepas ia terakhir digunakan, dengan peraturan cabang GitHub. Cache pakej dan lapisan Docker tidak melaluinya: ia kekal pada cakera itu sendiri.
Apakah yang mengosongkan cache pada mesin Skipbox?
Tiada apa-apa antara job: cache kekal pada mesin, dan hanya apabila job meninggalkan cakera hampir penuh, apa yang paling lama tidak digunakan dibuang dahulu. Mesin bermula bersih apabila set semula: apabila anda menekan Set semula mesin, apabila imejnya dikemas kini (sekurang-kurangnya sebulan sekali), apabila ia gagal semakan kesihatannya selepas job, dan apabila job mencapai had 6 jam. Apabila pelan tamat, mesin dipadam bersama cakeranya.
Berapakah kos untuk mencuba?
Tiada. Percubaan ialah 7 hari atau 3,000 minit job, yang mana dahulu, tanpa kad. Pindahkan job yang cache-nya tidak kena atau lambat dipulihkan ke runs-on: skipbox, jalankan dua kali, dan bandingkan step pemulihan dan pemasangan larian kedua dengan GitHub.
Dikemas kini 19 November 2026