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

> GitHub’ın Actions önbelleği depo başına 10 GB tutar, bu aşılınca en uzun süredir okunmayan girdileri siler ve 7 gün kullanılmayan her girdiyi kaldırır. Bir isabet bile yeni bir VM’e yapılan bir indirmedir. Her çözümün maliyeti ve diskini tutan bir runner’ın önbelleğin çoğunu neden gereksiz kıldığı, ayda sabit $39 karşılığında.

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: depo başına 10 GB, 7 gün kullanılmayan girdiler silinir, her isabet yeniden indirilir
- Skipbox: paket önbellekleri ve Docker katmanları makinenizin diskinde kalır; GitHub’ın önbellek alanının en az 7 katı
- 4 vCPU’da ayda 20.000 dakika: GitHub’da $222, Skipbox’ta $39

**Sabit fiyatla GitHub Actions, sınırsız dakika** Skipbox, GitHub Actions işlerinizi size ayrılmış kendi makinenizde çalıştırır: kaç dakika çalıştırırsanız çalıştırın ayda $39. Docker katmanları ve bağımlılık önbellekleri işler arasında kalır, böylece sonraki iş hemen başlar.

4 vCPU’luk bir runner, ayda 20.000 dakika: GitHub $222 → Skipbox $39. Her ay $183 tasarruf edersiniz.

Geçiş tek satır: `runs-on: skipbox`.

[7 günlük ücretsiz denememi başlat](https://app.skipbox.dev/sign-in?ref=g-github-actions-cache-size-limit-tr)

## GitHub’ın önbellek kuralları

GitHub’ın [bağımlılık önbelleği başvuru belgesinden](https://docs.github.com/en/actions/reference/workflows-and-actions/dependency-caching), [Actions faturalandırmasından](https://docs.github.com/en/billing/concepts/product-billing/github-actions) ve [10 GB’ı aşan önbellekler](https://github.blog/changelog/2025-11-20-github-actions-cache-size-can-now-exceed-10-gb-per-repository/) hakkındaki değişiklik günlüğünden:

| Kural | GitHub ne yapar |
|---|---|
| Boyut | Varsayılan olarak depo başına 10 GB, her dal ve iş akışı tarafından paylaşılır |
| Boyut aşılınca | Yeni girdiyi kaydeder, sonra depo sınırın altına inene kadar girdileri son erişime göre, en eskiden başlayarak siler. Silme her saat çalışır |
| Kullanılmayan girdiler | 7 günden uzun süredir okunmayan her girdiyi siler |
| Daha büyük bir sınır | Pro, Team veya Enterprise hesabında yöneticiler boyutu ve gün sayısını artırabilir. 10 GB’ın üstü, her saatin en yüksek değerine göre ayda GB başına $0,07. Ulaşılan bir bütçe önbelleği bir sonraki faturalandırma dönemine kadar salt okunur yapar |
| Dallar | 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ükler. Kardeş ya da alt dalınkileri asla |
| Pull request’ler | Bir pull request’in önbellekleri onun merge ref’ine bağlıdır: yalnızca o pull request’in yeniden çalıştırmaları okur |
| Girdiler | Değiştirilemez. Zaten var olan bir anahtar yeniden kaydedilmez |
| İsabetler | `cache-hit` yalnızca `key` ile tam eşleşmede `true` olur; bir `restore-keys` eşleşmesi `false` verir |
| Hız | Depo başına dakikada en fazla 200 yükleme ve 1.500 indirme |

## Ö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:

```bash
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](https://github.com/actions/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](https://skipbox.dev/tr/guides/rust-cache-slow-rust-ci) 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](https://skipbox.dev/tr/guides/docker-layer-cache-github-actions)).
- **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:

| Etiket | Makine | Disk | Plan |
|---|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | 80 GB | S, ayda $39 |
| `skipbox-8x16` | 8 vCPU · 16 GB | 160 GB | M, ayda $79 |
| `skipbox-16x32` | 16 vCPU · 32 GB | 320 GB | L, ayda $149 |

Ö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

```yaml
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](https://docs.skipbox.dev/tr/isolation) 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: 2026-11-19 · https://skipbox.dev/tr/guides/github-actions-cache-size-limit
