# Cache layer Docker di GitHub Actions: kenapa setiap build dimulai dingin, dan cara menyimpan layer-nya

> Setiap job GitHub Actions dimulai di VM baru tanpa build cache Docker dan tanpa image yang sudah ditarik, dan builder default setup-buildx-action dimulai kosong. cache-to dan cache-from milik buildx (gha, registry, local) mengembalikan layer sebagai unduhan, di dalam 10 GB milik GitHub. Runner yang menyimpan build cache Docker di disknya tidak butuh semua itu, dengan harga tetap $39 per bulan.

Cache layer Docker hilang di setiap run GitHub Actions karena setiap job di runner yang dihosting GitHub dimulai di VM baru: tanpa build cache, tanpa image yang sudah ditarik. Builder default docker/setup-buildx-action (`docker-container`) juga dimulai kosong di setiap job dan dihapus di akhirnya. Perbaikan yang biasa adalah mengekspor cache dengan buildx. `cache-to: type=gha,mode=max` dan `cache-from: type=gha` menyimpan layer di cache Actions GitHub, 10 GB per repositori dan dibagi dengan semua cache lainnya; `type=registry` menyimpannya di registry Anda; `type=local` di direktori yang Anda simpan dengan actions/cache. Masing-masing mengubah build ulang menjadi unggahan dan unduhan di setiap run.

Skipbox menyimpan layer-nya di tempat build berjalan. Job Anda berjalan di mesin khusus untuk akun Anda, yang menyimpan image, layer, dan build cache Docker di antara job, di disk 80 GB di S dibandingkan 14 GB di runner GitHub. `docker build` dan `docker compose build` memakai ulang layer dari build terakhir, dan image yang ditarik compose sudah ada di disk. setup-buildx-action berjalan apa adanya, dan builder-nya juga menemukan layer itu. Ubah satu baris, `runs-on: skipbox`, dengan harga tetap $39 per bulan dan menit tanpa batas.

- GitHub: VM baru per job, jadi tanpa layer, tanpa image, dan builder buildx yang kosong di setiap run
- Skipbox: build cache dan image Docker tetap ada di disk mesin Anda, jadi layer yang tidak berubah tidak di-build ulang atau diunduh
- 20.000 menit per bulan di 4 vCPU: $222 di GitHub, $39 di Skipbox

**GitHub Actions dengan harga tetap, menit tanpa batas** Skipbox menjalankan job GitHub Actions Anda di mesin khusus milik Anda sendiri: $39 per bulan, berapa pun menit yang Anda jalankan. Layer Docker dan cache dependensi tetap tersimpan di antara job, jadi job berikutnya langsung dimulai.

Runner 4 vCPU, 20.000 menit per bulan: GitHub $222 → Skipbox $39. Anda hemat $183 setiap bulan.

Pindah cukup dengan satu baris: `runs-on: skipbox`.

