Skipbox

Docker layer cache trên GitHub Actions: vì sao bản build nào cũng bắt đầu nguội, và cách giữ các layer

Layer cache của Docker mất sau mỗi lần chạy GitHub Actions vì mỗi job trên runner do GitHub host khởi đầu trên một VM mới: không build cache, không image nào đã kéo. Builder mặc định của docker/setup-buildx-action (docker-container) cũng khởi đầu trống ở mỗi job và bị gỡ khi job kết thúc. Cách sửa thường gặp là export cache bằng buildx. cache-to: type=gha,mode=max và cache-from: type=gha giữ layer trong Actions cache của GitHub, 10 GB mỗi repository và dùng chung với mọi cache khác; type=registry giữ chúng trong registry của bạn; type=local trong một thư mục bạn lưu bằng actions/cache. Cách nào cũng biến một lần build lại thành một lần tải lên và một lần tải về ở mỗi lần chạy.

Skipbox giữ layer ngay tại nơi bản build chạy. Job của bạn chạy trên máy riêng của tài khoản bạn, nơi giữ Docker image, layer và build cache giữa các job, trên ổ đĩa 80 GB ở gói S so với 14 GB trên runner của GitHub. docker build và docker compose build dùng lại layer của lần build trước, và các image compose đã kéo nằm sẵn trên ổ đĩa. setup-buildx-action chạy đúng như đang có, và builder của nó cũng tìm thấy các layer đó. Đổi một dòng, runs-on: skipbox, với giá cố định $39 một tháng, không giới hạn phút.

Vì sao bản build nào cũng bắt đầu nguội

  • Một VM mới cho mỗi job. Theo tài liệu runner của GitHub, mỗi runner do GitHub host là một máy ảo (VM) mới do GitHub host. Không có gì job trước đã build hay đã kéo còn trên đó.
  • Một builder trống. docker/setup-buildx-action mặc định tạo và khởi động một builder với driver docker-container, và cleanup của nó (mặc định bật) gỡ builder khi job kết thúc.
  • 14 GB ổ đĩa. ubuntu-latest của repository riêng tư có 2 CPU, 8 GB và 14 GB SSD. Một image lớn, build cache của nó và một archive cache cần giải nén có thể làm hết chỗ ("no space left on device").

Các backend cache của buildx, và cái giá của từng loại

Theo cache backends và cache management with GitHub Actions của Docker:

Dù chọn backend nào, hãy sắp xếp Dockerfile để các layer ít thay đổi nhất đứng trước: sao chép lockfile và cài dependency trước khi sao chép mã nguồn. Nếu không, commit nào cũng làm mất hiệu lực layer cài đặt, và không cache nào mang nó về được.

mode=min, mặc định, chỉ giữ layer của image cuối cùng. mode=max giữ layer của mọi stage, nên bản build nhiều stage hit nhiều hơn, và tải lên cũng nhiều hơn.

Một thiết lập type=gha điển hình, mỗi image một scope riêng:

- 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 không còn lại. RUN --mount=type=cache (cache của trình quản lý package bên trong bản build) mặc định không được giữ trong GitHub Actions cache; tài liệu Docker chỉ sang buildkit-cache-dance để chuyển nó ra vào actions/cache, thêm một lần tải về và tải lên mỗi lần chạy.

docker compose kéo mọi image, ở mọi job

Integration test khởi động Postgres, Redis và vài service bằng docker compose up sẽ kéo mọi image ở mọi job, vì VM là mới. Trên runner do GitHub host, các cách chỉ dời chỗ việc tải:

  • docker save image ra một file tar, cache nó bằng actions/cache, và docker load ở job sau. Cách này tính vào 10 GB, và việc nạp cũng tốn thời gian riêng.
  • Build image service bằng buildx và một backend cache ở trên, vẫn để lại các base image phải kéo.

Khi cách sửa là một cái máy giữ cache Docker

Mọi backend ở trên tồn tại vì builder hay quên. Một Docker daemon được giữ lại giữa các job đã có sẵn layer của lần build trước, cache mount của nó và mọi image nó đã kéo, trên chính ổ đĩa của nó. Không có gì phải export, không có gì phải import, và không có 10 GB nào phải chia nhau.

Skipbox giữ cache Docker trên máy của bạn

Mỗi gói đi kèm máy riêng của tài khoản bạn, được giữ lại giữa các job:

  • docker build và docker compose build dùng lại layer của lần build trước, không phải sửa workflow.
  • Image nằm lại trên ổ đĩa. docker compose up tìm thấy các image đã kéo lần trước; docker compose pull chỉ tải các layer đã thay đổi.
  • Cache mount được giữ cùng Docker build cache, nên RUN --mount=type=cache giữ cache của trình quản lý package mà không cần thêm step nào.
  • docker/setup-buildx-action chạy đúng như đang có. Builder của nó bắt đầu từ các layer mà lần build trước của repository bạn để lại trên máy, và bạn có thể bỏ cache-from và cache-to. Khi chúng tôi tự chạy CI của một dự án công khai trên máy 4 vCPU (ngày 19 tháng 11 năm 2026, mỗi lần chạy một lượt), step build image mất 177 giây ở lần chạy đầu và 4 giây ở lần chạy lại, với 31 step CACHED.
  • Ổ đĩa: không gì bị xóa cho đến khi ổ đĩa gần đầy sau một job. Khi đó image treo (dangling) bị xóa trước, rồi đến build cache lâu chưa dùng nhất.
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 chọn kích thước bằng nhãn:

Không giới hạn phút. Ở mức 20.000 phút mỗi tháng trên 4 vCPU, GitHub tính $222; Skipbox S là $39, ít hơn $183.

Chuyển sang chỉ cần một dòng

  1. Đăng nhập Skipbox bằng GitHub.
  2. Cài ứng dụng GitHub của Skipbox và chọn các repository.
  3. Đổi runs-on rồi push.

Job đầu tiên build mọi layer. Job thứ hai tìm thấy chúng trên máy.

Bảo mật

  • Máy chỉ thuộc về tài khoản của bạn. Không có job của công ty nào khác chạy trên đó.
  • Sau mỗi job, thông tin xác thực, tiến trình và container của runner bị xóa, cùng ~/.docker/config.json, nên thông tin đăng nhập registry không mang sang job sau. Bật VM mới cho mỗi job thì mỗi job chạy trên một máy mới.
  • Code từ người không có quyền ghi (chẳng hạn pull request từ fork) chạy trên một máy mới, dùng xong là bỏ, không bao giờ trên máy của bạn.

Chi tiết có trong cách các job được cách ly.

Thử trên bản build Docker của bạn

Dùng thử miễn phí trong 7 ngày hoặc 3.000 phút chạy job, tùy điều kiện nào đến trước, không cần thẻ. Chuyển bản build Docker sang runs-on: skipbox, chạy hai lần, và đặt step build của lần chạy thứ hai cạnh số liệu của GitHub.

Câu hỏi thường gặp

Vì sao Docker layer cache mất sau mỗi lần chạy GitHub Actions?

Vì mỗi job trên runner do GitHub host khởi đầu trên một VM mới, không có build cache và không có image nào từ lần chạy trước. docker/setup-buildx-action còn thêm vào đó: mặc định nó tạo một builder docker-container khởi đầu trống và bị gỡ khi job kết thúc. Vì vậy mọi layer đều được build lại, trừ khi bạn export cache bằng cache-to và import bằng cache-from, hoặc chạy trên một cái máy giữ Docker build cache.

Cache Docker layer trên GitHub Actions thế nào?

Trên runner do GitHub host, dùng các cache exporter của buildx: cache-from: type=gha và cache-to: type=gha,mode=max trong docker/build-push-action lưu layer vào Actions cache của GitHub (10 GB mỗi repository, dùng chung với mọi cache khác). type=registry lưu chúng thành một image riêng trong registry của bạn, và type=local vào một thư mục bạn lưu bằng actions/cache. Với type=gha, hãy cho mỗi image một scope riêng, vì scope mặc định bị mỗi lần build ghi đè. Trên một cái máy giữ ổ đĩa, docker build dùng lại layer mà không cần exporter nào.

Vì sao buildx với cache-to type=gha vẫn chậm?

Vì layer vẫn phải đi lại. Với mode=max, mỗi lần chạy tải lên mọi layer mới của mọi stage, và lần chạy sau tải về những layer nó cần. Cache dùng chung 10 GB mỗi repository của GitHub với mọi thứ khác, nên bị loại bỏ, và cache API của GitHub giới hạn tốc độ một bản build gửi quá nhiều yêu cầu. Một builder đã có sẵn layer trên ổ đĩa bỏ qua được cả hai chiều.

Làm sao để docker compose thôi kéo lại cùng image ở mỗi job?

Trên runner do GitHub host thì không được, chỉ dời chỗ việc tải: docker save image ra một file tar, cache nó bằng actions/cache, và docker load ở job sau. Cách đó tính vào cùng 10 GB và mỗi lần chạy là một lần tải và một lần nạp. Trên một cái máy giữ ổ đĩa, các image mà compose đã kéo lần trước đã có sẵn, và docker compose pull chỉ tải các layer đã thay đổi.

Có phải sửa workflow để giữ cache Docker trên Skipbox không?

Chỉ runs-on: máy riêng của bạn giữ Docker image, layer và build cache giữa các job. docker build và docker compose build dùng lại chúng, còn docker/setup-buildx-action chạy đúng như đang có: builder của nó bắt đầu từ các layer mà lần build trước của repository bạn để lại trên máy. Bạn có thể bỏ cache-from và cache-to.

Thử thì tốn bao nhiêu?

Không tốn gì. Dùng thử kéo dài 7 ngày hoặc 3.000 phút chạy job, tùy điều kiện nào đến trước, không cần thẻ. Chuyển bản build Docker sang runs-on: skipbox, chạy hai lần, rồi so step build của lần chạy thứ hai với GitHub.

Cập nhật ngày 19 tháng 11, 2026

CI/CD nhanh hơn với cache luôn sẵn sàng

Runner luôn sẵn cache, giá cố định

Chúng tôi host. Bạn đổi một dòng. Chỉ bằng 1/12 chi phí GitHub khi chạy hết công suất. Giá cố định nên bạn chạy cả ngày cũng được. Dung lượng cache gấp 7 lần GitHub.

  • Không cần thẻ
  • Đăng nhập bằng GitHub
  • Hủy bất cứ lúc nào