# Cache lapisan Docker dalam GitHub Actions: kenapa setiap build bermula sejuk, dan cara mengekalkan lapisan

> Setiap job GitHub Actions bermula pada VM baharu tanpa cache build Docker dan tanpa imej yang ditarik, dan builder lalai setup-buildx-action bermula kosong. cache-to dan cache-from buildx (gha, registry, local) mengembalikan lapisan sebagai muat turun, di dalam 10 GB GitHub. Runner yang mengekalkan cache build Docker pada cakeranya tidak memerlukan semua itu, pada harga tetap $39 sebulan.

Cache lapisan Docker hilang pada setiap larian GitHub Actions kerana setiap job pada runner yang dihoskan GitHub bermula pada VM baharu: tiada cache build, tiada imej yang ditarik. Builder lalai docker/setup-buildx-action (`docker-container`) juga bermula kosong dalam setiap job dan dibuang pada akhirnya. Pembetulan biasa ialah mengeksport cache dengan buildx. `cache-to: type=gha,mode=max` dan `cache-from: type=gha` menyimpan lapisan dalam cache Actions GitHub, 10 GB bagi setiap repositori dan dikongsi dengan setiap cache lain; `type=registry` menyimpannya dalam registry anda; `type=local` dalam direktori yang anda simpan dengan actions/cache. Setiap satu menukar pembinaan semula kepada muat naik dan muat turun pada setiap larian.

Skipbox mengekalkan lapisan di tempat build berjalan. Job anda berjalan pada mesin khusus akaun anda, yang mengekalkan imej, lapisan dan cache build Docker antara job, pada cakera 80 GB pada S berbanding 14 GB pada runner GitHub. `docker build` dan `docker compose build` menggunakan semula lapisan build sebelumnya, dan imej yang ditarik compose sudah ada pada cakera. setup-buildx-action berfungsi seadanya, dan builder-nya turut menemui lapisan itu. Tukar satu baris, `runs-on: skipbox`, pada harga tetap $39 sebulan dengan minit tanpa had.

- GitHub: VM baharu bagi setiap job, jadi tiada lapisan, tiada imej, dan builder buildx kosong pada setiap larian
- Skipbox: cache build dan imej Docker kekal pada cakera mesin anda, jadi lapisan yang tidak berubah tidak dibina semula atau dimuat turun
- 20,000 minit sebulan pada 4 vCPU: $222 di GitHub, $39 di Skipbox

**GitHub Actions pada harga tetap, minit tanpa had** Skipbox menjalankan job GitHub Actions anda pada mesin khusus anda sendiri: $39 sebulan, berapa minit pun anda jalankan. Lapisan Docker dan cache dependency kekal antara job, jadi job seterusnya bermula serta-merta.

Runner 4 vCPU, 20,000 minit sebulan: GitHub $222 → Skipbox $39. Anda jimat $183 setiap bulan.

Beralih hanya memerlukan satu baris: `runs-on: skipbox`.

