GitHub Actions 中的 “No space left on device”:找出什么占满了磁盘,腾出空间,或者换一块更大的磁盘
GitHub Actions 上的 "No space left on device" 意味着作业写入的数据超过了运行器的可用空间,在 GitHub 的标准 Linux 运行器上,这大约是 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 的大型运行器有 75 GB 起,只面向 GitHub Team 和 Enterprise Cloud。
Skipbox 在你账号的专属机器上运行作业,S 有 80 GB 磁盘,M 有 160 GB,L 有 320 GB,价格固定,分钟数不限。它在作业之间保留的缓存就放在这块磁盘上,磁盘快满时它会清理最旧的那些,所以作业开始时不需要删任何东西。
GitHub 运行器有多少磁盘
GitHub 托管的运行器列出标准 Linux 运行器有 14 GB SSD,私有仓库和公开仓库都一样。在 runner-images 讨论 #9329 中,一次镜像变更让 Ubuntu 运行器的可用空间从 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 的镜像、容器、卷和构建缓存各占多少。
2. 少写一些
- 在两次构建之间清理 Docker:
docker system prune删除已停止的容器、未使用的网络、悬空镜像和未使用的构建缓存;-a删除所有未使用的镜像,--volumes还会删除匿名卷。 - 只缓存值得缓存的东西:恢复的缓存会在运行器的磁盘上解压,所以一个大的缓存归档占的空间比它的下载量还大。按作业拆分,或者去掉那些重新获取也很快的东西。
- 清理构建目录:后面的步骤用不到的构建目录,在需要空间的步骤之前清掉。
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,因为下一个作业的虚拟机上又有它们。删掉 $AGENT_TOOLSDIRECTORY(整个托管工具缓存)能腾出更多空间,但正如 #2875 的作者发现的那样,会让依赖那里工具的步骤出错。free-disk-space 这个操作封装了这些删除;它的作者在那个讨论之后加上了工具缓存选项,说它能再多腾出 6GB。
4. 在更大的磁盘上运行作业
| 运行器 | 磁盘 | 谁能用 |
|---|---|---|
| GitHub 标准 Linux 运行器 | 14 GB SSD,约 14 GB 可用 | 所有人 |
| GitHub 大型运行器,2 到 96 vCPU | 2 vCPU 为 75 GB,4 vCPU 为 150 GB,8 vCPU 为 300 GB,最多 2,040 GB(大型运行器) | GitHub Team 和 Enterprise Cloud 上的组织,按分钟计费(关于大型运行器) |
| 自托管运行器 | 你给它多少就是多少;一个在作业之间保留的运行器,没有东西清理的话,会被镜像和旧的工作区填满 | 所有人,由你运维 |
| 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%:先是悬空镜像,然后是 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 上每月 2万分钟,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 应用,并选择仓库。
- 修改
runs-on并推送。
安全
- 这台机器只属于你的账号。不会运行其他公司的作业。
- 每个作业结束后,运行器的凭据、进程和容器都会被清除,主目录中的凭据文件也一样。开启“每个作业用新虚拟机”后,每个作业改在一台新机器上运行。
- 没有写入权限的人提交的代码(例如来自复刻的拉取请求)在一台新的虚拟机上运行,它能读取你的缓存,但不能修改。
详情见作业如何隔离。
用磁盘不够用的作业试试
试用免费,为期 7 天 或 3,000 作业分钟,以先到者为准,无需绑卡。试用在 S 的 80 GB 机器上运行 runs-on: skipbox。把作业移过去,删掉删除预装工具的那个步骤,然后运行。
常见问题
GitHub Actions 运行器有多少磁盘空间?
GitHub 的文档列出标准 Linux 运行器有 14 GB SSD,私有仓库和公开仓库都一样,runner-images 的一位维护者也写过,GitHub 对两者都只保证 14 GB 可用空间。磁盘本身更大,但运行器镜像预装的工具占了其余部分,所以按 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),如果作业还需要更多空间,就在磁盘更大的运行器上运行它。
可以从 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 也能腾出托管工具缓存的空间,但会让依赖那里工具的 setup 步骤出错。每次运行,删掉几个 GB 都要花时间。
GitHub 的大型运行器磁盘更大吗?
是的: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%,所以它不会像自托管运行器的磁盘那样被填满。自己要写几十 GB 的作业,M 和 L 给足空间。
试用要花多少钱?
不花钱。试用为期 7 天 或 3,000 作业分钟,以先到者为准,无需绑卡,使用 S 的机器。把磁盘不够用的作业改为 runs-on: skipbox,再删掉那些删除预装工具的步骤。
更新于 2026年11月16日