# GitHub Actions’ta Docker katman önbelleği: her derleme neden soğuk başlar ve katmanlar nasıl tutulur

> Her GitHub Actions işi Docker derleme önbelleği ve çekilmiş imaj olmadan yeni bir VM’de başlar; setup-buildx-action’ın varsayılan builder’ı da boş başlar. buildx’in cache-to ve cache-from seçenekleri (gha, registry, local) katmanları GitHub’ın 10 GB’ı içinde indirme olarak geri getirir. Docker’ın derleme önbelleğini diskinde tutan bir runner’ın bunların hiçbirine ihtiyacı yoktur, ayda sabit $39 karşılığında.

Docker’ın katman önbelleği her GitHub Actions çalıştırmasında kaybolur, çünkü GitHub’ın barındırdığı runner’daki her iş yeni bir VM’de başlar: derleme önbelleği yok, çekilmiş imaj yok. docker/setup-buildx-action’ın varsayılan builder’ı (`docker-container`) da her işte boş başlar ve işin sonunda kaldırılır. Bilinen çözüm, önbelleği buildx ile dışa aktarmaktır. `cache-to: type=gha,mode=max` ve `cache-from: type=gha` katmanları GitHub’ın Actions önbelleğinde, depo başına 10 GB içinde ve diğer tüm önbelleklerle paylaşarak tutar; `type=registry` onları kayıt deponuzda, `type=local` ise actions/cache ile kaydettiğiniz bir dizinde tutar. Her biri, her çalıştırmada bir yeniden derlemeyi bir yükleme ve bir indirmeye çevirir.

Skipbox katmanları derlemenin çalıştığı yerde tutar. İşleriniz Skipbox’ın yalnızca hesabınız için barındırdığı makinede çalışır; makine Docker’ın imajlarını, katmanlarını ve derleme önbelleğini işler arasında, S’de 80 GB’lık bir diskte tutar (GitHub’ın runner’ında 14 GB). `docker build` ve `docker compose build` son derlemenin katmanlarını yeniden kullanır ve compose’un çektiği imajlar zaten diskte olur. setup-buildx-action olduğu gibi çalışır ve builder’ı da bu katmanları bulur. 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: her iş için yeni bir VM; yani her çalıştırmada katman yok, imaj yok ve boş bir buildx builder’ı
- Skipbox: Docker’ın derleme önbelleği ve imajları makinenizin diskinde kalır; değişmeyen katmanlar yeniden derlenmez ya da indirilmez
- 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-docker-layer-cache-github-actions-tr)

## Her derleme neden soğuk başlar

