GitHub Actions 的「No space left on device」:找出是什麼塞滿磁碟、釋放空間,或換一個更大的磁碟
GitHub Actions 上的「No space left on device」,表示作業寫入的量超過了 Runner 的可用空間,而在 GitHub 的標準 Linux Runner 上,那大約是 14 GB:一位 runner-images 維護者寫道,GitHub 對私有和公開儲存庫都只保證 14 GB 的可用空間,因為映像檔預先安裝的工具占掉了其餘的部分(一位使用者在 ubuntu-latest 上列出的清單:12 GB 的 Android SDK、8.5 GB 的託管工具快取、5.5 GB 的 GHC)。Docker 映像檔、在磁碟上解開的還原快取,以及建置目錄,很快就會把 14 GB 塞滿。請依這個順序修正:看看是什麼塞滿了磁碟(df -h、df -i、du、docker system df)、少寫一點、刪掉作業用不到的預先安裝工具,如果還是放不下,就在更大的磁碟上執行作業。GitHub 的大型 Runner 有 75 GB 以上,但只限 GitHub Team 和 Enterprise Cloud。
Skipbox 在你帳號的專屬機器上執行作業,S 有 80 GB 的磁碟,M 有 160 GB,L 有 320 GB,價格固定,分鐘數不限。它在作業之間保留的快取就放在這個磁碟上,磁碟快滿時會清理其中最舊的部分,所以作業一開始不需要刪除任何東西。
GitHub Runner 有多少磁碟
GitHub 託管 Runner 列出標準 Linux Runner 有 14 GB 的 SSD,私有和公開儲存庫都一樣。在 runner-images discussion #9329 中,一次映像檔變更讓 Ubuntu Runner 的可用空間從超過 31 GB 降到超過 17 GB 之後,一位維護者回答,他們對私有和公開儲存庫確實都只保證 14 GB 的可用空間。請以 14 GB 來規劃。
磁碟的其餘部分就是映像檔。在 issue #10386(「Free space left: 72 MB」)中,一位使用者在 ubuntu-latest 上執行 du 的結果是:
| 目錄 | 大小 |
|---|---|
/usr/local/lib/android | 12 GB |
/opt/hostedtoolcache | 8.5 GB(光 CodeQL 就 5 GB) |
/usr/local/.ghcup | 5.5 GB |
1. 看看是什麼塞滿了磁碟
在失敗的步驟後面加一個步驟,加上 if: always():
- 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顯示每個檔案系統以及它有多滿。注意你的作業寫入的是哪一個:工作區、/var/lib/docker底下的 Docker 資料,或暫存目錄。df -i顯示 inode。磁碟可能在還有剩餘空間時就用光 inode(每個檔案一個),錯誤訊息是一樣的。du顯示最大的目錄。docker system df顯示 Docker 的映像檔、容器、volume 和建置快取占了多少。
2. 少寫一點
- 在建置之間清理 Docker。
docker system prune會移除停止的容器、沒用到的網路、dangling 映像檔和沒用到的建置快取;-a會移除所有沒用到的映像檔,--volumes連匿名 volume 也會移除。 - 只快取值得的東西。 還原的快取會在 Runner 的磁碟上解開,所以大的快取封存檔占用的空間比它下載的量還多。依作業拆分它,或拿掉能很快重新抓取的部分。
- 清理之後的步驟用不到的建置目錄,在需要空間的步驟之前清掉。
3. 刪掉作業用不到的預先安裝工具
依 issue #2875 和 #10386:
- 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 /
有兩個代價。刪除好幾 GB 的檔案每次執行都要花時間,因為下一個作業的 VM 又會有它們。而刪除 $AGENT_TOOLSDIRECTORY(整個託管工具快取)能釋放更多空間,但就像 #2875 的作者發現的,會讓步驟預期在那裡的工具壞掉。free-disk-space action 把這些刪除包裝起來;它的作者在那個討論串之後加上了工具快取的選項,說它能再多省下 6 GB。
4. 在更大的磁碟上執行作業
| Runner | 磁碟 | 誰可以用 |
|---|---|---|
| GitHub 標準 Linux Runner | 14 GB SSD,大約 14 GB 可用 | 所有人 |
| GitHub 大型 Runner,2 到 96 vCPU | 2 vCPU 有 75 GB,4 vCPU 有 150 GB,8 vCPU 有 300 GB,最多到 2,040 GB(大型 Runner) | GitHub Team 和 Enterprise Cloud 的組織,按分鐘計費(關於大型 Runner) |
| 自架 Runner | 你給它多少就有多少;在作業之間保留下來的 Runner,除非有東西清理,否則會被映像檔和舊的工作區塞滿 | 所有人,由你維運 |
| Skipbox 專屬機器 | S 有 80 GB,M 有 160 GB,L 有 320 GB,滿了會自動清理 | 組織和個人帳號,固定價格 |
Skipbox 怎麼處理磁碟
每個方案都附有一台你帳號專屬、在作業之間保留下來的機器,磁碟大小依規格而定:
- S 的磁碟有 80 GB,M 有 160 GB,L 有 320 GB。
- 留在上面的是你的狀態: Docker 的映像檔、層和建置快取、
~/.npm、pnpm store、~/.cache,以及 Go、Gradle、Maven 和 Cargo 的快取,還有setup-*安裝的工具。actions/cache儲存的東西留在機器旁邊,最多占磁碟的一半。 - 它不會被塞滿。 在作業之後磁碟超過 85% 之前,什麼都不會被刪除。超過時會從最久沒用的開始清理,回到 75%:先是 dangling 映像檔,再來是 Docker 的建置快取,然後是整個套件快取和保留的建置。只有在清理後仍然超過 85% 時,機器才會被重設。
- 要更多磁碟,就升一級方案。 自己就要寫入數十 GB 的作業,例如大型映像檔或很大的建置目錄,M 有 160 GB,L 有 320 GB。
| 標籤 | 機器 | 磁碟 | 方案 |
|---|---|---|---|
skipbox | 4 vCPU · 16 GB | 80 GB | S,每月 $39 |
skipbox-8x16 | 8 vCPU · 16 GB | 160 GB | M,每月 $79 |
skipbox-16x32 | 16 vCPU · 32 GB | 320 GB | L,每月 $149 |
分鐘數不限。4 vCPU 每月 20,000 分鐘,GitHub 收 $222;Skipbox S 是 $39。
換過去只要改一行
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 在 M 方案上執行;runs-on: skipbox 在 S 和試用中執行。
- 使用 GitHub 登入 Skipbox。
- 安裝 Skipbox GitHub App,並選擇儲存庫。
- 修改
runs-on並推送。
安全性
- 機器只屬於你的帳號。其他公司的作業不會在上面執行。
- 每個作業結束後,Runner 的憑證、程序和容器都會被清除,家目錄裡的憑證檔案也是。開啟「每個作業都用新 VM」,每個作業就會改用一台全新的機器。
- 沒有寫入權限的人提交的程式碼(例如來自 fork 的 Pull Request),會在全新的 VM 上執行,可以讀取你的快取但不能修改。
詳情請見作業如何隔離。
用磁碟不夠的作業試試看
試用免費,為期 7 天或 3,000 作業分鐘,以先到者為準,不需信用卡。它在 S 的機器上以 80 GB 執行 runs-on: skipbox。把作業移過去,拿掉刪除預先安裝工具的步驟,然後執行。
常見問題
GitHub Actions Runner 有多少磁碟空間?
GitHub 的文件列出標準 Linux Runner 有 14 GB 的 SSD,私有和公開儲存庫都一樣,而一位 runner-images 維護者寫道,GitHub 對兩者都只保證 14 GB 的可用空間。磁碟本身更大,但 Runner 映像檔預先安裝的工具占掉了其餘的空間,所以請以 14 GB 來規劃。
怎麼修好 GitHub Actions 的 No space left on device?
先看看是什麼塞滿了它:用 df -h 看每個檔案系統,df -i 看 inode,sudo du -xh --max-depth=1 / 看最大的目錄,docker system df 看 Docker 的映像檔和建置快取。然後少寫一點(在建置之間清理 Docker、只快取值得的東西)、刪掉作業用不到的預先安裝工具(Android SDK、GHC、CodeQL、.NET),如果作業還是需要更多空間,就在磁碟更大的 Runner 上執行。
可以從 ubuntu-latest 刪掉什麼來釋放磁碟空間?
作業用不到的工具。GitHub runner-images 的 issue 裡,使用者會刪除 /usr/local/lib/android(在一位使用者的清單中有 12 GB)、/usr/local/.ghcup、/opt/hostedtoolcache/CodeQL、/usr/share/dotnet 和 /usr/local/share/boost。刪除 $AGENT_TOOLSDIRECTORY 也能釋放託管工具快取,但會讓預期工具在那裡的設定步驟壞掉。刪除好幾 GB 的檔案,每次執行都要花時間。
GitHub 的大型 Runner 有更多磁碟嗎?
有:2 vCPU 有 75 GB,4 vCPU 有 150 GB,8 vCPU 有 300 GB,64 和 96 vCPU 最多到 2,040 GB。它們只提供給 GitHub Team 或 GitHub Enterprise Cloud 上的組織,按分鐘計費。
Skipbox 給作業多少磁碟?
你帳號的專屬機器,S 有 80 GB,M 有 160 GB,L 有 320 GB。在作業之間保留的快取共用這個磁碟:作業結束後磁碟使用率超過 85% 時,會從最久沒用的開始清理,回到 75%,所以它不會像自架 Runner 的磁碟那樣被塞滿。自己就要寫入數十 GB 的作業,M 和 L 給足空間。
試用要花多少錢?
不用錢。試用為期 7 天或 3,000 作業分鐘,以先到者為準,不需信用卡,在 S 的機器上執行。把磁碟不夠的作業改成 runs-on: skipbox,再拿掉刪除預先安裝工具的步驟。
更新於 2026年11月16日