CI/CD / 系统课时

理解一次构建多处部署

理解一次构建多处部署

这一课解决一个常见发布隐患:测试环境和生产环境分别重新构建,导致“代码相同但产物不同”。正确做法是只生成一次不可变制品,再让它按门禁从测试、预发布一路晋级到生产。

学习目标

  • 解释为什么同一提交不应在不同环境重复构建
  • 用校验和证明多个环境部署的是同一份制品
  • 区分“制品内容”和“环境配置”的职责边界

一次构建解决什么问题

如果测试环境执行一次 build,生产环境上线前再执行一次,即使两次都来自同一 Git 提交,也不能天然视为同一个产物。依赖仓库内容、基础镜像标签、构建时间、插件版本或网络资源都可能在两次构建之间发生变化。

“一次构建多处部署”要求流水线在构建阶段产出一个具有明确版本和摘要的制品,例如 orders-1.8.3.jar、容器镜像摘要或压缩包。后续环境只做获取、校验和部署,不重新编译源代码。

同一制品从构建阶段依次晋级到测试预发布和生产环境

用摘要验证制品没有被替换

最直接的验证方法是记录制品摘要,并在每个环境部署前重新计算。下面示例假设构建阶段已经生成 dist/orders-1.8.3.jar,流水线把它复制到三个发布目录,再比较 SHA-256。

bash
set -euo pipefail

ARTIFACT="dist/orders-1.8.3.jar"
EXPECTED_SHA="$(sha256sum "$ARTIFACT" | awk '{print $1}')"

for ENV in test staging production; do
  mkdir -p "release/$ENV"
  cp "$ARTIFACT" "release/$ENV/orders-1.8.3.jar"
  ACTUAL_SHA="$(sha256sum "release/$ENV/orders-1.8.3.jar" | awk '{print $1}')"

  if [ "$ACTUAL_SHA" != "$EXPECTED_SHA" ]; then
    echo "$ENV: checksum mismatch"
    exit 1
  fi

  echo "$ENV: $ACTUAL_SHA"
done

预期输出

text
test: <VALUE>
staging: <VALUE>
production: <VALUE>

三行中的 <VALUE> 应完全相同;真实摘要取决于制品内容。如果某个环境重新构建或制品被覆盖,摘要就可能不同,流水线应在部署前直接失败。

制品与环境配置要分离

“一次构建”不等于所有环境使用完全相同的运行参数。数据库地址、外部服务端点、日志级别、密钥等环境差异应在部署阶段注入,而不是写进制品后为每个环境重新打包。

因此可以把发布对象理解为两部分:不可变制品回答“运行哪一版代码”,环境配置回答“这一版代码在这里如何运行”。只要配置注入不会改写制品本体,同一摘要就可以安全地跨环境晋级。

什么时候才需要重新构建

只有当源代码、依赖锁定文件、构建脚本或其他会改变制品字节的输入发生变化时,才应产生新的构建。环境从测试晋级到生产本身不是重新构建的理由。

落地时,把“构建”和“部署”拆成两个阶段:构建阶段只负责生成并登记制品,部署阶段只消费已登记制品并注入环境配置。这样测试通过的对象就是最终上线的对象,环境差异也不会偷偷变成产物差异。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解一次构建多处部署

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

登录哪都通