[Mulakan percubaan percuma 7 hari saya](https://app.skipbox.dev/sign-in?ref=g-docker-layer-cache-github-actions-ms)

## Kenapa setiap build bermula sejuk

- **VM baharu bagi setiap job.** [Rujukan 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." Tiada apa-apa yang dibina atau ditarik job sebelumnya ada padanya.
- **Builder kosong.** [docker/setup-buildx-action](https://github.com/docker/setup-buildx-action) mencipta dan menghidupkan builder dengan driver `docker-container` secara lalai, dan `cleanup`-nya (dihidupkan secara lalai) membuang builder pada akhir job.
- **Cakera 14 GB.** `ubuntu-latest` repositori peribadi mempunyai 2 CPU, 8 GB dan SSD 14 GB. Imej yang besar, cache build-nya dan arkib cache untuk dibuka boleh kehabisan ruang ("no space left on device").

## Backend cache buildx, dan kos setiap satu

Daripada [backend cache](https://docs.docker.com/build/cache/backends/) Docker dan [pengurusan cache dengan GitHub Actions](https://docs.docker.com/build/ci/github-actions/cache/):

| Backend | Ke mana lapisan pergi | Apa yang dibayar setiap larian | Had |
|---|---|---|---|
| `type=gha` | Cache Actions GitHub | Memuat naik lapisan baharu, memuat turun yang diperlukan | 10 GB bagi setiap repositori bersama setiap cache lain, diusir yang paling lama dahulu; skop lalai `buildkit` ditulis ganti oleh setiap build; API cache GitHub mengehadkan kadar |
| `type=registry` | Imej cache berasingan dalam registry anda | Menarik cache daripada registry, push yang baharu | Log masuk registry dengan hak push; storan dan trafik registry |
| `type=inline` | Di dalam imej itu sendiri | Menarik imej untuk membaca cache-nya | `mode=min` sahaja: lapisan stage perantaraan tidak dikekalkan |
| `type=local` + actions/cache | Direktori yang disimpan dengan actions/cache | Memuat turun dan membuka keseluruhan direktori, kemudian memuat naiknya | Membesar dengan setiap larian melainkan [`reset=true`](https://docs.docker.com/build/cache/backends/local/) (Buildx 0.35.0 dan kemudian); dikira dalam 10 GB |

Apa jua backend yang anda pilih, [susun Dockerfile](https://docs.docker.com/build/cache/optimize/) supaya lapisan yang paling jarang berubah datang dahulu: salin lockfile dan pasang dependency sebelum anda menyalin kod sumber. Jika tidak, setiap commit membatalkan lapisan pemasangan, dan tiada cache yang mengembalikannya.

`mode=min`, lalainya, hanya mengekalkan lapisan imej akhir. `mode=max` mengekalkan lapisan setiap stage, jadi build berbilang stage lebih kerap kena, dan memuat naik lebih banyak.

Persediaan `type=gha` biasa, dengan skop sendiri bagi setiap imej:

```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 kekal.** `RUN --mount=type=cache` (cache pengurus pakej di dalam build) tidak disimpan dalam cache GitHub Actions secara lalai; dokumentasi Docker menunjuk ke [buildkit-cache-dance](https://github.com/reproducible-containers/buildkit-cache-dance) untuk memindahkannya masuk dan keluar dari actions/cache, satu lagi muat turun dan muat naik bagi setiap larian.

## docker compose menarik setiap imej, setiap job

Ujian integrasi yang memulakan Postgres, Redis dan beberapa perkhidmatan dengan `docker compose up` menarik setiap imej pada setiap job, kerana VM itu baharu. Pada runner yang dihoskan GitHub, pilihannya hanya memindahkan muat turun:

- `docker save` imej ke fail tar, simpan dalam cache dengan actions/cache, dan `docker load` dalam job seterusnya. Ia dikira dalam 10 GB, dan pemuatannya mengambil masa tersendiri.
- Bina imej perkhidmatan dengan buildx dan backend cache di atas, yang masih meninggalkan imej asas untuk ditarik.

## Apabila penyelesaiannya ialah mesin yang mengekalkan cache Docker

Setiap backend di atas wujud kerana builder itu lupa. Daemon Docker yang kekal antara job sudah mempunyai lapisan build sebelumnya, cache mount-nya dan setiap imej yang ditariknya, pada cakeranya sendiri. Tiada apa-apa untuk dieksport, tiada apa-apa untuk diimport, dan tiada 10 GB untuk dikongsi.

## Skipbox mengekalkan cache Docker pada mesin anda

Setiap pelan disertakan dengan mesin khusus akaun anda, dikekalkan antara job:

- **`docker build` dan `docker compose build`** menggunakan semula lapisan build sebelumnya, tanpa perubahan pada workflow.
- **Imej kekal pada cakera.** `docker compose up` menemui imej yang ditariknya kali terakhir; `docker compose pull` hanya mengambil lapisan yang berubah.
- **Cache mount kekal** bersama cache build Docker, jadi `RUN --mount=type=cache` mengekalkan cache pengurus pakej tanpa step tambahan.
- **docker/setup-buildx-action berfungsi seadanya.** Builder-nya bermula dengan lapisan yang ditinggalkan oleh build terakhir repositori anda pada mesin itu, dan anda boleh membuang `cache-from` dan `cache-to`. Apabila kami sendiri menjalankan CI sebuah projek awam pada mesin 4 vCPU (19 November 2026, satu larian setiap satu), langkah yang membina imej mengambil 177 saat pada larian pertama dan 4 saat pada larian semula, dengan 31 langkah CACHED.
- **Cakera:** tiada apa-apa dipadam sehingga cakera hampir penuh selepas job. Kemudian imej tergantung dibuang dahulu, diikuti cache build yang paling lama tidak digunakan.

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

Job memilih saiznya melalui label:

| Label | Mesin | Cakera | Pelan |
|---|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | 80 GB | S, $39 sebulan |
| `skipbox-8x16` | 8 vCPU · 16 GB | 160 GB | M, $79 sebulan |
| `skipbox-16x32` | 16 vCPU · 32 GB | 320 GB | L, $149 sebulan |

Minit tanpa had. Pada 20,000 minit sebulan pada 4 vCPU, GitHub mengecaj $222; Skipbox S ialah $39, $183 lebih murah.

## Beralih hanya satu baris

1. Log masuk ke Skipbox dengan GitHub.
2. Pasang GitHub App Skipbox dan pilih repositori.
3. Tukar `runs-on` dan push.

Job pertama membina setiap lapisan. Job kedua menemuinya pada mesin.

## Keselamatan

- Mesin itu milik akaun anda seorang. Tiada job syarikat lain berjalan padanya.
- Selepas setiap job, bukti kelayakan, proses dan container runner dipadam, begitu juga `~/.docker/config.json`, jadi log masuk registry tidak terbawa ke job seterusnya. “VM baharu bagi setiap job” memberi setiap job mesin baharu sebaliknya.
- Kod daripada orang tanpa akses tulis (seperti pull request daripada fork) berjalan pada mesin baharu sekali guna, tidak pernah pada mesin anda.

Butirannya dalam [cara job diasingkan](https://docs.skipbox.dev/ms/isolation).

## Cuba pada build Docker anda

Percubaan adalah percuma selama 7 hari atau 3,000 minit job, yang mana dahulu, dan tidak memerlukan kad. Pindahkan build Docker anda ke `runs-on: skipbox`, jalankan dua kali, dan letakkan step build larian kedua bersebelahan dengan GitHub.

## Soalan lazim

### Kenapa cache lapisan Docker hilang pada setiap larian GitHub Actions?

Kerana setiap job pada runner yang dihoskan GitHub bermula pada VM baharu, tanpa cache build dan tanpa imej daripada larian sebelumnya. docker/setup-buildx-action menambahnya: secara lalai ia mencipta builder docker-container yang bermula kosong dan dibuang pada akhir job. Jadi setiap lapisan dibina semula melainkan anda mengeksport cache dengan cache-to dan mengimportnya dengan cache-from, atau menjalankannya pada mesin yang mengekalkan cache build Docker.

### Bagaimanakah cara menyimpan cache lapisan Docker dalam GitHub Actions?

Pada runner yang dihoskan GitHub, dengan pengeksport cache buildx: cache-from: type=gha dan cache-to: type=gha,mode=max dalam docker/build-push-action menyimpan lapisan dalam cache Actions GitHub (10 GB bagi setiap repositori, dikongsi dengan setiap cache lain). type=registry menyimpannya sebagai imej berasingan dalam registry anda, dan type=local dalam direktori yang anda simpan dengan actions/cache. Berikan setiap imej skop sendiri dengan type=gha, kerana skop lalai ditulis ganti oleh setiap build. Pada mesin yang mengekalkan cakeranya, docker build menggunakan semula lapisan tanpa pengeksport.

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

Kerana lapisan masih perlu dipindahkan. Dengan mode=max, setiap larian memuat naik setiap lapisan baharu bagi setiap stage, dan larian kemudian memuat turun lapisan yang diperlukannya. Cache itu berkongsi 10 GB GitHub bagi setiap repositori dengan segala-galanya, jadi ia diusir, dan API cache GitHub mengehadkan kadar build yang membuat terlalu banyak permintaan. Builder yang sudah mempunyai lapisan pada cakeranya melangkau kedua-dua arah.

### Bagaimanakah cara menghentikan docker compose daripada menarik imej yang sama dalam setiap job?

Pada runner yang dihoskan GitHub anda tidak boleh, hanya memindahkan muat turun: docker save imej ke fail tar, simpan dalam cache dengan actions/cache, dan docker load dalam job seterusnya. Itu dikira dalam 10 GB yang sama dan merupakan muat turun dan muatan pada setiap larian. Pada mesin yang mengekalkan cakeranya, imej yang ditarik compose kali terakhir sudah ada, dan docker compose pull hanya mengambil lapisan yang berubah.

### Adakah saya perlu mengubah workflow untuk mengekalkan cache Docker di Skipbox?

Hanya runs-on: mesin akaun anda mengekalkan imej, lapisan dan cache build Docker antara job. docker build dan docker compose build menggunakannya semula, dan docker/setup-buildx-action berfungsi seadanya: builder-nya bermula dengan lapisan yang ditinggalkan oleh build terakhir repositori anda pada mesin itu. Anda boleh membuang cache-from dan cache-to.

### Berapakah kos untuk mencuba?

Tiada. Percubaan ialah 7 hari atau 3,000 minit job, yang mana dahulu, tanpa kad. Pindahkan build Docker anda ke runs-on: skipbox, jalankan dua kali, dan bandingkan step build larian kedua dengan GitHub.

Dikemas kini 2026-11-19 · https://skipbox.dev/ms/guides/docker-layer-cache-github-actions
