容器与云原生 / 系统课时
在 CI 中构建镜像
在 CI 中构建镜像
本课介绍如何把 Docker 镜像构建流程接入 CI 流水线,完成代码检出、依赖缓存、镜像构建、元数据记录和日志留存。完成后,提交代码即可自动生成可追踪的镜像产物。
学习目标
- 理解 CI 构建镜像的基本流水线结构
- 配置缓存与镜像元数据,提高构建效率和可追踪性
- 掌握构建日志与产物验证方法
CI 构建镜像的基本流程
CI 中的镜像构建不是简单执行一次 docker build,而是需要围绕代码版本、依赖缓存、镜像标签和构建记录设计完整流程。常见顺序包括检出代码、准备构建环境、恢复缓存、执行构建、推送镜像以及保存日志。

编写构建任务
不同 CI 平台语法不同,但核心步骤一致。下面示例展示一个流水线片段,执行 Docker 构建并写入提交信息作为镜像标签。
yaml
steps:
- name: checkout
run: git checkout <ID>
- name: build-image
run: |
docker build \
--label org.opencontainers.image.revision=<ID> \
-t app:<ID> .预期输出
text
Successfully built image app:<ID>
Label org.opencontainers.image.revision=<ID> recorded实际项目中应将 <ID> 替换为 CI 提供的提交编号,避免不同构建覆盖同一个镜像标签。
使用缓存优化构建速度
Docker 构建缓存可以减少重复下载依赖和重复执行步骤。通常需要优先复制依赖描述文件,再安装依赖,最后复制业务代码,这样代码变化不会导致所有层重新生成。
缓存策略需要结合项目特点调整。依赖更新频率低的项目适合长期缓存,而依赖经常变化的项目需要设置合理失效条件,避免使用旧缓存产生错误结果。
记录元数据与构建日志
生产环境中的镜像不仅需要能运行,还需要能够追溯来源。建议记录提交 ID、构建时间、版本号等信息,并保存 CI 日志用于失败分析。
常见元数据包括镜像作者、源代码地址和构建版本。发生线上问题时,可以通过这些信息快速定位对应代码和构建过程。
按自己的节奏,确认真正理解。