Skipbox

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

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.

Kenapa setiap build bermula sejuk

  • VM baharu bagi setiap job. Rujukan runner 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 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 Docker dan pengurusan cache dengan GitHub Actions:

Apa jua backend yang anda pilih, susun Dockerfile 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:

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

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.

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

CI/CD lebih pantas dengan cache yang sentiasa sedia

Runner anda yang sentiasa sedia pada harga tetap

Kami yang hoskan. Anda tukar satu baris. 1/12 daripada kos GitHub pada penggunaan penuh. Harga tetap, jadi jalankan sepanjang hari. 7× ruang cache GitHub.

  • Tanpa kad
  • Log masuk dengan GitHub
  • Batal bila-bila masa