怎麼加速 GitHub Actions:一個槓桿一個槓桿,砍掉 25 分鐘的流水線
25 分鐘的 GitHub Actions 流水線,通常是四種延遲疊在一起:作業互相等待、不需要跑的工作、空白 VM 每個作業都要重複的準備工作,以及擠在 2 顆核心上的 CPU 密集步驟(私有儲存庫的 ubuntu-latest 只有 2 顆 CPU 和 8 GB)。請依這個順序處理。先測量關鍵路徑,排隊時間另外看。然後略過不需要跑的、同時執行彼此獨立的作業、別再重建狀態、給重的步驟更多核心,最後對仍然很長的部分分片。前三項是不用花錢的工作流程修正。其餘的是機器:一台在作業之間保留快取、核心更多的 Runner。
Skipbox 就是那個 Runner。你的作業在帳號的專屬機器上執行,這台機器在作業之間保留 Docker 層、套件快取、工具和建置輸出,有 4 到 16 vCPU,每月固定 $39,分鐘數不限。在 astro 的 CI 上,這是 GitHub 上 528 秒和 Skipbox 上 30 秒的差別。換過去只要改一行:runs-on: skipbox。
1. 測量關鍵路徑
你的團隊等待的時間,是最後結束的那條作業鏈,而不是每個作業的加總。打開一個有代表性的 Pull Request 的執行:關係圖顯示哪些作業在等哪些,每個作業的紀錄則顯示它的步驟時間。針對最慢的那條鏈,記下:
| 階段 | 要檢查什麼 |
|---|---|
| 排隊 | 作業有沒有在等 Runner?更快的指令縮短不了佇列 |
| 設定作業、checkout | 拉取了容器映像檔、在淺層複製就夠的地方做了完整複製 |
| 工具鏈和安裝 | 快取有沒有命中,命中省下的時間是否比還原花的還多? |
| 建置 | 同樣的輸出是否在另一個作業裡也建置了一次? |
| 測試 | Runner 的 CPU 是一直很忙,還是一個 worker 在做所有的事? |
| 上傳 | 有用的工作做完之後的 artifact 和快取儲存 |
把一次預熱後的執行和一次冷執行比較。一半時間沒命中的快取,在平均值裡看起來沒問題。
2. 略過不需要跑的
- 取消被取代的執行。 第一次之後的每次推送,都讓正在進行的執行失去意義。帶有
cancel-in-progress的 concurrency 群組會停止它。把範圍限定在 Pull Request,這樣推送到預設分支時絕不會取消部署:
concurrency:
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
cancel-in-progress: ${{ github.event_name == 'pull_request' }}
- 只執行變更動到的部分。
paths:篩選會在只改文件時略過工作流程;在 monorepo 中,turbo run test --affected或 Nx 的 affected 指令只會執行有變動的套件。觸發條件層級的篩選會讓必要檢查永遠不回報,所以當檢查是必要的時候,就在作業內部篩選。
3. 同時執行彼此獨立的作業
除非 needs: 把作業串起來,GitHub 會平行執行它們。Lint、型別檢查、單元測試和建置很少需要彼此:讓它們一起開始,只讓打包或部署等它們全部完成。如果兩個作業建置同樣的東西,就建置一次,再用 actions/upload-artifact 傳遞,並把上傳和下載的時間算進去。
4. 別再重建同樣的狀態
長流水線的大部分時間都花在這裡。GitHub 託管 Runner 上的每個作業都從新的 VM 開始,所以它每次都要下載工具鏈、安裝相依套件、重建 Docker 層,並從零開始編譯。
- 真正會命中的快取。
actions/setup-node的cache: npm(以及它的 pnpm 和 yarn 形式),以 lockfile 為 key 儲存套件管理器下載的檔案;它不會儲存node_modules,所以安裝還是要跑。GitHub 每個儲存庫保留 10 GB,7 天沒用到的項目會被移除,而命中仍然是一次下載到新 VM 上(快取容量上限)。 - 工具快取。
eslint --cache、tsc --incremental、Jest 的快取目錄和 turbo 的.turbo/cache,儲存的是工作本身,而不是下載的檔案。在全新的 VM 上,除非你也還原它們,否則都是空的。 - Docker 層。 在全新 VM 上的
docker build一開始沒有任何層;繞過的方法是用 buildx 的cache-to匯出,每次執行再匯入(Docker 層快取)。
保留磁碟的機器會自己做完這一切:快取、工具快取、層和建置輸出,從上一個作業起就在那裡。
5. 給重的步驟更多核心
編譯器、打包工具和測試執行器每顆核心啟動一個 worker,所以在 2 顆 CPU 上,它們一次跑兩個。檢查測試執行器實際用了多少:Jest 預設是核心數減一(在 2 顆 CPU 上是一個 worker),pytest 在加上 -n auto 之前是循序執行,Playwright 預設是核心數的一半,而它的文件建議在 CI 上用一個 worker。只有在告訴執行器去用時,更多核心才有幫助,而且只對讓 CPU 一直忙著的步驟有效;下載或資料庫啟動不會變快。
在 GitHub 上,更多核心意味著大型 Runner:4 到 96 核心,只限 GitHub Team 或 Enterprise Cloud 的組織,按分鐘計費,每核心的費率更高。
6. 對仍然很長的部分分片
分片矩陣把一個很長的測試套件拆到多個作業上。它縮短的是實際經過的時間,不是分鐘數:每個分片都要重新 checkout、安裝和建置,所以四個分片要付四次準備工作。依測量的時間平衡分片,而不是依檔案數,當準備工作占了每個分片的大部分時,就別再增加分片。
一直慢下去的代價
一條 15 分鐘的流水線一天跑 40 次,就是每天分散在你團隊身上的 10 小時等待,還沒算上切換工作的成本。在按分鐘計費下,準備工作的分鐘數和測試的分鐘數一樣計費:
| 每月分鐘數(4 vCPU) | GitHub | Skipbox S | 每月省下 |
|---|---|---|---|
| 10,000 | $102 | $39 | $63 |
| 20,000 | $222 | $39 | $183 |
| 30,000 | $342 | $39 | $303 |
在 GitHub 上,核心越多每分鐘越貴,所以機器越大,差距越大:
| 每月 20,000 分鐘 | GitHub | Skipbox | 每月省下 |
|---|---|---|---|
| 8 vCPU | $422 | $79(M) | $343 |
| 16 vCPU | $822 | $149(L) | $673 |
GitHub 的金額已扣除 GitHub Team 的內含用量。把你自己的分鐘數填進首頁的費用試算試試看。
解法就是機器的時候
真實專案自己的 CI 作業,步驟沒有修改,在 GitHub 的公開儲存庫 Runner(4 vCPU,16 GB)和同樣 vCPU 的 Skipbox 專屬機器上執行,依我們用它們的工作流程執行的結果:
| 專案 | GitHub | Skipbox,專屬機器 | 機器保留了什麼 |
|---|---|---|---|
| astro(Node.js、Turborepo) | 528 秒 | 30 秒 | turbo 的快取:重播了 40 個建置任務 |
| tauri(Rust) | 246 秒 | 53 秒 | Cargo 的 target/:沒有任何 crate 被重新編譯 |
| ripgrep(Rust) | 200 秒 | 40 秒 | cross 的 target/ 和 Docker 映像檔 |
| vite(Node.js) | 141 秒 | 100 秒 | 套件快取;其餘是它的測試在跑 |
私有儲存庫的 ubuntu-latest,核心數只有上面 GitHub 執行的一半。
Skipbox 為你的流水線做了什麼
保留機器。 每個方案都附有一台你帳號專屬、在作業之間保留下來的機器。Docker 映像檔、層和建置快取、套件快取、工具快取,以及連同 Cargo 的 target/ 和 turbo 快取的 checkout,都留在它的磁碟上:至少是 GitHub 快取空間的 7 倍,沒有 key、沒有 7 天的期限,也沒有分支規則。
以固定價格增加核心。 作業依標籤選擇規格:
| 標籤 | 機器 | 方案 |
|---|---|---|
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 分鐘數,所以 GitHub 預算絕不會讓它們停下來。
自己照顧自己。 Skipbox 負責佈建機器、讓映像檔保持更新、在每個作業後清理環境,並重建健康檢查失敗的機器。
換過去只要改一行
jobs:
test:
runs-on: skipbox # was ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm
- run: npm ci && npm test
- 使用 GitHub 登入 Skipbox。
- 安裝 Skipbox GitHub App,並選擇儲存庫。
- 修改
runs-on並推送。
你的步驟和 Action 照原樣在裝有 Docker、Node.js 和 Python 的 Ubuntu 24.04 上執行。
安全性
- 機器只屬於你的帳號。其他公司的作業不會在上面執行。
- 每個作業結束後,Runner 的憑證、程序和容器都會被清除,保留下來的 checkout 中的 Git 憑證和未追蹤的檔案也是。開啟「每個作業都用新 VM」,每個作業就會改用一台全新的機器。
- 沒有寫入權限的人提交的程式碼(例如來自 fork 的 Pull Request),會在全新的 VM 上執行,可以讀取你的快取但不能修改。
詳情請見作業如何隔離。
用你最慢的作業試試看
試用免費,為期 7 天或 3,000 作業分鐘,以先到者為準,不需信用卡。把關鍵路徑上的作業改成 runs-on: skipbox,執行兩次,再把第二次執行的步驟時間和 GitHub 上的並排比較。
常見問題
我們的 GitHub Actions 流水線要 25 分鐘。讓它變快最快的方法是什麼?
依順序處理。讀執行的關係圖和步驟時間,找出決定總時間的那條作業鏈,排隊時間另外看。取消被取代的執行,略過檔案沒有變動的作業。拿掉只是出於習慣的 needs:,讓彼此獨立的作業同時執行。別在每個作業都重建狀態:用真正會命中的快取,或保留磁碟的 Runner。給 CPU 密集的步驟更多核心,並讓測試執行器用上它們。只對仍然很長的部分分片。在私有儲存庫的 ubuntu-latest(2 顆 CPU,8 GB)上,最後三項常常就占了 25 分鐘的大部分,而它們都是機器的問題:Skipbox 給作業一台在作業之間保留快取的專屬機器,有 4 到 16 vCPU。
換更快的 Runner,和最佳化工作流程相比值得嗎?
先做免費的工作流程修正:取消被取代的執行、路徑篩選和拿掉不必要的 needs: 都不用花錢,也沒有任何 Runner 會替你做。之後,看看剩下的時間花在哪裡。每個作業都重複的準備工作(工具鏈、相依套件安裝、Docker 建置),以及讓每顆核心都忙著的步驟,都是機器的問題,而保留快取、核心更多的 Runner,只要改一行 runs-on 就能把它們拿掉。網路等待和循序執行的步驟,不會因為機器變大而變快。
為什麼 GitHub Actions 比我的筆電慢?
你的筆電把套件、工具、Docker 層和建置輸出都留在磁碟上,而且通常有 8 顆以上的核心。私有儲存庫的 ubuntu-latest 作業只拿到 2 顆 CPU 和 8 GB,在一台這些都沒有的新 VM 上。Skipbox 就像你的筆電一樣運作:機器在作業之間保留下來,有 4 vCPU 以上。
把測試分片能讓 GitHub Actions 變快嗎?
它縮短的是實際經過的時間,不是分鐘數。每個分片都是一個新的作業,要重新 checkout、安裝和建置,所以四個分片要付四次準備工作,而按分鐘計費會把每一個都算進去。等準備工作變便宜、Runner 的核心也都用上之後再分片。在 Skipbox 上,準備工作留在磁碟上,分鐘數不限,所以分片不會多花錢。
怎麼讓 GitHub Actions 作業拿到超過 4 顆核心?
在 GitHub 上,大型 Runner 有 4 到 96 核心,只提供給 GitHub Team 或 Enterprise Cloud 上的組織,按分鐘計費。在 Skipbox 上,把 runs-on 改成 skipbox-8x16 就有 8 vCPU,改成 skipbox-16x32 就有 16 vCPU,每月固定價格,組織和個人帳號都一樣。
試用要花多少錢?
不用錢。試用為期 7 天或 3,000 作業分鐘,以先到者為準,不需信用卡。把你最慢的作業的 runs-on 改成 skipbox,執行兩次,再比較它的步驟時間。
更新於 2026年11月13日