Skipbox

GitHub Actions önbellek boyutu sınırı: önbelleğiniz neden silinir, yavaş geri yüklenir ya da ıskalar

GitHub Actions her depoya 10 GB önbellek verir. Depo bunu aştığında GitHub yeni girdiyi yine kaydeder ve sınırın altına inene kadar en uzun süredir okunmayan girdileri siler; 7 gün boyunca hiçbir işin okumadığı her girdiyi de siler. Bir dal yalnızca kendi önbelleklerini ve varsayılan dalınkileri okur; bu yüzden yeni bir dalın ilk çalıştırması çoğu zaman ıskalar. Bir isabet de yine bir indirmedir: GitHub’ın barındırdığı runner’daki her iş yeni bir VM’de başlar ve arşivi yeniden indirip açar. Sınırı 10 GB’ın üstü için ayda GB başına $0,07 karşılığında artırabilir ve anahtarlarınızı ayarlayabilirsiniz, ama indirme kalır.

Skipbox indirmeyi ortadan kaldırır. İşleriniz hesabınıza ayrılmış ve işler arasında kalan makinede çalışır; npm, pnpm, Gradle, Go ve Cargo önbellekleri ve Docker katmanları son işten diskinde durur (S’de 80 GB, GitHub’ın runner’ında 14 GB). actions/cache’in kaydettikleri makinenin yanında kalır; geri yükleme yerel bir okumadır. Tek bir satırı, runs-on: skipbox satırını değiştirin; ayda sabit $39 karşılığında sınırsız dakika.

GitHub’ın önbellek kuralları

GitHub’ın bağımlılık önbelleği başvuru belgesinden, Actions faturalandırmasından ve 10 GB’ı aşan önbellekler hakkındaki değişiklik günlüğünden:

Önbellek neden silinir

Deponun kaydettiği her şeyi tek bir 10 GB tutar. Her dal ve her pull request kendi girdilerini kaydeder. İki işletim sisteminde üç Node sürümünden oluşan bir matris altı girdi kaydeder. Docker’ın type=gha derleme önbelleği de aynı 10 GB’a düşer. Bir günün kayıtları sınırı aştığında her yeni kayıt daha eski bir girdiyi, çoğu zaman bir sonraki işin ihtiyaç duyduğunu siler. GitHub buna cache thrashing der.

Neyin doldurduğunu görmek için girdileri boyuta göre listeleyin:

gh cache list --sort size_in_bytes --limit 20

Deponun Actions › Caches sayfası da her girdinin dalı ve son kullanımıyla aynısını gösterir.

Geri yükleme neden yavaş

GitHub’ın barındırdığı runner’da bir önbellek isabeti, yeni bir VM’e yapılan bir indirme ve ardından bir açmadır. Süresi arşivle birlikte büyür; birkaç GB’a ulaşmış bir önbellek, atlamak için var olduğu kurulum kadar sürebilir. Takılan bir indirme, actions/cache’in varsayılan olarak 10 dakikalık segment zaman aşımıyla (SEGMENT_DOWNLOAD_TIMEOUT_MINS) kesilir.

Çoğu kurulum, sanıldığından daha azını da geri yükler. setup-node’un cache: girdisi node_modules’u değil, paket yöneticisinin indirme önbelleğini kaydeder: geri yüklemeden sonra npm ci yine her paketi kurar. setup-python’ın pip önbelleği de aynıdır: indirmeler geri gelir, ortam yeniden kurulur.

Önbellek neden ıskalar

  • Anahtar değişti. hashFiles('**/package-lock.json') içeren bir anahtar, kilit dosyasındaki her değişiklikte ıskalar. restore-keys kısmi bir eşleşme verir ve cache-hit o zaman false okunur.
  • Yeni bir dal. Varsayılan dalın önbelleklerini okuyabilir, başka bir özellik dalınınkileri okuyamaz. Varsayılan dal iş akışını hiç çalıştırmadıysa okunacak bir şey yoktur.
  • Silindi. Sınır ya da 7 gün onu götürdü.
  • Hiç kaydedilmedi. Girdiler değiştirilemez; var olan bir anahtar asla yeniden kaydedilmez ve önbellekteki içerik ilk kaydı kadar eski kalır. Fork’tan gelen bir pull request’in kaydetmesine hiç izin verilmeyebilir.

Dosyaları aynı çalıştırmanın bir sonraki işine aktarmak başka bir araçtır. Önbellek bir sonraki çalıştırma içindir; aynı iş akışının sonraki bir işinin ihtiyaç duyduğu derleme çıktısı actions/upload-artifact ve actions/download-artifact ile gider. Artifact’lerin 10 GB’tan ayrı kendi depolaması vardır ve onlar da yeni bir VM’e yapılan bir indirmedir.

