Myluzh Blog

K8S Ingress-nginx实现金丝雀灰度发布

发布时间: 2023-11-20 文章作者: myluzh 分类名称: Kubernetes 朗读文章


0x00 Ingress金丝雀发布介绍
Nginx Annotations 支持以下 4 种 Canary 规则:
(1)nginx.ingress.kubernetes.io/canary-by-header:
基于 Request Header 的流量切分,适用于灰度发布以及 A/B 测试。当 Request Header 设置为 always时,请求将会被一直发送到 Canary 版本;当 Request Header 设置为 never时,请求不会被发送到 Canary 入口;对于任何其他 Header 值,将忽略 Header,并通过优先级将请求与其他金丝雀规则进行优先级的比较。
(2)nginx.ingress.kubernetes.io/canary-by-header-value:
要匹配的 Request Header 的值,用于通知 Ingress 将请求路由到 Canary Ingress 中指定的服务。当 Request Header 设置为此值时,它将被路由到 Canary 入口。该规则允许用户自定义 Request Header 的值,必须与上一个 annotation (即:canary-by-header)一起使用。
(3)nginx.ingress.kubernetes.io/canary-weight:
基于服务权重的流量切分,适用于蓝绿部署,权重范围 0 - 100 按百分比将请求路由到 Canary Ingress 中指定的服务。权重为 0 意味着该金丝雀规则不会向 Canary 入口的服务发送任何请求。权重为 100 意味着所有请求都将被发送到 Canary 入口。
(4)nginx.ingress.kubernetes.io/canary-by-cookie:
基于 Cookie 的流量切分,适用于灰度发布与 A/B 测试。用于通知 Ingress 将请求路由到 Canary Ingress 中指定的服务的cookie。当 cookie 值设置为 always时,它将被路由到 Canary 入口;当 cookie 值设置为 never时,请求不会被发送到 Canary 入口;对于任何其他值,将忽略 cookie 并将请求与其他金丝雀规则进行优先级的比较。 定义两个版本的代码。
点击查看原图
下面是一个使用Kubernetes Ingress实现金丝雀部署的案例,其中10%的流量将使用v2的服务,而90%的流量将使用v1的服务。假设你已经安装并配置了Nginx Ingress Controller。

0x01 创建两个不同版本的服务
分别是v1和v2。这里以Deployment为例
创建v1版本的Deployment和Service:
apiVersion: apps/v1
kind: Deployment
metadata:
 name: hellok8s
spec:
 replicas: 3
 selector:
   matchLabels:
     app: hellok8s
     version: v1
 template:
   metadata:
     labels:
       app: hellok8s
       version: v1
   spec:
     containers:
     - name: hellok8s
       image: registry.cn-hangzhou.aliyuncs.com/myluzh/hellok8s:v1
---
apiVersion: v1
kind: Service
metadata:
 name: hellok8s
spec:
 selector:
   app: hellok8s
   version: v1
 ports:
   - protocol: TCP
     port: 80
     targetPort: 80
创建v2版本的Deployment和Service:
---
apiVersion: apps/v1
kind: Deployment
metadata:
 name: hellok8s-canary
spec:
 replicas: 3
 selector:
   matchLabels:
     app: hellok8s-canary
     version: v2
 template:
   metadata:
     labels:
       app: hellok8s-canary
       version: v2
   spec:
     containers:
     - name: hellok8s-canary
       image: registry.cn-hangzhou.aliyuncs.com/myluzh/hellok8s:v3
---
apiVersion: v1
kind: Service
metadata:
 name: hellok8s-canary
spec:
 selector:
   app: hellok8s-canary
   version: v2
 ports:
   - protocol: TCP
     port: 80
     targetPort: 80
0x02 Ingress配置
1、创建 Ingress,对外暴露服务,指向 v1 版本的服务。YAML 示例如下:
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
 name: hellok8s-ingress
spec:
 rules:
 - host: my.k8s.com
   http:
     paths:
     - path: /
       pathType: Prefix
       backend:
         service:
           name: hellok8s
           port:
             number: 80
2、创建 Canary Ingress,指定 v2 版本的后端服务。接下来,你需要创建Ingress资源来配置金丝雀流量的分发。在Ingress规则中,你可以使用nginx.ingress.kubernetes.io/canary-weight注解来指定流量的权重。
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
 name: hellok8s-ingress-caanary
 annotations:
   nginx.ingress.kubernetes.io/canary: "true"
   nginx.ingress.kubernetes.io/canary-weight: "10"
spec:
 rules:
 - host: my.k8s.com
   http:
     paths:
     - path: /
       pathType: Prefix
       backend:
         service:
           name: hellok8s-canary
           port:
             number: 80
在上述Ingress规则中,我们通过将10%的流量转发到名为hellok8s-canary的服务,而90%的流量转发到名hellok8s的v1服务。
0x03 最后
你可以将上述Ingress资源应用到Kubernetes集群中:
kubectl apply -f ingress.yaml
现在,Kubernetes Ingress将根据权重配置将流量分发到不同版本的服务中,实现金丝雀部署。

标签: k8s nginx Ingress 金丝雀 灰度发布

发表评论