docker compose 在每个 GitHub Actions 作业里都拉取所有镜像:怎样不再重复拉取同样的镜像
docker compose up 在每个 GitHub Actions 作业里都拉取所有镜像,是因为 GitHub 托管运行器上的每个作业都在一台新虚拟机上启动。Postgres、Redis、消息代理、你自己的服务镜像:一个都不在磁盘上,所以 Compose 在第一个测试运行之前要把它们全部下载并解压。要不再重复拉取同样的镜像,就在一台还留着它们的机器上运行作业。
Skipbox 就是那台机器。你的作业在你账号的专属机器上运行,它在作业之间保留 Docker 的镜像、层和构建缓存。docker compose up 找到上次拉取的东西,直接启动容器。只改一行 runs-on: skipbox,每月固定 $39,分钟数不限。
为什么每个作业都要拉取
- 每个作业一台新虚拟机:GitHub 的运行器参考文档(2026年11月14日查阅)说,每个 GitHub 托管的运行器都是一台由 GitHub 托管的新虚拟机(VM)。上一个作业拉取的东西都不在上面。
- Compose 拉取缺少的镜像:默认的
pull_policy是missing:只有镜像不在平台缓存中时,Compose 才会拉取。在新虚拟机上,每个镜像都是缺少的。 - 拉取就是下载加解压:每一层都要下载、解压,再写到虚拟机的磁盘上。私有仓库的
ubuntu-latest只有 2 个 CPU 和 14 GB SSD 来做这些事。
所以第一个测试之前的时间,取决于你的 compose 文件有多大,每次推送都要全额付一遍。
在 GitHub 托管的运行器上能做什么
这些办法只是把下载换了个地方;没有一个能去掉它。
| 办法 | 每个作业仍然要做什么 | 限制 |
|---|---|---|
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 删除所有容器,并删除镜像仓库的登录信息(
~/.docker/config.json)。下一个作业用磁盘上已有的镜像,重新启动它的服务。 - 放得下它们:S 的磁盘为 80 GB,而 GitHub 的运行器只有 14 GB。作业结束后磁盘快满时才会删除东西;先删悬空镜像,再删最久未用的构建缓存。
除了 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 | 每月节省 |
|---|---|---|---|
| 1万 | $102 | $39 | $63 |
| 2万 | $222 | $39 | $183 |
| 3万 | $342 | $39 | $303 |
GitHub 的金额已减去 GitHub Team 包含的用量。把你自己的分钟数填进首页的计算器。
切换只需改一行
- 使用 GitHub 登录 Skipbox。
- 安装 Skipbox GitHub 应用,并选择仓库。
- 修改集成测试作业的
runs-on并推送。
同一个工作流里还要构建镜像?GitHub Actions 中的 Docker 层缓存讲了 docker build 和 buildx。
安全
- 这台机器只属于你的账号。不会运行其他公司的作业。
- 每个作业结束后,运行器的凭据、进程和容器都会被清除,
~/.docker/config.json也一样,所以镜像仓库的登录不会带到下一个作业。开启“每个作业用新虚拟机”后,每个作业改在一台新机器上运行。 - 没有写入权限的人提交的代码(例如来自复刻的拉取请求)在一台新的一次性机器上运行,从不在你的机器上运行。
详情见作业如何隔离。
用你的集成测试试试
试用免费,为期 7 天 或 3,000 作业分钟,以先到者为准,无需绑卡。把作业改为 runs-on: skipbox,运行两次,再把第二次运行的 docker compose up 与 GitHub 上的并排对比。
常见问题
我们在 GitHub Actions 上基于 docker compose 的集成测试,大部分时间都花在拉取镜像上。怎样避免每个作业都拉取同样的镜像?
在一台保留磁盘的机器上运行作业。GitHub 托管的运行器每个作业都是一台新虚拟机,所以没有镜像能留下来,compose 只好全部重新拉取。在 Skipbox 上,作业在你账号的专属机器上运行,它在作业之间保留 Docker 的镜像:docker compose up 找到上次拉取的镜像,直接启动容器。改动只有一行 runs-on: skipbox,每月固定 $39,分钟数不限。
为什么 docker compose 在每个 GitHub Actions 作业里都要重新拉取镜像?
因为镜像不在机器上时,Compose 就会拉取,而在 GitHub 托管的运行器上,它从来都不在。GitHub 的运行器参考文档说,每个 GitHub 托管的运行器都是一台新的虚拟机;上一个作业拉取的东西都不在上面。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。每个作业结束后,容器会被删除,镜像仓库的登录信息也会被删除;镜像留下来。
compose 文件里的镜像变了会怎样?
只下载有变化的层。想让每个作业都检查一次镜像仓库,就在 docker compose up 之前加上 docker compose pull:Docker 会获取新的层,复用机器磁盘上已有的层。你自己用 docker compose build 构建的镜像,也以同样的方式复用上一次构建的层。
试用要花多少钱?
不花钱。试用为期 7 天 或 3,000 作业分钟,以先到者为准,无需绑卡。把集成测试作业改为 runs-on: skipbox,运行两次,再把第二次运行的 docker compose up 与 GitHub 上的对比。
更新于 2026年11月14日