Batas ukuran cache GitHub Actions: kenapa cache Anda dibuang, lambat dipulihkan, atau meleset
GitHub Actions memberi setiap repositori cache sebesar 10 GB. Begitu repositori melewatinya, GitHub tetap menyimpan entri baru dan menghapus entri yang paling lama tidak dibaca sampai kembali di bawah batas, dan GitHub menghapus entri apa pun yang tidak dibaca job mana pun selama 7 hari. Sebuah branch hanya membaca cache-nya sendiri dan cache branch default, jadi run pertama branch baru sering meleset. Dan cache hit tetap berarti unduhan: setiap job di runner yang dihosting GitHub dimulai di VM baru, jadi arsipnya diunduh dan diekstrak lagi. Anda bisa menaikkan batasnya, dengan $0,07 per GB per bulan di atas 10 GB, dan menyetel key Anda, tetapi unduhannya tetap ada.
Skipbox menghilangkan unduhannya. Job Anda berjalan di mesin khusus untuk akun Anda, yang disimpan di antara job, jadi cache npm, pnpm, Gradle, Go, dan Cargo serta layer Docker masih ada di disknya dari job terakhir (80 GB di S, dibandingkan 14 GB di runner GitHub). Apa yang disimpan actions/cache tetap berada di samping mesin, jadi pemulihan berarti pembacaan lokal. Ubah satu baris, runs-on: skipbox, dengan harga tetap $39 per bulan dan menit tanpa batas.
Aturan cache GitHub
Dari referensi dependency caching GitHub, penagihan Actions, dan changelog-nya tentang cache di atas 10 GB:
| Aturan | Yang dilakukan GitHub |
|---|---|
| Ukuran | 10 GB per repositori secara default, dibagi oleh semua branch dan workflow |
| Melewati ukuran | Menyimpan entri baru, lalu menghapus entri berdasarkan akses terakhir, yang terlama lebih dulu, sampai repositori di bawah batas. Pembuangan berjalan setiap jam |
| Entri yang tidak dipakai | Menghapus entri apa pun yang tidak dibaca lebih dari 7 hari |
| Batas lebih besar | Di akun Pro, Team, atau Enterprise, admin bisa menaikkan ukuran dan jumlah harinya. Di atas 10 GB, $0,07 per GB per bulan, dari puncak setiap jam. Anggaran yang tercapai membuat cache read-only sampai siklus penagihan berikutnya |
| Branch | Sebuah run memulihkan cache dari branch-nya dan branch default; run pull request juga dari branch base-nya. Tidak pernah dari branch saudara atau branch turunan |
| Pull request | Cache sebuah pull request dibatasi ke merge ref-nya: hanya run ulang pull request itu yang membacanya |
| Entri | Tidak bisa diubah. Key yang sudah ada tidak disimpan lagi |
| Hit | cache-hit bernilai true hanya untuk kecocokan key yang persis; kecocokan restore-keys bernilai false |
| Laju | Sampai 200 unggahan dan 1.500 unduhan per menit per repositori |
Kenapa cache dibuang
Satu 10 GB menampung semua yang disimpan repositori. Setiap branch dan setiap pull request menyimpan entrinya sendiri. Matrix tiga versi Node di dua sistem operasi menyimpan enam. Build cache type=gha milik Docker masuk ke 10 GB yang sama. Saat simpanan sehari melebihi batas, setiap simpanan baru menghapus entri yang lebih lama, sering kali justru entri yang dibutuhkan job berikutnya. GitHub menyebutnya cache thrashing.
Untuk melihat apa yang memenuhinya, tampilkan entri berdasarkan ukuran:
gh cache list --sort size_in_bytes --limit 20
Halaman Actions › Caches di repositori menampilkan hal yang sama, beserta branch dan waktu terakhir dipakai setiap entri.
Kenapa pemulihannya lambat
Cache hit di runner yang dihosting GitHub adalah unduhan ke VM baru, lalu ekstraksi. Waktunya bertambah seiring ukuran arsip, jadi cache yang tumbuh hingga beberapa GB bisa memakan waktu sama lamanya dengan instalasi yang seharusnya dilewatinya. Unduhan yang macet diputus oleh segment timeout milik actions/cache, 10 menit secara default (SEGMENT_DOWNLOAD_TIMEOUT_MINS).
Sebagian besar setup juga memulihkan lebih sedikit dari yang dikira. Input cache: milik setup-node menyimpan cache unduhan package manager, bukan node_modules: setelah pemulihan, npm ci tetap memasang setiap paket. Cache pip milik setup-python sama saja: unduhannya kembali, environment-nya dipasang lagi.
Kenapa cache meleset
- Key-nya berubah. Key dengan
hashFiles('**/package-lock.json')meleset di setiap perubahan lockfile.restore-keysmemberi kecocokan sebagian, dancache-hitlalu bernilaifalse. - Branch baru. Branch itu bisa membaca cache branch default, bukan cache branch fitur lain. Jika branch default tidak pernah menjalankan workflow-nya, tidak ada yang bisa dibaca.
- Sudah dibuang. Batas ukuran atau 7 hari itu sudah mengambilnya.
- Tidak pernah tersimpan. Entri tidak bisa diubah, jadi key yang sudah ada tidak pernah disimpan lagi, dan isi cache-nya tetap setua simpanan pertamanya. Pull request dari fork mungkin sama sekali tidak diizinkan menyimpan.
Meneruskan file ke job berikutnya dalam run yang sama butuh alat yang berbeda. Cache untuk run berikutnya; output build yang dibutuhkan job selanjutnya dari workflow yang sama melewati actions/upload-artifact dan actions/download-artifact. Artifact punya storage sendiri, terpisah dari 10 GB itu, dan juga berupa unduhan ke VM baru.
Biaya setiap perbaikan di runner GitHub
- Naikkan batasnya. Lebih sedikit pembuangan, dengan $0,07 per GB per bulan di atas 10 GB (contoh dari GitHub sendiri: 200 GB yang terpakai penuh berbiaya $13,30 per bulan), di akun Pro, Team, atau Enterprise. Pemulihan tetap berupa unduhan, dan cache yang lebih besar makin lama diunduh.
- Simpan lebih sedikit. Cache
~/.npmatau store pnpm, bukannode_modulesatau output build. Simpan hanya di branch default, denganactions/cache/restoredi setiap job danactions/cache/savedi satu job. Ini memakan waktu Anda, dan cache yang lebih kecil memulihkan lebih sedikit. - Perbaiki key-nya. Buat key dari lockfile, tambahkan
restore-keys, dan jalankan workflow pada push ke branch default agar branch baru punya sesuatu untuk dibaca. - Self-hosted runner yang menyimpan disknya. Tanpa unduhan, tanpa batas 10 GB. Anda yang menjalankan mesinnya: pembaruan OS, pembersihan di antara job tanpa menghapus cache, dan memperbaikinya saat rusak.
Saat perbaikannya adalah mesin yang menyimpan disknya
Cache ada karena mesinnya lupa. Runner yang dihosting GitHub adalah VM baru untuk setiap job, jadi job menyimpan state-nya ke storage GitHub dan mengambilnya kembali di lain waktu. Di mesin yang tetap ada, state itu sudah ada di disknya: cache package manager, tool cache, image dan build cache Docker, bahkan output build.
Perbedaannya terlihat di CI proyek nyata, dari run kami pada job mereka sendiri:
- astro (Node.js, Turborepo): 528 detik di GitHub, 30 detik di mesin khusus untuk Anda di Skipbox, yang menyimpan cache turbo, jadi run hangatnya memutar ulang 40 task build alih-alih menjalankannya.
- helix (Rust): step toolchain dan cache memakan 9-10 detik di mesin khusus untuk Anda, dibandingkan 41-46 detik di GitHub.
- tauri (Rust): 246 detik di GitHub, 53 detik di mesin khusus untuk Anda, dengan
target/yang disimpan di antara job.
Skipbox menyimpan cache di mesin Anda
Setiap paket datang dengan mesin khusus untuk akun Anda, yang disimpan di antara job:
- Cache paket tetap ada di disk:
~/.npm, store pnpm,~/.cachesetiap tool, dan cache Go, Gradle, Cargo, dan Maven, beserta tool yang dipasangsetup-*. Tidak ada yang perlu dipulihkan. - Image, layer, dan build cache Docker juga tetap ada.
docker buildmemakai ulang layer dari build terakhir (cache layer Docker). - **actions/cache, setup-*, dan rust-cache tidak perlu diubah.** Apa yang mereka simpan tetap berada di samping mesin alih-alih di storage GitHub, dengan ruang lebih besar dari 10 GB per repositori milik GitHub, dan pemulihan membacanya secara lokal.
- Tanpa kedaluwarsa 7 hari di disk. Tidak ada yang dihapus sampai disk hampir penuh setelah sebuah job; saat itu yang paling lama tidak dipakai dibuang lebih dulu.
Ruang cache setidaknya 7× GitHub di paket S. Sebuah job memilih ukurannya lewat label:
| Label | Mesin | Disk | Paket |
|---|---|---|---|
skipbox | 4 vCPU · 16 GB | 80 GB | S, $39 per bulan |
skipbox-8x16 | 8 vCPU · 16 GB | 160 GB | M, $79 per bulan |
skipbox-16x32 | 16 vCPU · 32 GB | 320 GB | L, $149 per bulan |
ubuntu-latest di repositori privat punya 2 CPU, 8 GB, dan SSD 14 GB. Di Skipbox menitnya tanpa batas. Untuk 20.000 menit per bulan di 4 vCPU, GitHub menagih $222; Skipbox S $39, $183 lebih murah.
Pindah cukup 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
- Masuk ke Skipbox dengan GitHub.
- Instal aplikasi GitHub Skipbox dan pilih repositorinya.
- Ubah
runs-on, lalu push.
Biarkan step cache Anda seperti apa adanya. Run kedua menemukan cache dari run pertama di mesin.
Keamanan
- Mesinnya hanya milik akun Anda. Tidak ada job perusahaan lain yang berjalan di sana.
- Setelah setiap job, kredensial runner, proses, dan container dihapus. Bersih setiap job memberi setiap job mesin baru sebagai gantinya.
- Kode dari orang tanpa akses tulis (misalnya pull request dari fork) berjalan di VM baru yang bisa membaca cache Anda tetapi tidak bisa mengubahnya.
Detailnya ada di cara job diisolasi.
Coba di job yang cache-nya meleset
Uji cobanya gratis selama 7 hari atau 3.000 menit job, mana yang lebih dulu tercapai, dan tanpa kartu. Pindahkan job itu ke runs-on: skipbox, jalankan dua kali, lalu letakkan step pemulihan dan instalasi di run kedua di samping hasil di GitHub.
FAQ
Berapa batas ukuran cache GitHub Actions?
10 GB per repositori secara default, untuk semua branch dan workflow bersama-sama. Setelah melewatinya, GitHub tetap menyimpan entri baru dan menghapus entri berdasarkan akses terakhir, yang terlama lebih dulu, sampai repositori kembali di bawah batas. Entri yang tidak dibaca job mana pun selama 7 hari dihapus berapa pun ukurannya. Di akun Pro, Team, atau Enterprise, admin bisa menaikkan batas dan jumlah harinya; penyimpanan di atas 10 GB ditagih $0,07 per GB per bulan, diukur dari puncak setiap jam, dan begitu anggaran tercapai cache menjadi read-only sampai siklus penagihan berikutnya.
Kenapa cache GitHub Actions saya begitu sering dibuang?
Karena semua yang ada di repositori berbagi satu 10 GB: setiap branch, setiap pull request, setiap job matrix, dan setiap OS menyimpan entrinya sendiri, dan cache type=gha milik Docker masuk ke tempat yang sama. Saat simpanan sehari melebihi batas, setiap simpanan menghapus entri yang lebih lama, dan job berikutnya kehilangan entri yang dibutuhkannya. GitHub menyebutnya cache thrashing. Tampilkan entri berdasarkan ukuran (gh cache list --sort size_in_bytes) untuk melihat apa yang memenuhinya.
Kenapa memulihkan cache memakan waktu sama lamanya dengan instalasi dari nol?
Karena cache hit tetap berarti unduhan. Setiap job di runner yang dihosting GitHub dimulai di VM baru, jadi actions/cache mengunduh dan mengekstrak arsipnya setiap kali, dan makin besar cache-nya makin lama prosesnya. Cache setup-node mengembalikan cache unduhan package manager, bukan node_modules, jadi npm ci tetap memasang setiap paket setelah pemulihan. Di runner yang menyimpan disknya, cache sudah ada dan tidak ada yang diunduh.
Kenapa actions/cache meleset di branch baru?
Sebuah run bisa memulihkan cache dari branch-nya sendiri dan dari branch default, dan run pull request juga dari branch base-nya. Run tidak bisa membaca cache branch saudaranya. Jadi run pertama branch fitur hanya hit jika branch default sudah menyimpan key itu. Jalankan workflow pada push ke branch default agar cache tersimpan, dan tambahkan restore-keys untuk kecocokan sebagian; cache-hit bernilai true hanya untuk kecocokan key yang persis.
Berapa banyak cache Actions yang disimpan Skipbox?
Lebih dari 10 GB per repositori milik GitHub, di samping mesin Anda alih-alih di storage GitHub. Di mesin cloud, apa yang disimpan job dengan actions/cache, setup-*, dan rust-cache tetap ada di disk mesin itu sendiri, sampai separuh disk tersebut (80 GB di S, 160 GB di M, 320 GB di L); di host Skipbox, cache host menyimpan 20 GB per repositori. Dengan cara mana pun, entri disimpan 7 hari setelah terakhir dipakai, dengan aturan branch yang sama seperti GitHub. Cache paket dan layer Docker tidak melewatinya: semuanya tetap ada di disk itu sendiri.
Apa yang menghapus cache di mesin Skipbox?
Tidak ada di antara job: cache tetap di mesin, dan hanya saat sebuah job membuat disk hampir penuh, yang paling lama tidak dipakai dibuang lebih dulu. Mesin mulai bersih saat reset: saat Anda menekan Reset mesin, saat image-nya diperbarui (setidaknya sebulan sekali), saat mesin gagal health check setelah sebuah job, dan saat sebuah job mencapai batas 6 jam. Mesin dihapus beserta disknya saat paket berakhir.
Berapa biaya untuk mencobanya?
Gratis. Uji cobanya 7 hari atau 3.000 menit job, mana yang lebih dulu tercapai, tanpa kartu. Pindahkan job yang cache-nya meleset atau lambat dipulihkan ke runs-on: skipbox, jalankan dua kali, lalu bandingkan step pemulihan dan instalasi di run kedua dengan di GitHub.
Diperbarui 19 November 2026