容器与云原生 / 系统课时

在 CI 中构建镜像

在 CI 中构建镜像

本课介绍如何把 Docker 镜像构建流程接入 CI 流水线,完成代码检出、依赖缓存、镜像构建、元数据记录和日志留存。完成后,提交代码即可自动生成可追踪的镜像产物。

学习目标

  • 理解 CI 构建镜像的基本流水线结构
  • 配置缓存与镜像元数据,提高构建效率和可追踪性
  • 掌握构建日志与产物验证方法

CI 构建镜像的基本流程

CI 中的镜像构建不是简单执行一次 docker build,而是需要围绕代码版本、依赖缓存、镜像标签和构建记录设计完整流程。常见顺序包括检出代码、准备构建环境、恢复缓存、执行构建、推送镜像以及保存日志。

CI 镜像构建流水线流程图

编写构建任务

不同 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 日志用于失败分析。

常见元数据包括镜像作者、源代码地址和构建版本。发生线上问题时,可以通过这些信息快速定位对应代码和构建过程。

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

目录与阅读设置

阅读设置

17

记录一个想法

在 CI 中构建镜像

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

登录哪都通