# docker compose kéo lại mọi image ở mọi job GitHub Actions: cách thôi kéo đi kéo lại

> Mỗi job GitHub Actions khởi đầu trên một VM mới không có Docker image nào, nên docker compose up lại kéo Postgres, Redis và mọi image service khác. docker save cùng actions/cache chỉ dời chỗ việc tải, trong 10 GB của GitHub. Trên một runner giữ ổ đĩa, image đã nằm sẵn đó. Skipbox là runner như vậy, giá cố định $39 một tháng: đổi một dòng runs-on.

`docker compose up` kéo lại mọi image ở mọi job GitHub Actions vì mỗi job trên runner do GitHub host khởi đầu trên một VM mới. Postgres, Redis, message broker, image service của chính bạn: không cái nào nằm trên ổ đĩa, nên Compose tải và giải nén tất cả trước khi test đầu tiên chạy. Cách thôi kéo đi kéo lại cùng các image là chạy job trên một cái máy vẫn còn giữ chúng.

Skipbox là cái má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. `docker compose up` tìm thấy những gì đã kéo lần trước và khởi động container. Đổ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.

- GitHub: một VM mới cho mỗi job, nên mọi image trong file compose bị kéo lại, ở mọi job
- Skipbox: image nằm lại trên ổ đĩa của máy bạn, và chỉ các layer đã thay đổi mới được tải
- 20.000 phút mỗi tháng trên 4 vCPU: $222 trên GitHub, $39 trên Skipbox

**GitHub Actions giá cố định, không giới hạn phút** Skipbox chạy job GitHub Actions của bạn trên máy riêng dành cho bạn: $39 một tháng, dù bạn chạy bao nhiêu phút. Docker layer và cache dependency được giữ giữa các job, nên job tiếp theo khởi chạy ngay.

Runner 4 vCPU, 20.000 phút một tháng: GitHub $222 → Skipbox $39. Bạn tiết kiệm $183 mỗi tháng.

Chỉ cần đổi một dòng: `runs-on: skipbox`.

