docker compose 在每個 GitHub Actions 作業都拉取所有映像檔:怎麼不再一直拉同樣的映像檔
docker compose up 在每個 GitHub Actions 作業都拉取所有映像檔,是因為 GitHub 託管 Runner 上的每個作業都從一台新的 VM 開始。Postgres、Redis、訊息佇列、你自己的服務映像檔:沒有一個在磁碟上,所以在第一個測試執行之前,Compose 要把它們全部下載並解開。要不再一直拉同樣的映像檔,方法就是在還留著它們的機器上執行作業。
Skipbox 就是那台機器。你的作業在帳號的專屬機器上執行,這台機器在作業之間保留 Docker 的映像檔、層和建置快取。docker compose up 會找到上次拉取的東西,然後直接啟動容器。改一行 runs-on: skipbox,每月固定 $39,分鐘數不限。
為什麼每個作業都要拉取
- 每個作業一台新的 VM。 GitHub 的 Runner 參考文件(2026 年 11 月 14 日讀取)說,每個 GitHub 託管 Runner 都是一台由 GitHub 託管的新虛擬機器(VM)。上一個作業拉取的東西都不在上面。
- Compose 會拉取缺少的東西。 預設的
pull_policy是missing:只有在平台快取中找不到映像檔時,Compose 才會拉取。在新的 VM 上,每個映像檔都找不到。 - 拉取就是下載加解開。 每一層都要下載、解壓縮,再寫進 VM 的磁碟。私有儲存庫的
ubuntu-latest只有 2 顆 CPU 和 14 GB 的 SSD 來做這件事。
所以第一個測試之前的時間,取決於你 compose 檔案的大小,而且每次推送都要全額付一次。
在 GitHub 託管 Runner 上能做什麼
這些選項只是把下載移到別處;沒有一個能把它去掉。
| 選項 | 每個作業仍然要做的事 | 限制 |
|---|---|---|
docker save + actions/cache + docker load | 下載封存檔,再把每個映像檔載入 Docker | 算進 GitHub 每個儲存庫 10 GB 的額度,和其他所有快取共用 |
更小的映像檔(-alpine、-slim) | 全部拉取,只是更快 | 只到每個映像檔有小型版本為止 |
| 每個作業少一點服務 | 拉取較少的映像檔 | 需要完整環境的測試還是要拉全部 |
每一項都是讓一台健忘的機器少忘一點的方法。只有機器記得的時候,拉取才會消失。
Skipbox 把映像檔留在你的機器上
每個方案都附有一台你帳號專屬、在作業之間保留下來的機器:
- 映像檔留在磁碟上。
docker compose up會找到上次拉取的映像檔,直接開始啟動容器。 - 只下載有變動的部分。
docker compose pull會抓取有變動的層,其餘的重複使用。 - 你自己的服務映像檔從快取建置。
docker compose build會重複使用上一次建置的層,不需要cache-from或cache-to。 - 每個作業都乾淨地開始。 每個作業結束後,Skipbox 會移除所有容器,並刪除 registry 的登入資訊(
~/.docker/config.json)。下一個作業會從已經在磁碟上的映像檔,重新啟動它的服務。 - 有足夠的空間。 S 的磁碟有 80 GB,GitHub 的 Runner 是 14 GB。在作業之後磁碟快滿之前,什麼都不會被刪除;快滿時會先刪除 dangling 映像檔,再刪除最久沒用的建置快取。
除了 runs-on,工作流程不用改:
jobs:
integration:
runs-on: skipbox # was ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: docker compose up -d --wait
- run: npm ci && npm run test:integration
如果你用 actions/cache 和 docker load 保存過映像檔,把那些步驟刪掉。Skipbox 上的第一個作業會把每個映像檔拉取一次。第二個作業就會在機器上找到它們。
作業依標籤選擇規格:
| 標籤 | 機器 | 磁碟 | 方案 |
|---|---|---|---|
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 |
同樣的分鐘數,固定的價格
整合測試是跑得久的作業,所以按分鐘計費的帳單就是跟著它們增加。在 Skipbox 上,分鐘數不限:
| 每月分鐘數(4 vCPU) | GitHub | Skipbox S | 每月省下 |
|---|---|---|---|
| 10,000 | $102 | $39 | $63 |
| 20,000 | $222 | $39 | $183 |
| 30,000 | $342 | $39 | $303 |
GitHub 的金額已扣除 GitHub Team 的內含用量。把你自己的分鐘數填進首頁的費用試算。
換過去只要改一行
- 使用 GitHub 登入 Skipbox。
- 安裝 Skipbox GitHub App,並選擇儲存庫。
- 修改整合測試作業的
runs-on並推送。
在同一個工作流程裡也建置映像檔?GitHub Actions 的 Docker 層快取涵蓋了 docker build 和 buildx。
安全性
- 機器只屬於你的帳號。其他公司的作業不會在上面執行。
- 每個作業結束後,Runner 的憑證、程序和容器都會被清除,
~/.docker/config.json也是,所以 registry 的登入資訊不會延續到下一個作業。開啟「每個作業都用新 VM」,每個作業就會改用一台全新的機器。 - 沒有寫入權限的人提交的程式碼(例如來自 fork 的 Pull Request),會在全新、用完即丟的機器上執行,絕不會在你的機器上。
詳情請見作業如何隔離。
用你的整合測試試試看
試用免費,為期 7 天或 3,000 作業分鐘,以先到者為準,不需信用卡。把作業改成 runs-on: skipbox,執行兩次,再把第二次執行的 docker compose up 和 GitHub 上的並排比較。
常見問題
我們在 GitHub Actions 上以 docker compose 為基礎的整合測試,大部分時間都花在拉取映像檔。怎麼避免每個作業都拉同樣的映像檔?
把作業放在會保留磁碟的機器上執行。GitHub 託管 Runner 每個作業都是一台新的 VM,所以沒有任何映像檔會留下來,compose 又要全部拉一次。在 Skipbox 上,作業在你帳號的專屬機器上執行,這台機器在作業之間保留 Docker 的映像檔:docker compose up 會找到上次拉取的映像檔,然後直接啟動容器。只要改一行 runs-on: skipbox,每月固定 $39,分鐘數不限。
為什麼 docker compose 在每個 GitHub Actions 作業都要再拉一次映像檔?
因為映像檔不在機器上時 Compose 就會拉取,而在 GitHub 託管 Runner 上它從來都不在。GitHub 的 Runner 參考文件說,每個 GitHub 託管 Runner 都是一台新的虛擬機器;上一個作業拉取的東西都不在上面。Compose 預設的 pull_policy 是 missing,如果映像檔在那裡,就會略過拉取。
可以用 actions/cache 快取 docker compose 的映像檔嗎?
可以,但只是把下載移到別處。docker save 把映像檔寫成 tar 檔,actions/cache 儲存它,下一個作業還原它再執行 docker load。每個作業還是要下載整個封存檔,再把它載入 Docker,而且封存檔要算進 GitHub 每個儲存庫 10 GB 的快取,和你的相依套件快取共用。在保留磁碟的機器上,沒有東西需要 save 或 load。
Skipbox 會在作業之間保留 Docker 映像檔嗎?
會。每個方案都附有一台你帳號專屬、在作業之間保留下來的機器,它會把 Docker 的映像檔、層和建置快取留在磁碟上:S 有 80 GB,M 有 160 GB,L 有 320 GB。每個作業結束後,容器會被移除,registry 的登入資訊會被刪除;映像檔則留下來。
compose 檔案裡的映像檔有變動時會怎樣?
只會下載有變動的層。想讓每個作業都檢查 registry 時,在 docker compose up 前面加上 docker compose pull:Docker 會抓取新的層,並重複使用已經在機器磁碟上的層。你用 docker compose build 自己建置的映像檔,也會以同樣的方式重複使用上一次建置的層。
試用要花多少錢?
不用錢。試用為期 7 天或 3,000 作業分鐘,以先到者為準,不需信用卡。把你的整合測試作業改成 runs-on: skipbox,執行兩次,再把第二次執行的 docker compose up 和 GitHub 上的比較。
更新於 2026年11月14日