容器与云原生 / 系统课时
在镜像内执行测试
在镜像内执行测试
本课介绍如何把静态检查和自动化测试加入 Docker 镜像构建流程,使 CI 在生成发布镜像前自动验证代码质量。完成后,只有通过测试的构建结果才能进入后续发布阶段。
学习目标
- 理解镜像构建阶段执行测试的作用
- 使用多阶段构建隔离测试环境和生产镜像
- 设计失败阻断与测试结果验证流程
为什么在镜像构建阶段测试
如果镜像构建完成后才发现代码错误,会浪费部署时间并增加回滚成本。在 CI 阶段运行测试,可以把质量检查提前到发布之前,让错误在流水线中直接暴露。
测试通常包括代码格式检查、静态分析、单元测试和基础启动验证。测试环境可以包含额外工具,但最终生产镜像应保持精简。
使用多阶段构建分离测试环境
多阶段构建允许在前一个阶段安装测试依赖,在最终阶段只复制经过验证的产物。这样既能执行完整测试,又不会把测试工具带入运行镜像。
dockerfile
FROM node:22 AS test
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm test
FROM node:22-slim AS runtime
WORKDIR /app
COPY --from=test /app .
CMD ["node", "server.js"]预期结果
text
npm test
PASS all tests completed
Successfully built runtime image如果测试命令失败,Docker 构建会停止,后续镜像不会生成。
将测试结果反馈给 CI
CI 系统需要收集测试退出状态和日志。退出码为 0 表示通过,非 0 表示失败,流水线应阻止镜像推送和部署操作。
bash
docker build -t app:<ID> .
result=$?
if [ $result -ne 0 ]; then
echo "image validation failed"
exit $result
fi预期输出
text
image validation failed示例中的 <ID> 表示构建版本标识,实际值由 CI 环境提供。失败时应保留完整日志,方便开发人员定位问题。
测试阶段的常见边界
测试环境和生产环境并不完全相同,因此需要明确测试范围。依赖外部数据库、消息队列或第三方服务的测试,应通过专用测试环境或模拟服务完成。
同时要避免把敏感配置写入镜像层。测试密钥、临时文件和调试工具应通过 CI 密钥管理或临时挂载方式提供。
按自己的节奏,确认真正理解。