Skipbox

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 上能做什麼

這些選項只是把下載移到別處;沒有一個能把它去掉。

每一項都是讓一台健忘的機器少忘一點的方法。只有機器記得的時候,拉取才會消失。

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 上,分鐘數不限:

GitHub 的金額已扣除 GitHub Team 的內含用量。把你自己的分鐘數填進首頁的費用試算。

換過去只要改一行

  1. 使用 GitHub 登入 Skipbox。
  2. 安裝 Skipbox GitHub App,並選擇儲存庫。
  3. 修改整合測試作業的 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日

快取隨時熱機,CI/CD 更快

固定價格的專屬熱機 Runner

機器由 Skipbox 代管。你只要改一行。滿載使用時只要 GitHub 的 1/12。價格固定,可以整天跑。快取空間是 GitHub 的 7 倍。

  • 不需信用卡
  • 使用 GitHub 登入
  • 隨時可取消