CI/CD / 系统课时
部署到测试环境并执行验证
部署到测试环境并执行验证
镜像进入仓库并不代表它已经可以发布。本节把确定版本部署到测试环境,再用滚动状态和 HTTP 健康检查建立自动门禁:只有新版本真正可用时流水线才继续,超时或检查失败则立即终止。
学习目标
- 将流水线生成的确定镜像版本部署到测试环境
- 区分部署完成、工作负载就绪和业务健康三个判断层次
- 让验证失败以非零退出状态阻止后续发布阶段
部署必须指向确定版本
测试环境不应部署含义会变化的 latest。假设 Jenkins 已得到本次制品标签 <BUILD_NUMBER>,部署时应明确使用 registry.example.com/team/demo-api:<BUILD_NUMBER>,这样流水线能够回答“测试的究竟是哪一个镜像”。
本节以 Kubernetes 为测试环境。Jenkins Agent 需要安装 kubectl,并通过受控凭据获得目标集群权限;示例中的 Deployment 名称为 demo-api,容器名同样为 demo-api,命名空间为 test。

更新工作负载并等待就绪
kubectl set image 可以只更新目标容器镜像,随后使用 kubectl rollout status 等待 Deployment 完成本次滚动发布。--timeout 可以避免 Agent 无限等待异常 Pod。
set -eu
NAMESPACE="test"
DEPLOYMENT="demo-api"
CONTAINER="demo-api"
IMAGE="registry.example.com/team/demo-api:<BUILD_NUMBER>"
kubectl -n "$NAMESPACE" set image "deployment/$DEPLOYMENT" "$CONTAINER=$IMAGE"
kubectl -n "$NAMESPACE" rollout status "deployment/$DEPLOYMENT" --timeout=180s预期输出
deployment.apps/demo-api image updated
deployment "demo-api" successfully rolled out实际 <BUILD_NUMBER> 使用本次流水线确定的构建号。如果 180 秒内无法完成 rollout,kubectl 会返回非零退出状态;配合 set -e,当前 Shell 步骤随即失败,Jenkins 不会把部署误判为成功。
再检查业务健康端点
Deployment rollout 成功主要说明 Kubernetes 已按工作负载配置完成更新和就绪判断,并不自动证明关键业务路径正常。测试环境还应提供稳定的健康检查入口,例如 https://test.example.com/health。
下面使用 curl --fail 发起检查。--fail 会让 HTTP 400 及以上响应导致命令返回失败状态,--retry 用于吸收应用刚切换流量时的短暂抖动。
curl --fail --silent --show-error \
--retry 5 --retry-delay 2 \
"https://test.example.com/health"预期输出
OK这里假设该应用健康端点成功时固定返回 OK;实际项目应按自己的健康接口契约验证响应。若接口返回 JSON,也可以进一步检查必要字段,而不是仅凭 HTTP 连接成功放行。
把验证写成流水线门禁
部署与验证应处于后续发布阶段之前。Declarative Pipeline 中,只要 sh 内的命令最终返回非零状态,Stage 就会失败,正常情况下后面的生产部署 Stage 不会继续执行。
stage('Deploy and Verify Test') {
steps {
sh '''
set -eu
IMAGE="registry.example.com/team/demo-api:${BUILD_NUMBER}"
kubectl -n test set image deployment/demo-api demo-api="$IMAGE"
kubectl -n test rollout status deployment/demo-api --timeout=180s
curl --fail --silent --show-error --retry 5 --retry-delay 2 \
https://test.example.com/health
'''
}
}预期输出
deployment.apps/demo-api image updated
deployment "demo-api" successfully rolled out
OK这里 ${BUILD_NUMBER} 由 Jenkins 提供,实际值随构建变化。若 rollout 或 HTTP 验证任意一步失败,Shell 返回非零状态,Stage 将失败,因此后续发布不会按正常成功路径执行。
失败后不要直接继续发布
rollout 超时时,应先运行 kubectl -n test get pods、kubectl -n test describe deployment demo-api 等命令检查镜像拉取、调度、探针和容器启动问题;rollout 成功但健康接口失败,则重点检查应用依赖、配置、入口路由以及业务自身的健康判断。
可靠的部署链路应逐层确认“指定版本已部署、工作负载已就绪、应用健康检查通过”。只有这三个条件都成立,测试环境才应向后续发布阶段交出成功结果。