CI/CD / 系统课时
理解一次构建多处部署
理解一次构建多处部署
这一课解决一个常见发布隐患:测试环境和生产环境分别重新构建,导致“代码相同但产物不同”。正确做法是只生成一次不可变制品,再让它按门禁从测试、预发布一路晋级到生产。
学习目标
- 解释为什么同一提交不应在不同环境重复构建
- 用校验和证明多个环境部署的是同一份制品
- 区分“制品内容”和“环境配置”的职责边界
一次构建解决什么问题
如果测试环境执行一次 build,生产环境上线前再执行一次,即使两次都来自同一 Git 提交,也不能天然视为同一个产物。依赖仓库内容、基础镜像标签、构建时间、插件版本或网络资源都可能在两次构建之间发生变化。
“一次构建多处部署”要求流水线在构建阶段产出一个具有明确版本和摘要的制品,例如 orders-1.8.3.jar、容器镜像摘要或压缩包。后续环境只做获取、校验和部署,不重新编译源代码。

用摘要验证制品没有被替换
最直接的验证方法是记录制品摘要,并在每个环境部署前重新计算。下面示例假设构建阶段已经生成 dist/orders-1.8.3.jar,流水线把它复制到三个发布目录,再比较 SHA-256。
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预期输出
test: <VALUE>
staging: <VALUE>
production: <VALUE>三行中的 <VALUE> 应完全相同;真实摘要取决于制品内容。如果某个环境重新构建或制品被覆盖,摘要就可能不同,流水线应在部署前直接失败。
制品与环境配置要分离
“一次构建”不等于所有环境使用完全相同的运行参数。数据库地址、外部服务端点、日志级别、密钥等环境差异应在部署阶段注入,而不是写进制品后为每个环境重新打包。
因此可以把发布对象理解为两部分:不可变制品回答“运行哪一版代码”,环境配置回答“这一版代码在这里如何运行”。只要配置注入不会改写制品本体,同一摘要就可以安全地跨环境晋级。
什么时候才需要重新构建
只有当源代码、依赖锁定文件、构建脚本或其他会改变制品字节的输入发生变化时,才应产生新的构建。环境从测试晋级到生产本身不是重新构建的理由。
落地时,把“构建”和“部署”拆成两个阶段:构建阶段只负责生成并登记制品,部署阶段只消费已登记制品并注入环境配置。这样测试通过的对象就是最终上线的对象,环境差异也不会偷偷变成产物差异。