GitHub’ın runner’larında her çözümün maliyeti

  • Sınırı artırın. Daha az silme; 10 GB’ın üstü için ayda GB başına $0,07 (GitHub’ın kendi örneği: tamamen kullanılan 200 GB ayda $13,30), Pro, Team veya Enterprise hesabında. Geri yüklemeler indirme olarak kalır ve daha büyük önbelleklerin indirilmesi daha uzun sürer.
  • Daha azını kaydedin. node_modules’u veya derleme çıktısını değil, ~/.npm’i ya da pnpm deposunu önbelleğe alın. Yalnızca varsayılan dalda kaydedin; her işte actions/cache/restore, tek bir işte actions/cache/save. Zamanınıza mal olur ve daha küçük bir önbellek daha azını geri yükler.
  • Anahtarları düzeltin. Kilit dosyasına göre anahtarlayın, restore-keys ekleyin ve yeni dalların okuyacak bir şeyi olsun diye iş akışını varsayılan dala yapılan push’larda çalıştırın.
  • Diskini tutan self-hosted bir runner. İndirme yok, 10 GB yok. Makineyi siz işletirsiniz: işletim sistemi güncellemeleri, önbellekleri silmeden işler arasında temizlik ve bozulduğunda onarım.

Çözüm diskini tutan bir makine olduğunda

Önbellek, makine unuttuğu için vardır. GitHub’ın barındırdığı runner her iş için yeni bir VM’dir; iş durumunu GitHub’ın depolamasına kaydeder ve bir dahaki sefere geri getirir. Kalan bir makinede o durum zaten diskindedir: paket yöneticisinin önbelleği, araç önbelleği, Docker’ın imajları ve derleme önbelleği, hatta derleme çıktısı.

Fark, gerçek projelerin CI’ında, onların kendi işlerini bizim çalıştırmamızdan görülür:

  • astro (Node.js, Turborepo): GitHub’da 528 sn, turbo önbelleğini tutan size ayrılmış bir Skipbox makinesinde 30 sn; hazır çalıştırmaları 40 derleme görevini çalıştırmak yerine yeniden oynatır.
  • helix (Rust): araç zinciri ve önbellek adımı size ayrılmış makinede 9-10 sn sürdü, GitHub’da 41-46 sn.
  • tauri (Rust): GitHub’da 246 sn, target/ işler arasında tutulan size ayrılmış makinede 53 sn.

Skipbox önbelleği makinenizde tutar

Her plan, hesabınıza ayrılmış ve işler arasında kalan bir makineyle gelir:

  • Paket önbellekleri diskte kalır: ~/.npm, pnpm deposu, her aracın ~/.cache dizini ve Go, Gradle, Cargo ve Maven önbellekleri, setup-*’ın kurduğu araçlarla birlikte. Geri yüklenecek bir şey yok.
  • Docker’ın imajları, katmanları ve derleme önbelleği de kalır. docker build son derlemenin katmanlarını yeniden kullanır (Docker katman önbelleği).
  • **actions/cache, setup-* ve rust-cache değişiklik gerektirmez.** Kaydettikleri GitHub’ın depolamasında değil, makinenin yanında, GitHub’ın depo başına 10 GB’ından daha geniş bir alanda kalır ve geri yükleme onu yerelden okur.
  • Diskte 7 günlük silinme yok. Bir işten sonra disk neredeyse dolana kadar hiçbir şey silinmez; o zaman en uzun süredir kullanılmayan önce gider.

S’de GitHub’ın önbellek alanının en az 7 katı. Bir iş boyutunu etiketle seçer:

Özel bir deponun ubuntu-latest runner’ında 2 CPU, 8 GB ve 14 GB SSD vardır. Skipbox’ta dakikalar sınırsızdır. 4 vCPU’da ayda 20.000 dakikada GitHub $222 faturalandırır; Skipbox S ise $39, yani $183 daha az.

Geçiş tek satır

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. GitHub ile Skipbox’a giriş yapın.
  2. Skipbox GitHub App’i yükleyin ve depoları seçin.
  3. runs-on satırını değiştirin ve push edin.

Önbellek adımlarınızı olduğu gibi bırakın. İkinci çalıştırma, ilk çalıştırmanın önbelleklerini makinede bulur.

Güvenlik

  • Makine yalnızca hesabınıza aittir. Başka hiçbir şirketin işleri onda çalışmaz.
  • Her işten sonra runner’ın kimlik bilgileri, süreçleri ve container’ları silinir. Her iş için temiz VM ayarı bunun yerine her işe yeni bir makine verir.
  • Yazma erişimi olmayan kişilerin kodu (örneğin fork’lardan gelen pull request’ler), önbelleklerinizi okuyan ama değiştiremeyen yeni bir VM’de çalışır.

Ayrıntılar işler nasıl yalıtılır sayfasında.

Önbelleği ıskalayan işte deneyin

Deneme 7 gün ya da 3.000 iş dakikası boyunca, hangisi önce dolarsa, ücretsizdir ve kart istemez. O işi runs-on: skipbox satırına taşıyın, iki kez çalıştırın ve ikinci çalıştırmanın geri yükleme ve kurulum adımlarını GitHub’dakilerin yanına koyun.