[Mulai uji coba gratis 7 hari](https://app.skipbox.dev/sign-in?ref=g-docker-layer-cache-github-actions-id)

## Kenapa setiap build dimulai dingin

- **VM baru per job.** [Referensi runner](https://docs.github.com/en/actions/reference/runners/github-hosted-runners) GitHub: "each GitHub-hosted runner is a new virtual machine (VM) hosted by GitHub." Tidak ada yang di-build atau ditarik job sebelumnya di sana.
- **Builder yang kosong.** [docker/setup-buildx-action](https://github.com/docker/setup-buildx-action) secara default membuat dan menyalakan builder dengan driver `docker-container`, dan `cleanup`-nya (aktif secara default) menghapus builder itu di akhir job.
- **Disk 14 GB.** `ubuntu-latest` di repositori privat punya 2 CPU, 8 GB, dan SSD 14 GB. Image besar, build cache-nya, dan arsip cache yang harus diekstrak bisa kehabisan ruang ("no space left on device").

## Backend cache buildx, dan biaya masing-masing

Dari [cache backends](https://docs.docker.com/build/cache/backends/) dan [cache management with GitHub Actions](https://docs.docker.com/build/ci/github-actions/cache/) milik Docker:

| Backend | Ke mana layer disimpan | Yang dibayar setiap run | Batas |
|---|---|---|---|
| `type=gha` | Cache Actions GitHub | Mengunggah layer baru, mengunduh yang dibutuhkan | 10 GB per repositori bersama semua cache lain, yang terlama dibuang lebih dulu; scope default `buildkit` ditimpa oleh setiap build; API cache GitHub membatasi laju |
| `type=registry` | Image cache terpisah di registry Anda | Menarik cache dari registry, mem-push yang baru | Login registry dengan hak push; storage dan trafik registry |
| `type=inline` | Di dalam image itu sendiri | Menarik image untuk membaca cache-nya | Hanya `mode=min`: layer dari stage perantara tidak disimpan |
| `type=local` + actions/cache | Direktori yang disimpan dengan actions/cache | Mengunduh dan mengekstrak seluruh direktori, lalu mengunggahnya | Membesar di setiap run kecuali [`reset=true`](https://docs.docker.com/build/cache/backends/local/) (Buildx 0.35.0 dan yang lebih baru); dihitung dalam 10 GB |

Backend apa pun yang Anda pilih, [urutkan Dockerfile](https://docs.docker.com/build/cache/optimize/) agar layer yang paling jarang berubah ada di depan: salin lockfile dan pasang dependensi sebelum Anda menyalin source. Jika tidak, setiap commit membatalkan layer instalasi, dan tidak ada cache yang bisa mengembalikannya.

`mode=min`, yang default, hanya menyimpan layer dari image akhir. `mode=max` menyimpan layer setiap stage, jadi build multi-stage lebih sering hit, dan mengunggah lebih banyak.

Setup `type=gha` yang umum, dengan scope sendiri per image:

```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
```

**Cache mount tidak bertahan.** `RUN --mount=type=cache` (cache package manager di dalam build) tidak disimpan di cache GitHub Actions secara default; dokumentasi Docker merujuk ke [buildkit-cache-dance](https://github.com/reproducible-containers/buildkit-cache-dance) untuk memindahkannya masuk dan keluar dari actions/cache, satu unduhan dan unggahan lagi per run.

## docker compose menarik setiap image, di setiap job

Integration test yang menjalankan Postgres, Redis, dan beberapa service dengan `docker compose up` menarik setiap image di setiap job, karena VM-nya baru. Di runner yang dihosting GitHub, opsi-opsinya hanya memindahkan unduhan:

- `docker save` image ke file tar, cache dengan actions/cache, lalu `docker load` di job berikutnya. Itu dihitung dalam 10 GB, dan pemuatannya memakan waktu tersendiri.
- Build image service dengan buildx dan salah satu backend cache di atas, yang tetap menyisakan image dasar untuk ditarik.

## Saat perbaikannya adalah mesin yang menyimpan cache Docker

Setiap backend di atas ada karena builder-nya lupa. Daemon Docker yang tetap ada di antara job sudah memiliki layer dari build terakhir, cache mount-nya, dan setiap image yang ditariknya, di disknya sendiri. Tidak ada yang perlu diekspor, tidak ada yang perlu diimpor, dan tidak ada 10 GB yang harus dibagi.

## Skipbox menyimpan cache Docker di mesin Anda

Setiap paket datang dengan mesin khusus untuk akun Anda, yang disimpan di antara job:

- **`docker build` dan `docker compose build`** memakai ulang layer dari build terakhir, tanpa perubahan pada workflow.
- **Image tetap ada di disk.** `docker compose up` menemukan image yang ditariknya terakhir kali; `docker compose pull` hanya mengambil layer yang berubah.
- **Cache mount tetap ada** bersama build cache Docker, jadi `RUN --mount=type=cache` menyimpan cache package manager tanpa step tambahan.
- **docker/setup-buildx-action berjalan apa adanya.** Builder-nya mulai dari layer yang ditinggalkan build terakhir repositori Anda di mesin itu, dan Anda bisa membuang `cache-from` dan `cache-to`. Saat kami sendiri menjalankan CI sebuah proyek publik di mesin 4 vCPU (19 November 2026, masing-masing satu kali), step yang mem-build image memakan 177 detik pada run pertama dan 4 detik pada run ulang, dengan 31 step CACHED.
- **Disk:** tidak ada yang dihapus sampai disk hampir penuh setelah sebuah job. Saat itu image dangling dibuang lebih dulu, lalu build cache yang paling lama tidak dipakai.

```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
```

Sebuah job memilih ukurannya lewat label:

| Label | Mesin | Disk | Paket |
|---|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | 80 GB | S, $39 per bulan |
| `skipbox-8x16` | 8 vCPU · 16 GB | 160 GB | M, $79 per bulan |
| `skipbox-16x32` | 16 vCPU · 32 GB | 320 GB | L, $149 per bulan |

Menitnya tanpa batas. Untuk 20.000 menit per bulan di 4 vCPU, GitHub menagih $222; Skipbox S $39, $183 lebih murah.

## Pindah cukup satu baris

1. Masuk ke Skipbox dengan GitHub.
2. Instal aplikasi GitHub Skipbox dan pilih repositorinya.
3. Ubah `runs-on`, lalu push.

Job pertama mem-build setiap layer. Job kedua menemukannya di mesin.

## Keamanan

- Mesinnya hanya milik akun Anda. Tidak ada job perusahaan lain yang berjalan di sana.
- Setelah setiap job, kredensial runner, proses, dan container dihapus, begitu juga `~/.docker/config.json`, jadi login registry tidak terbawa ke job berikutnya. Bersih setiap job memberi setiap job mesin baru sebagai gantinya.
- Kode dari orang tanpa akses tulis (misalnya pull request dari fork) berjalan di mesin baru sekali pakai, tidak pernah di mesin Anda.

Detailnya ada di [cara job diisolasi](https://docs.skipbox.dev/id/isolation).

## Coba di build Docker Anda

Uji cobanya gratis selama 7 hari atau 3.000 menit job, mana yang lebih dulu tercapai, dan tanpa kartu. Pindahkan build Docker Anda ke `runs-on: skipbox`, jalankan dua kali, lalu letakkan step build di run kedua di samping hasil di GitHub.

## FAQ

### Kenapa cache layer Docker hilang di setiap run GitHub Actions?

Karena setiap job di runner yang dihosting GitHub dimulai di VM baru, tanpa build cache dan tanpa image dari run sebelumnya. docker/setup-buildx-action menambahinya: secara default action ini membuat builder docker-container yang dimulai kosong dan dihapus di akhir job. Jadi setiap layer di-build ulang, kecuali Anda mengekspor cache dengan cache-to dan mengimpornya dengan cache-from, atau menjalankan job di mesin yang menyimpan build cache Docker.

### Bagaimana cara meng-cache layer Docker di GitHub Actions?

Di runner yang dihosting GitHub, dengan cache exporter milik buildx: cache-from: type=gha dan cache-to: type=gha,mode=max di docker/build-push-action menyimpan layer di cache Actions GitHub (10 GB per repositori, dibagi dengan semua cache lainnya). type=registry menyimpannya sebagai image terpisah di registry Anda, dan type=local di direktori yang Anda simpan dengan actions/cache. Beri setiap image scope sendiri dengan type=gha, karena scope default-nya ditimpa oleh setiap build. Di mesin yang menyimpan disknya, docker build memakai ulang layer tanpa exporter.

### Kenapa buildx dengan cache-to type=gha masih lambat?

Karena layer-nya tetap harus berpindah. Dengan mode=max, setiap run mengunggah setiap layer baru dari setiap stage, dan run berikutnya mengunduh layer yang dibutuhkannya. Cache-nya berbagi 10 GB per repositori milik GitHub dengan semua yang lain, jadi cache itu dibuang, dan API cache GitHub membatasi laju build yang membuat terlalu banyak permintaan. Builder yang sudah punya layer-nya di disk melewati kedua arah itu.

### Bagaimana agar docker compose tidak menarik image yang sama di setiap job?

Di runner yang dihosting GitHub, itu tidak bisa, hanya bisa memindahkan unduhannya: docker save image ke file tar, cache dengan actions/cache, lalu docker load di job berikutnya. Itu dihitung dalam 10 GB yang sama dan berarti unduhan serta pemuatan di setiap run. Di mesin yang menyimpan disknya, image yang ditarik compose terakhir kali sudah ada, dan docker compose pull hanya mengambil layer yang berubah.

### Apakah saya harus mengubah workflow untuk menyimpan cache Docker di Skipbox?

Hanya runs-on: mesin akun Anda menyimpan image, layer, dan build cache Docker di antara job. docker build dan docker compose build memakainya ulang, dan docker/setup-buildx-action berjalan apa adanya: builder-nya mulai dari layer yang ditinggalkan build terakhir repositori Anda di mesin itu. Anda bisa membuang cache-from dan cache-to.

### Berapa biaya untuk mencobanya?

Gratis. Uji cobanya 7 hari atau 3.000 menit job, mana yang lebih dulu tercapai, tanpa kartu. Pindahkan build Docker Anda ke runs-on: skipbox, jalankan dua kali, lalu bandingkan step build di run kedua dengan di GitHub.

Diperbarui 2026-11-19 · https://skipbox.dev/id/guides/docker-layer-cache-github-actions
