“The runner has received a shutdown signal”:原因,以及一个内存够用的运行器
你的作业以 "The runner has received a shutdown signal" 结束,没有退出码。在 GitHub 托管的运行器上,GitHub 维护者确认的原因是内存:私有仓库的 ubuntu-latest 只有 8 GB,一旦用光,虚拟机就会在任何内存不足的日志写出来之前停下。每次重试都在烧分钟数,合并也被卡住。
Skipbox 以固定价格给作业它需要的内存:runs-on: skipbox 有 16 GB,每月 $39;skipbox-16x32 有 32 GB,每月 $149,分钟数不限。
这条消息是什么意思
运行器程序的进程在作业期间被要求停止时,会记下这条日志:"The runner has received a shutdown signal. This can happen when the runner service is stopped, or a manually started runner is canceled." 随后步骤以 "The operation was canceled." 结束,没有退出码,因为你的命令一个都没有失败。
| 日志显示 | 发生了什么 |
|---|---|
| 关闭消息,没有退出码,没人取消运行 | 虚拟机内存耗尽,宕掉了 |
Process completed with exit code 137. | 内核因为内存终止了一个进程;运行器还活着 |
| 关闭消息,运行页面显示它被取消了 | 更新的一次运行、某个人或超时结束了它 |
在 actions/runner-images issue #15202 中,一位 GitHub 维护者在 8 GB 的 ubuntu-24.04 运行器上复现了它:内存加 swap 以内的作业通过了,超出的作业以这条消息丢失了运行器。新镜像可能在你什么都没改的情况下触发它:新的默认工具版本比旧版本需要更多内存。
守着 8 GB 的代价
每次丢失的运行,都是白白计费的分钟数、一次重跑,以及一个合并不了的拉取请求。绕开它也是工作:
- 减少测试工作进程、
make -j或 Gradle 的工作进程数,让作业跑得更慢 - 给 Node 的
--max-old-space-size或 JVM 的-Xmx设上限 - 把一个作业拆成几个,再把它们接回去
- 把某个工具钉在旧版本,直到有人有空去修
对内存的需求只会增长:更大的测试套件、更大的构建、编程智能体推送修复带来的更多作业。GitHub 的答案是大型运行器,按每一分钟计费:
| 内存 | 有这么多内存的 GitHub 运行器 | 每月 2万分钟 | Skipbox | 每月,分钟数不限 |
|---|---|---|---|---|
| 16 GB | 4 核大型运行器,每分钟 $0.012 | $222 | skipbox,S 套餐 | $39 |
| 32 GB | 8 核大型运行器,每分钟 $0.022 | $422 | skipbox-16x32,L 套餐 | $149 |
GitHub 的金额按 GitHub Team 计算,已减去其包含的计算用量;大型运行器需要 Team 或 Enterprise Cloud。在首页的计算器里查查你自己的分钟数。
你自己的自托管运行器在 GitHub 的账单上不花钱,但每当它的服务重启、主机为打补丁重启或自动扩缩器把机器撤掉时,都会显示同样的消息。把它运行好,就是服务器、打补丁、清理和扩容。
Skipbox 解决它
内存,固定价格
runs-on | 机器 | 套餐,每月 |
|---|---|---|
skipbox | 4 vCPU,16 GB | S,$39 |
skipbox-8x16 | 8 vCPU,16 GB | M,$79 |
skipbox-16x32 | 16 vCPU,32 GB | L,$149 |
分钟数不限。Skipbox 以自托管运行器的身份注册,所以它的作业不消耗你的任何 GitHub 分钟数,也不会停在 Actions 预算上。超出套餐机器数量的作业排队等待。
重跑更快
每个套餐都是一台为你的账号保留的虚拟机。Docker 镜像、层和构建缓存、包缓存和工具缓存都留在它的磁盘上,所以下一次运行带着它们启动,而不是把所有东西重新下载一遍。
一台不用你照看的机器
Skipbox 让镜像保持最新,清除每个作业的凭据、进程和容器(从 2026年11月13日起,检出目录和 Cargo 的 target/ 会保留),在每个作业后对机器做健康检查,并重建检查失败的机器。虚拟机运行 Ubuntu 24.04,带有 Docker、Node.js 和 Python。
切换只需改一行
jobs:
build:
runs-on: skipbox # was ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm ci && npm test
- 使用 GitHub 登录 Skipbox。
- 安装 Skipbox GitHub 应用,并选择仓库。
- 修改
runs-on并推送。
skipbox 在每个套餐上都能运行,skipbox-16x32 在 L 套餐上运行。想换回去,把这一行改回去即可。
用你自己的作业试试
试用免费,为期 7 天 或 3,000 作业分钟,以先到者为准,无需绑卡。试用以 4 vCPU、16 GB 运行 runs-on: skipbox 作业,是私有仓库 ubuntu-latest 内存的 2 倍,所以把内存不够的作业移过来,看它带着保留的缓存跑完,再为需要更多内存的作业选 L 套餐。
常见问题
“The runner has received a shutdown signal” 是什么意思?
运行器程序在你的作业运行期间被要求停止。在 GitHub 托管的运行器上,你并没有停止任何东西:作业底下的虚拟机没了,最常见的原因是作业用光了它的全部内存。Skipbox 的 skipbox 和 skipbox-16x32 以按月固定价格给作业 16 或 32 GB。
为什么我的作业没有任何错误就被取消了?
日志以这条关闭消息和 “The operation was canceled.” 结尾、又没有退出码时,是运行器丢失了,而不是某个步骤失败。一位 GitHub 维护者在 actions/runner-images issue #15202 中确认,内存一旦耗尽,虚拟机会在内存不足的消息写进日志之前就失去响应。给作业更多内存:在 Skipbox 上,只需改一行 runs-on。
这是内存不足的错误吗?
在托管运行器上,通常是。作业被终止而运行器还活着时,显示的是退出码 137;作业把整台虚拟机拖垮时,显示的是这条关闭消息。不管哪种,作业需要的都超过了 ubuntu-latest 的 8 GB,而 Skipbox 的每个套餐都以固定价格提供更多。
为什么自托管运行器也会显示它?
有什么东西在作业中途停掉了运行器进程或它的机器:服务重启、为了更新而重启、自动扩缩器移除了机器,或者主机内存耗尽。在 Skipbox 上,机器由我们替你管理,每个作业后都做健康检查,检查失败的机器自动重建。
Skipbox 的免费试用能解决内存不足的作业吗?
它给作业 2 倍的内存。试用以 4 vCPU、16 GB 运行 runs-on: skipbox 作业,而私有仓库的 ubuntu-latest 只有 8 GB。需要更多内存,就用 L 套餐的 runs-on: skipbox-16x32(32 GB)。
更新于 2026年11月11日