SSS

GitHub Actions önbellek boyutu sınırı nedir?

Varsayılan olarak depo başına 10 GB; tüm dallar ve iş akışları için toplam. Aşıldığında GitHub yeni girdiyi yine kaydeder ve depo yeniden sınırın altına inene kadar girdileri son erişime göre, en eskiden başlayarak siler. 7 gün boyunca hiçbir işin okumadığı girdiler boyuttan bağımsız silinir. Pro, Team veya Enterprise hesabında yöneticiler sınırı ve gün sayısını artırabilir; 10 GB’ı aşan depolama, her saatin en yüksek değeriyle ölçülerek ayda GB başına $0,07 faturalandırılır ve bir bütçeye ulaşıldığında önbellek bir sonraki faturalandırma dönemine kadar salt okunur olur.

GitHub Actions önbelleğim neden bu kadar sık siliniyor?

Çünkü depodaki her şey tek bir 10 GB’ı paylaşır: her dal, her pull request, her matris işi ve her işletim sistemi kendi girdilerini kaydeder ve Docker’ın type=gha önbelleği de aynı yere düşer. Bir günün kayıtları sınırı aştığında her kayıt daha eski bir girdiyi siler ve bir sonraki iş ihtiyaç duyduğunu ıskalar. GitHub buna cache thrashing der. Neyin doldurduğunu görmek için girdileri boyuta göre listeleyin (gh cache list --sort size_in_bytes).

Önbelleği geri yüklemek neden sıfırdan kurmak kadar uzun sürüyor?

Çünkü bir isabet yine de bir indirmedir. GitHub’ın barındırdığı runner’daki her iş yeni bir VM’de başlar; actions/cache arşivi her seferinde indirip açar ve önbellek büyüdükçe bu uzar. setup-node’un önbelleği node_modules’u değil, paket yöneticisinin indirme önbelleğini geri getirir; yani geri yüklemeden sonra npm ci yine her paketi kurar. Diskini tutan bir runner’da önbellekler zaten oradadır ve hiçbir şey indirilmez.

actions/cache yeni bir dalda neden ıskalıyor?

Bir çalıştırma kendi dalının ve varsayılan dalın önbelleklerini, bir pull request’in çalıştırması ayrıca hedef dalınınkileri geri yükleyebilir. Kardeş bir dalın önbelleklerini okuyamaz. Yani bir özellik dalının ilk çalıştırması yalnızca varsayılan dal o anahtarı kaydetmişse isabet eder. Kaydetmesi için iş akışını varsayılan dala yapılan push’larda çalıştırın ve kısmi eşleşme için restore-keys ekleyin; cache-hit yalnızca key ile tam eşleşmede true olur.

Skipbox ne kadar Actions önbelleği tutar?

GitHub’ın depo başına 10 GB’ından fazlasını, GitHub’ın depolamasında değil makinenizin yanında. Bir bulut makinesinde işlerin actions/cache, setup-* ve rust-cache ile kaydettikleri makinenin kendi diskinde, o diskin yarısına kadar kalır (S’de 80 GB, M’de 160 GB, L’de 320 GB); bir Skipbox sunucusunda sunucunun önbelleği depo başına 20 GB tutar. Her iki durumda da bir girdi son kullanımından sonra 7 gün, GitHub’ın dal kurallarıyla tutulur. Paket önbellekleri ve Docker katmanları bundan geçmez: doğrudan diskte kalırlar.

Bir Skipbox makinesindeki önbellekleri ne temizler?

İşler arasında hiçbir şey: önbellekler makinede kalır ve yalnızca bir iş diski neredeyse dolu bıraktığında en uzun süredir kullanılmayan önce gider. Makine bir sıfırlamada temiz başlar: Makineyi sıfırla düğmesine bastığınızda, imajı güncellendiğinde (en az ayda bir), bir işten sonra sağlık kontrolünü geçemediğinde ve bir iş 6 saatlik sınıra ulaştığında. Plan sona erdiğinde makine diskiyle birlikte silinir.

Denemenin maliyeti nedir?

Hiçbir şey. Deneme 7 gün ya da 3.000 iş dakikası sürer, hangisi önce dolarsa, ve kart istemez. Önbelleği ıskalayan ya da yavaş geri yüklenen işi runs-on: skipbox satırına taşıyın, iki kez çalıştırın ve ikinci çalıştırmanın geri yükleme ve kurulum adımlarını GitHub’dakilerle karşılaştırın.

Güncellendi: 19 Kasım 2026

Her zaman hazır önbellekle daha hızlı CI/CD

Sabit fiyatla hazır bekleyen runner’ınız

Biz barındırırız. Siz tek satır değiştirirsiniz. Tam kullanımda maliyet GitHub’ın 1/12 kadarı. Fiyat sabit, yani gün boyu çalıştırın. GitHub’ın 7 katı önbellek alanı.

  • Kart gerekmez
  • GitHub ile giriş
  • İstediğiniz zaman iptal edin