Skipbox

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

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.

Kenapa setiap build dimulai dingin

  • VM baru per job. Referensi runner 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 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 dan cache management with GitHub Actions milik Docker:

Backend apa pun yang Anda pilih, urutkan Dockerfile 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:

- 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 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.
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:

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.

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 19 November 2026

CI/CD lebih cepat dengan cache yang selalu hangat

Runner hangat Anda dengan harga tetap

Kami yang meng-hosting. Anda mengubah satu baris. 1/12 biaya GitHub saat dipakai penuh. Harga tetap, jadi bisa jalan seharian. Ruang cache 7× GitHub.

  • Tanpa kartu
  • Masuk dengan GitHub
  • Batalkan kapan saja