Skipbox

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:

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-keys memberi padanan separa, dan cache-hit kemudian membaca false.
  • 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 ~/.npm atau stor pnpm dalam cache, bukan node_modules atau output build. Simpan hanya pada cabang lalai, dengan actions/cache/restore dalam setiap job dan actions/cache/save dalam 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, ~/.cache setiap alat, dan cache Go, Gradle, Cargo dan Maven, dengan alat yang dipasang oleh setup-*. Tiada apa-apa untuk dipulihkan.
  • Imej, lapisan dan cache build Docker juga kekal. docker build menggunakan 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:

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
  1. Log masuk ke Skipbox dengan GitHub.
  2. Pasang GitHub App Skipbox dan pilih repositori.
  3. Tukar runs-on dan 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

CI/CD lebih pantas dengan cache yang sentiasa sedia

Runner anda yang sentiasa sedia pada harga tetap

Kami yang hoskan. Anda tukar satu baris. 1/12 daripada kos GitHub pada penggunaan penuh. Harga tetap, jadi jalankan sepanjang hari. 7× ruang cache GitHub.

  • Tanpa kad
  • Log masuk dengan GitHub
  • Batal bila-bila masa