「The runner has received a shutdown signal」:原因,以及有足夠記憶體修好它的 Runner
你的作業以「The runner has received a shutdown signal」結束,沒有 exit code。在 GitHub 託管 Runner 上,GitHub 的維護者確認的原因是記憶體:私有儲存庫的 ubuntu-latest 只有 8 GB,一旦用光,VM 就會在任何記憶體不足的訊息寫進紀錄之前停止。每次重試都在燒分鐘數,也擋住合併。
Skipbox 以固定價格給作業它需要的記憶體:runs-on: skipbox 是 16 GB,每月 $39;skipbox-16x32 是 32 GB,每月 $149,分鐘數不限。
這則訊息是什麼意思
Runner 應用程式的程序在作業進行中被要求停止時,就會記錄這則訊息:「The runner has received a shutdown signal. This can happen when the runner service is stopped, or a manually started runner is canceled.」,意思是 Runner 服務被停止,或手動啟動的 Runner 被取消時都可能發生。接著步驟會以「The operation was canceled.」結束,沒有 exit code,因為你的指令沒有一個失敗。
| 紀錄顯示 | 發生了什麼 |
|---|---|
| shutdown 那一行,沒有 exit code,也沒有人取消執行 | VM 的記憶體用光,停掉了 |
Process completed with exit code 137. | 核心為了記憶體終止了一個程序;Runner 還活著 |
| shutdown 那一行,而執行頁面顯示它被取消了 | 較新的執行、某個人或逾時結束了它 |
在 actions/runner-images issue #15202 中,一位 GitHub 維護者在 8 GB 的 ubuntu-24.04 Runner 上重現了這個問題:在記憶體加 swap 以內的作業通過,超過的作業就以這則訊息失去 Runner。新的映像檔可能在你這邊什麼都沒改的情況下觸發它,原因是新的預設工具版本比舊的需要更多記憶體。
停在 8 GB 的代價
每次失去的執行,都是白白計費的分鐘數、一次重新執行,以及一個無法合併的 Pull Request。繞過它也是工作:
- 減少測試 worker、
make -j或 Gradle 的 worker 數,讓作業跑得更慢 - 限制 Node 的
--max-old-space-size或 JVM 的-Xmx - 把一個作業拆成好幾個,再把它們接回去
- 固定某個工具版本,直到有人有時間修好它
記憶體需求只會增加:更大的測試套件、更大的建置、程式設計代理推送修正帶來的更多作業。GitHub 的答案是大型 Runner,每一分鐘都計費:
| 記憶體 | 有這個記憶體的 GitHub Runner | 每月 20,000 分鐘 | Skipbox | 每月,分鐘數不限 |
|---|---|---|---|---|
| 16 GB | 4 核心大型 Runner,每分鐘 $0.012 | $222 | skipbox,S 方案 | $39 |
| 32 GB | 8 核心大型 Runner,每分鐘 $0.022 | $422 | skipbox-16x32,L 方案 | $149 |
GitHub 的金額以 GitHub Team 計算,已扣除它的內含運算額度;大型 Runner 需要 Team 或 Enterprise Cloud。在首頁的費用試算查看你自己的分鐘數。
你自己的自架 Runner 在 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 以自架 Runner 的形式註冊,所以它的作業不用你的任何 GitHub 分鐘數,也不會在 Actions 預算那裡停下來。超出方案機器容量的作業會排隊等候。
更快的重新執行
每個方案都是為你的帳號保留的一台 VM。Docker 映像檔、層和建置快取、套件快取和工具快取都留在它的磁碟上,所以下一次執行會帶著它們開始,而不是全部重新下載。
不用照顧的機器
Skipbox 讓映像檔保持更新、清除每個作業的憑證、程序和容器(從 2026 年 11 月 13 日起,checkout 和 Cargo 的 target/ 會留下來)、在每個作業後對機器做健康檢查,並重建檢查失敗的機器。VM 執行 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 App,並選擇儲存庫。
- 修改
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」是什麼意思?
Runner 應用程式在你的作業執行中被要求停止。在 GitHub 託管 Runner 上,你並沒有停止任何東西:作業底下的 VM 消失了,最常見的原因是作業用光了它所有的記憶體。Skipbox 的 skipbox 和 skipbox-16x32,以每月固定價格給作業 16 或 32 GB。
為什麼我的作業沒有錯誤就被取消了?
紀錄以 shutdown 那一行和「The operation was canceled.」結束、沒有 exit code 時,表示是 Runner 消失了,而不是某個步驟失敗。一位 GitHub 維護者在 actions/runner-images issue #15202 中確認,記憶體一用光,VM 就會在記憶體不足的訊息寫進紀錄之前停止回應。給作業更多記憶體:在 Skipbox 上只要改一行 runs-on。
這是記憶體不足的錯誤嗎?
在託管 Runner 上,通常是。作業被終止但 Runner 還活著時,會顯示 exit code 137;作業把整台 VM 拖垮時,就會顯示 shutdown 那一行。不論哪一種,作業需要的都比 ubuntu-latest 的 8 GB 多,而每個 Skipbox 方案都以固定價格提供更多。
為什麼自架 Runner 也會出現這則訊息?
有東西在作業進行中停止了 Runner 程序或它的機器:服務重新啟動、為了更新而重新開機、自動擴充工具移除了機器,或主機的記憶體用光。在 Skipbox 上,機器由我們替你管理,每個作業後都會做健康檢查,檢查失敗的機器會自動重建。
Skipbox 的免費試用能修好記憶體用光的作業嗎?
它給作業 2 倍的記憶體。試用以 4 vCPU 和 16 GB 執行 runs-on: skipbox 的作業,私有儲存庫的 ubuntu-latest 只有 8 GB。需要更多記憶體,就用 L 方案的 runs-on: skipbox-16x32(32 GB)。
更新於 2026年11月11日