CI/CD / 系统课时

在流水线中构建镜像

在流水线中构建镜像

把本地 docker build 搬进 CI 只是起点,真正需要解决的是构建器放在哪里、它拥有什么权限,以及产出的镜像如何被后续步骤可靠引用。本课用 Buildx 配置一个最小构建步骤,并给出不同 Runner 环境的选择原则。

学习目标

  • 能在 CI Runner 中执行一次可验证的镜像构建
  • 能区分宿主 Docker、Docker-in-Docker 与独立 BuildKit 的边界
  • 能用不可变标签和权限隔离减少流水线中的镜像发布风险

先确定 Runner 能提供什么

镜像构建需要能够创建文件系统层、执行 RUN 指令并输出 OCI 镜像。不同 CI 环境对特权容器、宿主 Socket 和持久缓存的支持不同,因此构建方式应由执行环境决定,而不是所有平台统一套用一种配置。

Runner 环境 更合适的方式 主要注意点
专用 VM 或受信任 Shell Runner Docker Buildx + 独立 Docker daemon 配置简单,但要限制谁能控制 daemon
Kubernetes 或共享 Runner Rootless BuildKit 或远程 BuildKit 隔离更好,需要单独设计缓存与凭证
旧环境必须使用容器内 daemon Docker-in-Docker 常需要更高权限,启动和缓存成本更高

CI Runner 中镜像构建方式的选择关系

配置一个可验证的构建步骤

下面的 Bash 可以直接作为 CI 的一个构建 step。为保证示例独立,它从标准输入提供最小 Dockerfile;实际项目中通常把最后的 - 改为 .,从仓库根目录读取 Dockerfile 和应用源码。

bash
set -euo pipefail

IMAGE_REF="${IMAGE_NAME:-demo-ci}:${GIT_SHA:-local}"

docker buildx create --driver docker-container --use >/dev/null
docker buildx build --load -q -t "${IMAGE_REF}" - <<'EOF'
FROM alpine:3.21
CMD ["echo", "hello from CI image"]
EOF

printf 'built=%s\n' "${IMAGE_REF}"
docker run --rm "${IMAGE_REF}"

预期输出

text
sha256:<ID>
built=demo-ci:local
hello from CI image

<ID> 是构建生成的镜像标识,实际值会变化。--load 适合单平台镜像在当前 Runner 内继续做扫描或测试;发布到远程仓库时通常改用 --push,并在构建前通过 CI 的密钥机制完成仓库登录。

让标签和凭证适合自动化

流水线不要只生成 latest。后续部署、回滚和审计需要知道镜像对应哪一次源码提交,因此应使用提交 SHA、发布版本或流水线 ID 形成不可变标签,并可额外维护一个可移动的环境标签。

仓库用户名、令牌和云端临时凭证应由 CI Secret 注入,不能写进 Dockerfile、构建参数默认值或仓库文件。若构建器支持短期身份令牌,优先使用短期凭证,减少长期密钥泄漏后的影响范围。

选择构建方式时看三个边界

第一看权限边界:不受信任代码能否控制宿主 daemon。第二看缓存边界:Runner 是否会被销毁,缓存是本地层缓存还是远程缓存。第三看产物边界:后续测试需要本地镜像时用 --load,需要直接交付 Registry 时用 --push。

流水线镜像构建的目标不是“在 CI 里成功跑一次 Docker 命令”,而是让同一份源码在明确的权限模型下得到可追踪、可复用、可发布的镜像产物。构建方式一旦与 Runner 的隔离能力匹配,后续扫描、签名和部署步骤才有稳定基础。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

在流水线中构建镜像

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通