# "No space left on device" trên GitHub Actions: tìm thứ làm đầy ổ đĩa, giải phóng nó, hoặc lấy ổ đĩa lớn hơn

> GitHub chỉ bảo đảm 14 GB trống trên runner Linux tiêu chuẩn, và Docker image, cache được khôi phục và cây build làm đầy nó. Cách xem thứ gì làm đầy ổ đĩa, xóa gì khỏi image của runner, và ổ đĩa lớn hơn lấy từ đâu: larger runner của GitHub trên Team và Enterprise, hoặc máy riêng của Skipbox với 80 GB ở S, 160 GB ở M và 320 GB ở L với giá cố định.

"No space left on device" trên GitHub Actions nghĩa là job đã ghi nhiều hơn chỗ trống của runner, và trên runner Linux tiêu chuẩn của GitHub con số đó là khoảng 14 GB: một người bảo trì runner-images viết rằng GitHub chỉ bảo đảm 14 GB trống cho cả repository riêng tư lẫn công khai, vì các tool cài sẵn trong image chiếm phần còn lại (danh sách của một người dùng trên `ubuntu-latest`: 12 GB Android SDK, 8,5 GB hosted tool cache, 5,5 GB GHC). Docker image, một cache được khôi phục giải nén trên ổ đĩa, và cây build làm đầy 14 GB rất nhanh. Hãy sửa theo thứ tự này: xem thứ gì làm đầy ổ đĩa (`df -h`, `df -i`, `du`, `docker system df`), ghi ít hơn, xóa các tool cài sẵn mà job không dùng, và nếu vẫn không vừa, chạy job trên ổ đĩa lớn hơn. Larger runner của GitHub có từ 75 GB trở lên, chỉ trên GitHub Team và Enterprise Cloud.

Skipbox chạy job của bạn trên máy riêng của tài khoản bạn với ổ đĩa 80 GB ở S, 160 GB ở M và 320 GB ở L, với giá cố định, không giới hạn phút. Các cache nó giữ giữa các job nằm trên ổ đĩa đó, và nó dọn những cache cũ nhất khi ổ đĩa đầy, nên không cần xóa gì lúc job bắt đầu.

- Ổ đĩa 80 GB ở S, 160 GB ở M, 320 GB ở L, so với khoảng 14 GB trống trên runner tiêu chuẩn của GitHub
- Docker image, layer và cache package nằm lại trên ổ đĩa đó giữa các job
- Vượt 85% sau một job thì ổ đĩa được dọn về 75%, thứ lâu chưa dùng nhất trước

**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-github-actions-no-space-left-on-device-vi)

## Runner GitHub có bao nhiêu ổ đĩa

