CI/CD / 系统课时

加入测试环境部署与验收

加入测试环境部署与验收

候选版本构建成功并不代表可以进入生产。本节把测试环境部署、健康检查和验收结果接入 Jenkins Pipeline,让流水线只有在候选版本真正可访问时才继续,为生产发布建立可重复执行的门禁。

学习目标

  • 将同一个候选版本自动部署到测试环境
  • 使用健康检查判断服务是否达到可验收状态
  • 让部署或验收失败立即阻断后续生产阶段

测试环境为什么必须成为门禁

生产流水线的关键不是“执行一次部署命令”,而是证明即将发布的版本已经经过部署验证。构建阶段产生候选版本后,应固定其版本标识,并让测试环境和后续生产环境使用同一版本,避免测试通过的是 A、生产部署的却是 B。

测试环境门禁至少包含两个结果:部署命令成功,以及应用达到预期健康状态。前者只能证明部署工具没有直接报错,后者才能证明应用进程已经启动并能够处理请求。

候选版本经过测试环境门禁后进入生产阶段的流程

把部署与健康检查写进 Pipeline

下面使用 SSH 调用测试服务器上的部署脚本,再通过 HTTP 健康端点验收。示例假定 Jenkins Agent 已配置 ssh 和 curl,并已通过凭据或主机配置解决 SSH 身份认证;DEPLOY_VERSION 来自前序构建阶段并保持不变。

groovy
pipeline {
    agent any

    environment {
        STAGING_HOST = 'staging.example.internal'
        HEALTH_URL = 'https://staging.example.internal/health'
        DEPLOY_VERSION = '1.8.3'
    }

    stages {
        stage('Deploy to Staging') {
            steps {
                sh '''
                    set -eu
                    ssh deploy@${STAGING_HOST} "/opt/app/deploy.sh ${DEPLOY_VERSION}"
                '''
            }
        }

        stage('Verify Staging') {
            steps {
                timeout(time: 2, unit: 'MINUTES') {
                    retry(6) {
                        sh '''
                            curl --fail --silent --show-error \
                              --max-time 5 "${HEALTH_URL}"
                        '''
                        sleep time: 10, unit: 'SECONDS'
                    }
                }
            }
        }
    }
}

预期结果:部署脚本退出码为 0,并且健康端点在重试窗口内至少一次返回 HTTP 2xx,两个阶段均成功,流水线才会继续。具体 Jenkins 时间戳和构建编号可能不同。

text
[Pipeline] stage
[Pipeline] { (Deploy to Staging)
[Pipeline] sh
[Pipeline] }
[Pipeline] stage
[Pipeline] { (Verify Staging)
[Pipeline] sh
[Pipeline] }
[Pipeline] End of Pipeline
Finished: SUCCESS

这里使用 curl --fail 很重要:HTTP 4xx 或 5xx 会使命令以非零状态退出,从而让 Jenkins 感知验收失败。retry(6) 则给应用预留启动时间,避免刚完成部署就因短暂未就绪而误判失败。

健康检查应该检查什么

健康端点不应只返回“进程存在”。对于生产前门禁,更有价值的是 readiness 类检查:应用能够接收请求,并且发布所依赖的关键资源已经就绪。具体检查深度取决于系统设计,但应避免把非关键外部服务全部绑定到一个健康端点,否则无关故障也会阻断发布。

失败时让流水线停在测试环境

Jenkins 的 sh 步骤遇到非零退出码会使阶段失败,因此部署脚本和验收脚本必须正确传播失败状态,不能捕获错误后仍然返回 0。健康检查连续失败、SSH 部署失败或超时,都应该阻止生产阶段执行,而不是仅打印警告继续发布。

部署脚本本身也应保证可重复执行,并明确接受候选版本参数。这样重新执行流水线时仍部署指定版本,而不是临时拉取 latest 等可变标签。

最终门禁可以归结为一个明确条件:指定候选版本已经成功部署到测试环境,并在限定时间内通过自动验收。只有这个条件成立,流水线才有资格进入生产审批与发布阶段。

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

目录与阅读设置

阅读设置

17

记录一个想法

加入测试环境部署与验收

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

登录哪都通