本文介绍通过Jenkins构建流水线的方式实现全链路灰度功能。
在发布过程中,为了整体稳定性,我们总是希望能够用小部分特定流量来验证下新发布应用是否正常。
即使新版本有问题,也能及时发现,控制影响面,保障了整体的稳定性。
整体架构
我们以如下Demo为例:
为了保证稳定,我们约定如下上线流程:
其中,在灰度验证中,有几种不同的策略:
- 直接使用线上小部分流量来测试(按照百分比放量)
- 从线上按照特定规则选择流量(比如特定的header、特定的cookie等)
- 在客户端或浏览器上标识出流量是否灰度(比如通过header传递)
部署应用&创建泳道
按照参考文档部署应用后(https://github.com/aliyun/alibabacloud-microservice-demo/blob/master/mse-simple-demo/helm/mse-simple-demo/README.md),我们首先要区分线上流量和灰度流量。
创建泳道组,将整个链路涉及到的应用全选:
然后创建泳道组,将符合规则的应用划入gray泳道:
注:没有匹配的流量,会走到基线环境,也就是没有打标的应用节点上。
如何符合灰度规则,走灰度环境:
配置Jenkins流水线
本文实践需要将源码打包后执行镜像推送,请确保Jenkins有权限推送到镜像仓库中。具体操作,请参见使用kaniko构建和推送容器镜像。
在Jenkins命名空间下使用生成的config.json文件创建名为jenkins-docker-cfg的Secret。
kubectl create secret generic jenkins-docker-cfg -n jenkins --from-file=/root/.docker/config.json
在Jenkins中创建全链路灰度发布流水线
基于Jenkins实现自动化发布的流水线,通过该流水线可以使应用发布具备可灰度、可观测、可回滚的安全生产三板斧能力。
- 在Jenkins控制台左侧导航栏单击新建任务。
- 输入任务名称,选择流水线,然后单击确定。
- 在顶部菜单栏单击流水线页签,在流水线区域配置相关参数选择,输入脚本路径,然后单击保存。
- 定义:选择Pipeline script from SCM。
- SCM:选择Git。
- Repository URL:输入Git仓库的URL。本文示例代码仓库的地址为 https://gitee.com/mse-group/alibabacloud-microservice-demo/tree/master/mse-simple-demo 。
- 脚本路径:输入Jenkinsfile。
您可以参考以下的文件填写好指定的参数,当然您也可以根据需求编写Jenkinsfile ,并上传至Git的指定路径下(流水线中指定的脚本路径)。
#!groovy pipeline { // 定义本次构建使用哪个标签的构建环境,本示例中为 “slave-pipeline” agent{ node{ label 'slave-pipeline' } } //常量参数,初始确定后一般不需更改 environment{ IMAGE = sh(returnStdout: true,script: 'echo registry.$image_region.aliyuncs.com/$image_namespace/$image_reponame:$image_tag').trim() BRANCH = sh(returnStdout: true,script: 'echo $branch').trim() } options { //保持构建的最大个数 buildDiscarder(logRotator(numToKeepStr: '10')) } parameters { string(name: 'image_region', defaultValue: 'cn-shanghai') string(name: 'image_namespace', defaultValue: 'yizhan') string(name: 'image_reponame', defaultValue: 'spring-cloud-a') string(name: 'image_tag', defaultValue: 'gray') string(name: 'branch', defaultValue: 'master') string(name: 'number_of_pods', defaultValue: '2') } //pipeline的各个阶段场景 stages { stage('代码打包') { steps{ container("maven") { echo "镜像构建......" sh "cd A && mvn clean package" } } } stage('镜像构建及发布'){ steps{ container("kaniko") { sh "kaniko -f `pwd`/A/Dockerfile -c `pwd`/A --destination=${IMAGE} --skip-tls-verify" } } } stage('灰度部署') { steps{ container('kubectl') { echo "灰度部署......" sh "cd A && sed -i -E \"s/${env.image_reponame}:.+/${env.image_reponame}:${env.image_tag}/\" A-gray-deployment.yaml" sh "cd A && sed -i -E \"s/replicas:.+/replicas: ${env.number_of_pods}/\" A-gray-deployment.yaml" sh "kubectl apply -f A/A-gray-deployment.yaml -n default" } } } stage('结束灰度') { input { message "请确认是否全量发布" ok "确认" parameters { string(name: 'continue', defaultValue: 'true', description: 'true为全量发布,其他为回滚') } } steps{ script { env.continue = sh (script: 'echo ${continue}', returnStdout: true).trim() if (env.continue.equals('true')) { container('kubectl') { echo "全量发布......" sh "cd A && sed -i -E \"s/${env.image_reponame}:.+/${env.image_reponame}:${env.image_tag}/\" A-deployment.yaml" sh "cd A && sed -i -E \"s/replicas:.+/replicas: ${env.number_of_pods}/\" A-deployment.yaml" sh "kubectl apply -f A/A-deployment.yaml -n default" } } else { echo '回滚' } container('kubectl') { sh "kubectl delete -f A/A-gray-deployment.yaml -n default" } } } } } }
构建Jenkins流水线
- 在Jenkins控制台单击流水线右侧的图标。
- 单击流水线的开始构建。
说明 第一次构建因为需要从Git仓库拉取配置并初始化流水线,所以可能会报错,再次执行Build with Parameters,生成相关的参数,填写相关的参数,再次执行构建。
查看部署状态,代码打包,镜像构建及发布,灰度部署阶段都已经完成,结束灰度阶段等待确认。
- 如果验证结果符合预期,则执行全量发布,请参见后文的全量发布应用。
- 如果验证结果不符合预期时,则执行回滚,请参见后文的回滚应用。
结果验证
- 登录容器服务控制台,在控制台左侧导航栏中,单击集群。
- 在集群列表页面中,单击目标集群名称或者目标集群右侧操作列下的详情。
- 在集群管理页面左侧导航栏选择工作负载 > 无状态。
- 在无状态应用列表页面,spring-cloud-a-gray应用已经自动创建,并且它的镜像已经替换为spring-cloud-a:gray版本。
- 在集群管理页面左侧导航栏选择网络 > 服务,选择设置的命名空间,单击zuul-slb服务的外部端点,查看真实的调用情况
- 不带灰度Header进行调用,发现路由到A的正常节点。
- Curl命令:curl http://182.92.XX.XX/A/a
- 带上符合条件的参数进行访问,路由到A的灰度节点中。
- 执行结果如下:A[10.4.XX.XX] -> B[10.4.XX.XX] -> C[10.4.XX.XX]%
- Curl命令:curl http://182.92.XX.XX/A/a?name=xiaoming
- 执行结果如下:Agray[10.4.XX.XX] -> B[10.4.XX.XX] -> C[10.4.XX.XX]%
- 登录MSE治理中心控制台,在应用详情页面,可以看到灰度流量已经进入到灰度的Pod中。
全量发布应用
结果验证通过之后,确认全量发布。
- 在Jenkins控制台中,单击目标流水线名称。
- 单击需要全量发布的阶段,在请确认是否全量发布对话框中输入true,然后单击确认。
- 在容器服务控制台,发现spring-cloud-a-gray应用已经被删除,并且spring-cloud-a应用的镜像已经替换为spring-cloud-a:gray版本。
- 在MSE治理中心控制台,发现灰度流量已经消失。
回滚应用
如果发现验证结果不符合预期时,则回滚应用。
- 在Jenkins控制台中,单击目标流水线名称。
- 单击需要全量发布的阶段,在请确认是否全量发布对话框中输入false,然后单击确认。
- 在容器服务控制台,发现spring-cloud-a-gray应用已经被删除,并且spring-cloud-a应用的镜像仍然是老版本。
- 在MSE治理中心控制台,发现灰度流量已经消失。
总结
在微服务治理架构中,全链路灰度功能能提供虚拟泳道,极大的方便了测试、发布时的快速验证,能够帮助Devops提升线上稳定性。
阿里云微服务引擎(MSE)能够给您带来全生命周期的、全方位的微服务治理能力,保障您的线上稳定性、提升开发、运维效率。