什么是ACK Nginx Ingress灰度发布_云效(Alibaba Cloud DevOps)-阿里云帮助中心

本文主要从使用背景、使用前提和实现原理等方面介绍了ACK Nginx Ingress 灰度发布，以及如何快速配置灰度发布流水线。

使用背景

灰度及蓝绿发布：为新版本创建一个与老版本完全一致的生产环境，在不影响老版本的前提下，按照一定的规则把部分流量切换到新版本，当新版本试运行一段时间没有问题后，将用户的全量流量从老版本迁移至新版本。其中A/B测试就是一种灰度发布方式，一部分用户继续使用老版本的服务，将一部分用户的流量切换到新版本，如果新版本运行稳定，则逐步将所有用户迁移到新版本。
Ingress灰度发布使用背景：控制新版本流量分配权重，以小部分线上流量对服务进行验证通过cookie或者header使得部分受控用户在线上对发布进行验证。当发布验证失败后，可以快速回滚到旧版本。

使用前提

使用由阿里云容器服务Kubernetes版本提供的ACK，有关内容请参见创建集群。

Deployment的labels内包含有Service的全部selector labels，如：

apiVersion: apps/v1
kind: Deployment
metadata:  
  name: spring-boot-sample
  labels:
    run: spring-boot-sample
spec:  
  replicas: 2  
  selector:    
    matchLabels:
      run: spring-boot-sample 
  template:    
    metadata:
      labels:        
        run: spring-boot-sample   
    spec:
      imagePullSecrets:
      - name: acr-registry-private
      containers:
      - name: app     # 容器名称
        image: nginx
        imagePullPolicy: Always
        ports:
        - containerPort: 8080
          protocol: TCP
          
---

apiVersion: v1
kind: Service
metadata:  
  name: spring-boot-service
spec:
  type: ClusterIP
  selector:      #标签选择器，定义要访问的目标pod
    run: spring-boot-sample  
  sessionAffinity: None  
  ports:  
  - port: 8080 #服务端口    
    protocol: TCP    
    targetPort: 8080

实现原理

如下图所示，当采用ACK Nginx Ingress灰度发布时，假定当前运行版为primary，将要发布版本为canary。

发布过程：

发布前检查：预检查当前Ingress是否有且只关联了唯一的Service实例，且Service实例下有且只有唯一版本的Deployment。
生成Canary版本：克隆primary版本的Service以及Deployment生成canary版本的Service和Deployment，同时修改canary版本Deployment的镜像到新版本。
修改Ingress流量规则：根据发布配置调整Ingress配置，开始执行灰度。
人工验证：通过cookie或者header对灰度版本进行验证，根据结果选择完成发布或者回滚。
完成灰度：修改Ingress配置以及流量规则，下线Primary版本的Service以及Deployment实例。
回滚发布：修改Ingress配置以及流量规则，下线Canary版本的Service以及Deployment。

操作步骤

步骤一：初始化应用部署

通过以下YAML配置文件，快速初始化应用部署。

apiVersion: apps/v1
kind: Deployment
metadata:  
  name: old-nodejs  
  labels:
    run: old-nodejs
spec:  
  replicas: 2  
  selector:    
    matchLabels:
      run: old-nodejs  
  template:    
    metadata:
      labels:        
        run: old-nodejs    
    spec:
      imagePullSecrets:
      - name: acr-registry-private
      containers:
      - name: app # 容器名称
        image: registry.xxxxx.com/xxxxx/nodejs-example:v1
        imagePullPolicy: Always
        ports:
        - containerPort: 3000
          protocol: TCP
      restartPolicy: Always #在任何情况下，只要容器不在运行状态，就自动重启容器。默认
        
---

apiVersion: v1
kind: Service
metadata:  
  name: old-nodejs
spec:
  type: NodePort
  selector:      #标签选择器，定义要访问的目标pod
    run: old-nodejs  
  sessionAffinity: None  
  ports:  
  - port: 80 #服务端口    
    protocol: TCP    
    targetPort: 3000 #应用端口  

---

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:    
  name: gray-release
spec:
  rules:  
  - host: www.example.com    
    http:      
      paths:
      - path: /   # 老版本服务，指定代理的路径
        pathType: Prefix
        backend:
          service:
            name: old-nodejs
            port:
              number: 80

保存以上内容到 gray-release.yaml，使用 kubectl 或控制台完成应用初始化：
```
kubectl apply -f gray-release.yaml
```

步骤二：配置流水线

如下所示，配置如下信息：

配置项	说明
集群连接	使用集群连接，连接到自定义Kubernetes或者阿里云容器服务集群。
Kubectl版本	请选择与K8s集群适配的Kubectl版本。
命名空间	当前服务所在Kubernetes集群命名空间, 示例中为default。
Ingress名称	发布的目标Ingress实例名称，示例中为gray-release。
服务端口	Ingress后端Service 实例对外暴露的端口，示例中为80
应用端口	镜像对外暴露的端口，示例中为3000。
容器名称	应用发布时需要更新镜像的容器名，示例中为app。
镜像	通过前序任务镜像构建产生的镜像，或者是特定的镜像名称。
灰度匹配方式	选择使用header或者cookie方式进行灰度验证，并设置匹配的Key/Value。
灰度匹配名称	配置自定义的Cookie或者Header的KEY。
灰度匹配值	配置自定义的Cookie或者Header的Value。
灰度版本初始化流量权重	默认灰度版本上线后的流量权重，流量分配比。
启动等待时间	灰度版本发布后等待该时间后再修改Ingress配置。
下线等待时间	Ingress配置调整后等待该时长后再移除应用实例。

步骤三：运行流水线

保存并运行流水线，当新版本发布后，流水线的任务将处于灰度发布中，等待人工验证，以确定后续操作。
当任务灰度中，可以查看下Ingress资源Annotations自定义注释列表，在灰度前后的资源变化。
当任务在灰度中，访问应用服务测试结果，可以观察到请求访问流量，会按照自定义配置的灰度版本权重的60%进行流量分配。用户可以通过在浏览器设置cookie的后来访问新版本的应用。
```
document.cookie="foo=bar"
```
当在灰度中云效自动创建了灰度版本的服务，命名规则为：<ingressname>-<version>，查看灰度版本的详情。