[GitHub-hosted runners](https://docs.github.com/en/actions/reference/runners/github-hosted-runners) ghi 14 GB SSD cho runner Linux tiêu chuẩn, trên repository riêng tư và công khai. Trong [thảo luận runner-images #9329](https://github.com/actions/runner-images/discussions/9329), sau khi một thay đổi image cắt chỗ trống trên runner Ubuntu từ hơn 31 GB xuống hơn 17 GB, một người bảo trì trả lời rằng họ quả thật chỉ bảo đảm 14 GB trống cho cả repository riêng tư lẫn công khai. Hãy tính là 14 GB.

Phần còn lại của ổ đĩa là image. Trong [issue #10386](https://github.com/actions/runner-images/issues/10386) ("Free space left: 72 MB"), lệnh `du` của một người dùng trên `ubuntu-latest` cho thấy:

| Thư mục | Dung lượng |
|---|---|
| `/usr/local/lib/android` | 12 GB |
| `/opt/hostedtoolcache` | 8,5 GB (riêng CodeQL 5 GB) |
| `/usr/local/.ghcup` | 5,5 GB |

## 1. Xem thứ gì làm đầy ổ đĩa

Thêm một step sau step bị lỗi, với `if: always()`:

```yaml
- name: Disk usage
  if: always()
  run: |
    df -h
    df -i /
    sudo du -xh --max-depth=1 / 2>/dev/null | sort -rh | head -15
    docker system df || true
```

- `df -h` cho thấy từng filesystem và mức đầy của nó. Hãy để ý job của bạn ghi vào filesystem nào: workspace, dữ liệu Docker dưới `/var/lib/docker`, hay thư mục tạm.
- `df -i` cho thấy inode. Ổ đĩa có thể hết inode (mỗi file một inode) trong khi vẫn còn byte trống, và lỗi vẫn y như vậy.
- `du` cho thấy các thư mục lớn nhất.
- [`docker system df`](https://docs.docker.com/reference/cli/docker/system/df/) cho thấy image, container, volume và build cache của Docker chiếm bao nhiêu.

## 2. Ghi ít hơn

- **Prune Docker giữa các bản build.** [`docker system prune`](https://docs.docker.com/reference/cli/docker/system/prune/) xóa container đã dừng, network không dùng, image treo và build cache không dùng; `-a` xóa mọi image không dùng, và `--volumes` xóa cả volume ẩn danh.
- **Chỉ cache thứ đáng cache.** Cache được khôi phục sẽ giải nén trên ổ đĩa của runner, nên một archive cache lớn chiếm nhiều chỗ hơn dung lượng tải về của nó. Hãy tách nó theo job, hoặc bỏ những thứ tải lại nhanh.
- **Dọn các cây build** mà step sau không cần, trước step cần chỗ.

## 3. Xóa các tool cài sẵn mà job không dùng

Theo [issue #2875](https://github.com/actions/runner-images/issues/2875) và #10386:

```yaml
- name: Free disk space
  run: |
    sudo rm -rf /usr/local/lib/android /usr/local/.ghcup /opt/hostedtoolcache/CodeQL
    sudo rm -rf /usr/share/dotnet /usr/local/share/boost
    df -h /
```

Hai cái giá. Xóa hàng gigabyte tốn thời gian ở mỗi lần chạy, vì VM của job sau lại có chúng. Và xóa `$AGENT_TOOLSDIRECTORY` (toàn bộ hosted tool cache) giải phóng nhiều hơn nhưng, như tác giả của #2875 phát hiện, làm hỏng các tool mà các step chờ sẵn ở đó. Action [free-disk-space](https://github.com/marketplace/actions/free-disk-space-ubuntu) gói các lệnh xóa này lại; tác giả của nó thêm tùy chọn tool cache sau thread đó, và cho biết nó tiết kiệm thêm 6 GB.

## 4. Chạy job trên ổ đĩa lớn hơn

| Runner | Ổ đĩa | Ai dùng được |
|---|---|---|
| Runner Linux tiêu chuẩn của GitHub | 14 GB SSD, khoảng 14 GB trống | Mọi người |
| Larger runner của GitHub, 2 đến 96 vCPU | 75 GB ở 2 vCPU, 150 GB ở 4, 300 GB ở 8, tới 2.040 GB ([larger runners](https://docs.github.com/en/actions/reference/runners/larger-runners)) | Tổ chức dùng GitHub Team và Enterprise Cloud, tính theo phút ([about larger runners](https://docs.github.com/en/actions/concepts/runners/larger-runners)) |
| Self-hosted runner | Bạn cho bao nhiêu thì có bấy nhiêu; runner được giữ giữa các job sẽ đầy dần image và workspace cũ nếu không có gì dọn | Ai cũng dùng được, và bạn tự vận hành |
| Máy riêng của Skipbox | 80 GB ở S, 160 GB ở M, 320 GB ở L, tự dọn khi đầy | Tổ chức và tài khoản cá nhân, giá cố định |

## Skipbox làm gì với ổ đĩa

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ới ổ đĩa theo kích thước của nó:

- **Ổ đĩa là 80 GB ở S, 160 GB ở M, 320 GB ở L.**
- **Thứ nằm lại trên đó là trạng thái của bạn:** Docker image, layer và build cache, `~/.npm`, pnpm store, `~/.cache`, cache của Go, Gradle, Maven và Cargo, cùng các tool mà `setup-*` đã cài. Những gì `actions/cache` lưu nằm cạnh máy, tới một nửa ổ đĩa.
- **Nó không bị đầy.** Không gì bị xóa cho đến khi ổ đĩa đầy hơn 85% sau một job. Khi đó nó được dọn về 75%, thứ lâu chưa dùng nhất trước: image treo, rồi build cache của Docker, rồi cả cache package và các bản build được giữ. Chỉ khi vẫn vượt 85% thì máy mới được đặt lại.
- **Cần thêm ổ đĩa thì lên một gói.** Job tự ghi hàng chục gigabyte, như image lớn hay cây build to, có 160 GB trên M và 320 GB trên L.

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

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.

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

```yaml
jobs:
  build:
    runs-on: skipbox-8x16 # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      # the "Free disk space" step can go
      - run: docker build -t app .
```

`skipbox-8x16` chạy trên gói M; `runs-on: skipbox` chạy trên S và trong bản dùng thử.

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.

## 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ả các file thông tin xác thực trong thư mục home. 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 VM mới, đọc được cache của bạn nhưng không sửa được.

Chi tiết có trong [cách các job được cách ly](https://docs.skipbox.dev/vi/isolation).

## Thử trên job hay hết ổ đĩa

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ẻ. Nó chạy `runs-on: skipbox` trên máy của gói S với 80 GB. Chuyển job sang đó, bỏ step xóa tool cài sẵn, rồi chạy.

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

### Runner GitHub Actions có bao nhiêu dung lượng ổ đĩa?

Tài liệu của GitHub ghi 14 GB SSD cho runner Linux tiêu chuẩn, trên cả repository riêng tư lẫn công khai, và một người bảo trì runner-images viết rằng GitHub chỉ bảo đảm 14 GB trống cho cả hai. Bản thân ổ đĩa lớn hơn, nhưng các tool cài sẵn trong image của runner chiếm phần còn lại, nên hãy tính là 14 GB.

### Sửa lỗi No space left on device trên GitHub Actions thế nào?

Trước hết xem thứ gì làm đầy nó: df -h cho từng filesystem, df -i cho inode, sudo du -xh --max-depth=1 / cho các thư mục lớn nhất, và docker system df cho image và build cache của Docker. Sau đó ghi ít hơn (prune Docker giữa các bản build, chỉ cache thứ đáng cache), xóa các tool cài sẵn mà job không dùng (Android SDK, GHC, CodeQL, .NET), và nếu job vẫn cần thêm chỗ, hãy chạy nó trên runner có ổ đĩa lớn hơn.

### Xóa gì khỏi ubuntu-latest để giải phóng ổ đĩa?

Các tool mà job không dùng. Người dùng trong các issue runner-images của GitHub xóa /usr/local/lib/android (12 GB trong danh sách của một người dùng), /usr/local/.ghcup, /opt/hostedtoolcache/CodeQL, /usr/share/dotnet và /usr/local/share/boost. Xóa $AGENT_TOOLSDIRECTORY giải phóng cả hosted tool cache, nhưng làm hỏng các step setup chờ tool của chúng ở đó. Xóa hàng gigabyte tốn thời gian ở mỗi lần chạy.

### Larger runner của GitHub có ổ đĩa lớn hơn không?

Có: 75 GB ở 2 vCPU, 150 GB ở 4, 300 GB ở 8, tới 2.040 GB ở 64 và 96 vCPU. Chúng chỉ dành cho tổ chức dùng GitHub Team hoặc GitHub Enterprise Cloud, tính tiền theo phút.

### Skipbox cho job bao nhiêu ổ đĩa?

Máy riêng của tài khoản bạn có 80 GB ở S, 160 GB ở M và 320 GB ở L. Các cache giữ giữa các job dùng chung ổ đĩa đó: sau một job để ổ đĩa đầy hơn 85%, nó được dọn về 75%, thứ lâu chưa dùng nhất trước, nên không bị đầy như ổ đĩa của một self-hosted runner. Với job tự ghi hàng chục gigabyte, M và L cho đủ 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ẻ, trên máy của gói S. Chuyển job hay hết ổ đĩa sang runs-on: skipbox và bỏ các step xóa tool cài sẵn.

Cập nhật ngày 2026-11-16 · https://skipbox.dev/vi/guides/github-actions-no-space-left-on-device
