GitHub Actions’ta Docker katman önbelleği: her derleme neden soğuk başlar ve katmanlar nasıl tutulur
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.
Her derleme neden soğuk başlar
- İş başına yeni bir VM. GitHub’ın runner başvuru belgesine 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 varsayılan olarak
docker-containersürücüsüyle bir builder oluşturup başlatır vecleanupayarı (varsayılan olarak açık) builder’ı işin sonunda kaldırır. - 14 GB disk. Özel bir deponun
ubuntu-latestrunner’ı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ı ve GitHub Actions ile önbellek yönetimi 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 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: 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:
- 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 ö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 saveile bir tar dosyasına kaydedin, actions/cache ile önbelleğe alın ve bir sonraki iştedocker loadile 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 buildvedocker compose buildson derlemenin katmanlarını, iş akışında değişiklik olmadan yeniden kullanır.- İmajlar diskte kalır.
docker compose upson çektiği imajları bulur;docker compose pullyalnızca değişen katmanları getirir. - Önbellek bağlamaları Docker’ın derleme önbelleğiyle birlikte kalır;
RUN --mount=type=cachepaket 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-fromilecache-tosatı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.
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
- GitHub ile Skipbox’a giriş yapın.
- Skipbox GitHub App’i yükleyin ve depoları seçin.
runs-onsatı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.jsonda, 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 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: 19 Kasım 2026