- **İş başına yeni bir VM.** GitHub’ın [runner başvuru belgesine](https://docs.github.com/en/actions/reference/runners/github-hosted-runners) göre GitHub’ın barındırdığı her runner, GitHub’ın barındırdığı yeni bir sanal makinedir (VM). Son işin derlediği ya da çektiği hiçbir şey onda yoktur.
- **Boş bir builder.** [docker/setup-buildx-action](https://github.com/docker/setup-buildx-action) varsayılan olarak `docker-container` sürücüsüyle bir builder oluşturup başlatır ve `cleanup` ayarı (varsayılan olarak açık) builder’ı işin sonunda kaldırır.
- **14 GB disk.** Özel bir deponun `ubuntu-latest` runner’ında 2 CPU, 8 GB ve 14 GB SSD vardır. Büyük bir imaj, onun derleme önbelleği ve açılacak bir önbellek arşivi alanı tüketebilir ("no space left on device").

## buildx önbellek arka uçları ve her birinin maliyeti

Docker’ın [önbellek arka uçları](https://docs.docker.com/build/cache/backends/) ve [GitHub Actions ile önbellek yönetimi](https://docs.docker.com/build/ci/github-actions/cache/) belgelerinden:

| Arka uç | Katmanların gittiği yer | Her çalıştırmanın ödediği | Sınırlar |
|---|---|---|---|
| `type=gha` | GitHub’ın Actions önbelleği | Yeni katmanları yükler, ihtiyaç duyduklarını indirir | Diğer tüm önbelleklerle birlikte depo başına 10 GB, en eskiden başlayarak silinir; varsayılan scope `buildkit` her derlemede üzerine yazılır; GitHub’ın önbellek API’si hız sınırı uygular |
| `type=registry` | Kayıt deponuzda ayrı bir önbellek imajı | Önbelleği kayıt deposundan çeker, yenisini push eder | Push yetkili bir kayıt deposu girişi; kayıt deposunun depolaması ve trafiği |
| `type=inline` | İmajın kendi içinde | Önbelleğini okumak için imajı çeker | Yalnızca `mode=min`: ara aşamaların katmanları tutulmaz |
| `type=local` + actions/cache | actions/cache ile kaydedilen bir dizin | Tüm dizini indirip açar, sonra yükler | [`reset=true`](https://docs.docker.com/build/cache/backends/local/) olmadıkça her çalıştırmada büyür (Buildx 0.35.0 ve sonrası); 10 GB’a sayılır |

Hangi arka ucu seçerseniz seçin, en az değişen katmanlar önce gelsin diye [Dockerfile’ı sıralayın](https://docs.docker.com/build/cache/optimize/): kaynağı kopyalamadan önce kilit dosyasını kopyalayın ve bağımlılıkları kurun. Aksi halde her commit kurulum katmanını geçersiz kılar ve hiçbir önbellek onu geri getiremez.

Varsayılan olan `mode=min` yalnızca son imajın katmanlarını tutar. `mode=max` her aşamanın katmanlarını tutar; çok aşamalı bir derleme daha çok isabet eder ve daha çok yükler.

Her imaj için kendi scope’uyla tipik bir `type=gha` kurulumu:

```yaml
- uses: docker/setup-buildx-action@v4
- uses: docker/build-push-action@v7
  with:
    context: .
    tags: app:ci
    load: true
    cache-from: type=gha,scope=app
    cache-to: type=gha,scope=app,mode=max
```

**Önbellek bağlamaları (cache mount) korunmaz.** `RUN --mount=type=cache` (derleme içindeki bir paket yöneticisi önbelleği) varsayılan olarak GitHub Actions önbelleğinde tutulmaz; Docker’ın belgeleri onu actions/cache’e taşıyıp geri almak için [buildkit-cache-dance](https://github.com/reproducible-containers/buildkit-cache-dance) önerir; bu da her çalıştırmada bir indirme ve bir yükleme daha demektir.

## docker compose her işte her imajı çeker

Postgres, Redis ve birkaç servisi `docker compose up` ile başlatan entegrasyon testleri, VM yeni olduğu için her işte her imajı çeker. GitHub’ın barındırdığı runner’larda seçenekler yalnızca indirmeyi taşır:

- İmajları `docker save` ile bir tar dosyasına kaydedin, actions/cache ile önbelleğe alın ve bir sonraki işte `docker load` ile yükleyin. Bu 10 GB’a sayılır ve yükleme de kendi süresini alır.
- Servis imajlarını buildx ve yukarıdaki bir önbellek arka ucuyla derleyin; temel imajlar yine de çekilmek zorundadır.

## Çözüm Docker’ın önbelleğini tutan bir makine olduğunda

Yukarıdaki her arka uç, builder unuttuğu için vardır. İşler arasında kalan bir Docker daemon’ı, son derlemenin katmanlarına, önbellek bağlamalarına ve çektiği her imaja kendi diskinde zaten sahiptir. Dışa aktarılacak bir şey, içe aktarılacak bir şey ve paylaşılacak 10 GB yoktur.

## Skipbox Docker’ın önbelleğini makinenizde tutar

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

- **`docker build` ve `docker compose build`** son derlemenin katmanlarını, iş akışında değişiklik olmadan yeniden kullanır.
- **İmajlar diskte kalır.** `docker compose up` son çektiği imajları bulur; `docker compose pull` yalnızca değişen katmanları getirir.
- **Önbellek bağlamaları** Docker’ın derleme önbelleğiyle birlikte kalır; `RUN --mount=type=cache` paket yöneticisinin önbelleğini ek bir adım olmadan tutar.
- **docker/setup-buildx-action olduğu gibi çalışır.** Builder’ı, deponuzun bu makinedeki son derlemesinin bıraktığı katmanlarla başlar ve `cache-from` ile `cache-to` satırlarını kaldırabilirsiniz. Herkese açık bir projenin CI’ını 4 vCPU’lu bir makinede kendimiz çalıştırdığımızda (19 Kasım 2026, birer çalıştırma), imajı derleyen adım ilk çalıştırmada 177 sn, yeniden çalıştırmada 4 sn sürdü; 31 adım CACHED oldu.
- **Disk:** bir işten sonra disk neredeyse dolana kadar hiçbir şey silinmez. Sonra önce sahipsiz (dangling) imajlar, ardından en uzun süredir kullanılmayan derleme önbelleği gider.

```yaml
jobs:
  build:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: docker/setup-buildx-action@v4
      - uses: docker/build-push-action@v7
        with:
          context: .
          tags: app:ci
          load: true
```

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 |

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

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.

İlk iş her katmanı derler. İkincisi onları 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; `~/.docker/config.json` da, böylece bir kayıt deposu girişi bir sonraki işe taşınmaz. 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) asla sizinkinde değil, yeni, tek kullanımlık bir makinede çalışır.

Ayrıntılar [işler nasıl yalıtılır](https://docs.skipbox.dev/tr/isolation) sayfasında.

## Docker derlemenizde deneyin

Deneme 7 gün ya da 3.000 iş dakikası boyunca, hangisi önce dolarsa, ücretsizdir ve kart istemez. Docker derlemenizi `runs-on: skipbox` satırına taşıyın, iki kez çalıştırın ve ikinci çalıştırmanın derleme adımını GitHub’dakinin yanına koyun.

## SSS

### Docker katman önbelleği her GitHub Actions çalıştırmasında neden kayboluyor?

Çünkü GitHub’ın barındırdığı runner’daki her iş, son çalıştırmanın derleme önbelleği ve imajları olmadan yeni bir VM’de başlar. docker/setup-buildx-action buna bir de kendisi ekler: varsayılan olarak boş başlayan ve işin sonunda kaldırılan bir docker-container builder’ı oluşturur. Yani önbelleği cache-to ile dışa aktarıp cache-from ile içe aktarmadıkça ya da Docker’ın derleme önbelleğini tutan bir makinede çalıştırmadıkça her katman yeniden derlenir.

### GitHub Actions’ta Docker katmanlarını nasıl önbelleğe alırım?

GitHub’ın barındırdığı runner’larda buildx’in önbellek dışa aktarıcılarıyla: docker/build-push-action’daki cache-from: type=gha ve cache-to: type=gha,mode=max katmanları GitHub’ın Actions önbelleğinde saklar (depo başına 10 GB, diğer tüm önbelleklerle paylaşılır). type=registry onları kayıt deponuzda ayrı bir imaj olarak, type=local ise actions/cache ile kaydettiğiniz bir dizinde saklar. type=gha ile her imaja kendi scope’unu verin, çünkü varsayılan scope her derlemede üzerine yazılır. Diskini tutan bir makinede docker build katmanları dışa aktarıcı olmadan yeniden kullanır.

### cache-to type=gha ile buildx neden hâlâ yavaş?

Çünkü katmanlar yine yol alır. mode=max ile her çalıştırma her aşamanın her yeni katmanını yükler, sonraki bir çalıştırma da ihtiyaç duyduğu katmanları indirir. Önbellek depo başına GitHub’ın 10 GB’ını diğer her şeyle paylaşır; bu yüzden silinir ve GitHub’ın önbellek API’si çok fazla istek yapan bir derlemeyi hız sınırına takar. Katmanlar zaten diskindeyken çalışan bir builder iki yönü de atlar.

### docker compose’un her işte aynı imajları çekmesini nasıl durdururum?

GitHub’ın barındırdığı bir runner’da durduramazsınız, yalnızca indirmeyi taşıyabilirsiniz: imajları docker save ile bir tar dosyasına kaydedin, actions/cache ile önbelleğe alın ve bir sonraki işte docker load ile yükleyin. Bu aynı 10 GB’a sayılır ve her çalıştırmada bir indirme ve bir yüklemedir. Diskini tutan bir makinede compose’un son çektiği imajlar zaten oradadır ve docker compose pull yalnızca değişen katmanları getirir.

### Skipbox’ta Docker’ın önbelleğini tutmak için iş akışımı değiştirmem gerekir mi?

Yalnızca runs-on: hesabınıza ayrılmış makine Docker’ın imajlarını, katmanlarını ve derleme önbelleğini işler arasında tutar. docker build ve docker compose build bunları yeniden kullanır, docker/setup-buildx-action da olduğu gibi çalışır: builder’ı, deponuzun bu makinedeki son derlemesinin bıraktığı katmanlarla başlar. cache-from ile cache-to satırlarını kaldırabilirsiniz.

### Denemenin maliyeti nedir?

Hiçbir şey. Deneme 7 gün ya da 3.000 iş dakikası sürer, hangisi önce dolarsa, ve kart istemez. Docker derlemenizi runs-on: skipbox satırına taşıyın, iki kez çalıştırın ve ikinci çalıştırmanın derleme adımını GitHub’dakiyle karşılaştırın.

Güncellendi: 2026-11-19 · https://skipbox.dev/tr/guides/docker-layer-cache-github-actions