[Bắt đầu dùng thử miễn phí 7 ngày](https://app.skipbox.dev/sign-in?ref=g-docker-compose-pull-slow-github-actions-vi)

## Vì sao job nào cũng kéo

- **Một VM mới cho mỗi job.** Theo [tài liệu runner](https://docs.github.com/en/actions/reference/runners/github-hosted-runners) của GitHub, đọc ngày 14 tháng 11 năm 2026, 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 đã kéo còn trên đó.
- **Compose kéo những gì còn thiếu.** [`pull_policy`](https://docs.docker.com/reference/compose-file/services/) mặc định là `missing`: Compose chỉ kéo image khi nó chưa có trong cache của nền tảng. Trên một VM mới, image nào cũng thiếu.
- **Kéo nghĩa là tải và giải nén.** Từng layer được tải, giải nén và ghi ra ổ đĩa của VM. `ubuntu-latest` của repository riêng tư chỉ có 2 CPU và 14 GB SSD để làm việc đó.

Vậy thời gian trước test đầu tiên bằng đúng kích thước file compose của bạn, trả đủ ở mọi lần push.

## Bạn làm được gì trên runner do GitHub host

Các cách đều chỉ dời chỗ việc tải; không cách nào bỏ được nó.

| Cách | Mỗi job vẫn phải làm gì | Giới hạn |
|---|---|---|
| `docker save` + actions/cache + `docker load` | Tải archive, rồi nạp mọi image vào Docker | Tính vào 10 GB mỗi repository của GitHub, dùng chung với mọi cache khác |
| Image nhỏ hơn (`-alpine`, `-slim`) | Vẫn kéo tất cả, nhanh hơn | Chỉ được tới mức mỗi image có bản nhỏ |
| Ít service hơn mỗi job | Kéo ít image hơn | Các test cần cả stack vẫn phải kéo đủ |

Cách nào cũng là làm cho một cái máy hay quên quên ít đi một chút. Việc kéo chỉ biến mất khi cái máy nhớ được.

## Skipbox giữ image 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:

- **Image nằm lại trên ổ đĩa.** `docker compose up` tìm thấy các image đã kéo lần trước và đi thẳng tới việc khởi động container.
- **Chỉ tải những gì thay đổi.** `docker compose pull` tải các layer đã đổi và dùng lại phần còn lại.
- **Image service của chính bạn build từ cache.** `docker compose build` dùng lại layer của lần build trước, không cần `cache-from` hay `cache-to`.
- **Mỗi job bắt đầu sạch sẽ.** Sau mỗi job, Skipbox gỡ mọi container và xóa thông tin đăng nhập registry (`~/.docker/config.json`). Job sau khởi động service từ đầu, từ các image đã nằm sẵn trên ổ đĩa.
- **Đủ chỗ cho chúng.** Ổ đĩa là 80 GB ở gói S, so với 14 GB trên runner của GitHub. 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.

Workflow không đổi gì ngoài `runs-on`:

```yaml
jobs:
  integration:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: docker compose up -d --wait
      - run: npm ci && npm run test:integration
```

Nếu bạn đã lưu image bằng actions/cache và `docker load`, hãy xóa các step đó. Job đầu tiên trên Skipbox kéo mọi image một lần. Job thứ hai tìm thấy chúng trên máy.

Job chọn kích thước bằng nhãn:

| Nhãn | Máy | Ổ đĩa | Gói |
|---|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | 80 GB | S, $39 một tháng |
| `skipbox-8x16` | 8 vCPU · 16 GB | 160 GB | M, $79 một tháng |
| `skipbox-16x32` | 16 vCPU · 32 GB | 320 GB | L, $149 một tháng |

## Cùng số phút, giá cố định

Integration test là các job dài, nên chính chúng làm hóa đơn theo phút tăng lên. Trên Skipbox, không giới hạn phút:

| Số phút mỗi tháng (4 vCPU) | GitHub | Skipbox S | Bạn tiết kiệm mỗi tháng |
|---|---|---|---|
| 10.000 | $102 | $39 | **$63** |
| 20.000 | $222 | $39 | **$183** |
| 30.000 | $342 | $39 | **$303** |

Số liệu GitHub là sau khi trừ mức sử dụng có sẵn của GitHub Team. Số phút của chính bạn nhập vào [máy tính chi phí trên trang chủ](https://skipbox.dev/?ref=g-docker-compose-pull-slow-github-actions-vi#cost).

## 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` của job integration test rồi push.

Build image trong cùng workflow? [Docker layer cache trên GitHub Actions](https://skipbox.dev/vi/guides/docker-layer-cache-github-actions) nói về `docker build` và buildx.

## 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](https://docs.skipbox.dev/vi/isolation).

## Thử trên integration test 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 job sang `runs-on: skipbox`, chạy hai lần, và đặt `docker compose up` của lần chạy thứ hai cạnh số liệu của GitHub.

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

### Integration test dùng docker compose trên GitHub Actions của chúng tôi tốn phần lớn thời gian để kéo image. Làm sao tránh kéo lại cùng image ở mỗi job?

Chạy job trên một cái máy giữ được ổ đĩa. Runner do GitHub host là một VM mới cho mỗi job, nên không image nào còn lại và compose kéo lại tất cả. Trên Skipbox, job chạy trên máy riêng của tài khoản bạn, nơi giữ Docker image giữa các job: docker compose up tìm thấy các image đã kéo lần trước và khởi động container. Thay đổi chỉ là 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 docker compose kéo lại image ở mỗi job GitHub Actions?

Vì Compose kéo image khi image không có trên máy, và trên runner do GitHub host thì không bao giờ có. Tài liệu runner của GitHub ghi rằng mỗi runner do GitHub host là một máy ảo mới; không có gì job trước đã kéo còn trên đó. pull_policy mặc định của Compose, missing, sẽ bỏ qua việc kéo nếu image đã có.

### Có cache được image của docker compose bằng actions/cache không?

Được, nhưng chỉ dời chỗ việc tải. docker save ghi image ra một file tar, actions/cache lưu nó, và job sau khôi phục rồi chạy docker load. Job nào cũng vẫn phải tải toàn bộ archive và nạp nó vào Docker, và archive tính vào 10 GB cache mỗi repository của GitHub, dùng chung với cache dependency. Trên một cái máy giữ ổ đĩa, không có gì phải save hay load.

### Skipbox có giữ Docker image giữa các job không?

Có. 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, và máy giữ Docker image, layer và build cache trên ổ đĩa: 80 GB ở gói S, 160 GB ở M và 320 GB ở L. Sau mỗi job, các container bị gỡ và thông tin đăng nhập registry bị xóa; image được giữ lại.

### Khi một image trong file compose thay đổi thì sao?

Chỉ các layer đã thay đổi được tải về. Thêm docker compose pull trước docker compose up khi bạn muốn mỗi job kiểm tra registry: Docker tải các layer mới và dùng lại những layer đã có trên ổ đĩa của máy. Image bạn tự build bằng docker compose build cũng dùng lại layer của lần build trước theo cách đó.

### 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 job integration test sang runs-on: skipbox, chạy hai lần, rồi so docker compose up của lần chạy thứ hai với GitHub.

Cập nhật ngày 2026-11-14 · https://skipbox.dev/vi/guides/docker-compose-pull-slow-github-actions
