前言
Ingress-Nginx是一个K8S ingress工具，支持配置Ingress Annotations来实现不同场景下的灰度发布和测试。 Nginx Annotations 支持以下几种Canary规则：
Nginx ingress annotations
假设我们现在部署了两个版本的服务，老版本和canary版本
nginx.ingress.kubernetes.io/canary-by-header：基于Request Header的流量切分，适用于灰度发布以及 A/B 测试。当Request Header 设置为 always时，请求将会被一直发送到 Canary 版本；当 Request Header 设置为 never时，请求不会被发送到 Canary 入口。
nginx.ingress.kubernetes.io/canary-by-header-value：要匹配的 Request Header 的值，用于通知 Ingress 将请求路由到 Canary Ingress 中指定的服务。当 Request Header 设置为此值时，它将被路由到 Canary 入口。该
nginx.ingress.kubernetes.io/canary-weight：基于服务权重的流量切分，适用于蓝绿部署，权重范围 0 - 100 按百分比将请求路由到 Canary Ingress 中指定的服务。权重为 0 意味着该金丝雀规则不会向 Canary 入口的服务发送任何请求。权重为60意味着60%流量转到canary。权重为 100 意味着所有请求都将被发送到 Canary 入口。
nginx.ingress.kubernetes.io/canary-by-cookie：基于 Cookie 的流量切分，适用于灰度发布与 A/B 测试。用于通知 Ingress 将请求路由到 Canary Ingress 中指定的服务的cookie。当 cookie 值设置为 always时，它将被路由到 Canary 入口；当 cookie 值设置为 never时，请求不会被发送到 Canary 入口。
部署服务
这里我们服务的 deployment 就不展示了，service 配置如下
# 测试版本
apiVersion:v1
kind:Service
metadata:
name:hello-service
labels:
app:hello-service
spec:
ports:
-port: 80
protocol:TCP
selector:
app:hello-service
#canary版本
apiVersion:v1
kind:Service
metadata:
name:canary-hello-service
labels:
app:canary-hello-service
spec:
ports:
-port: 80
protocol:TCP
selector:
app:canary-hello-service
根据权重转发
ingress 配置如下：
apiVersion: extensions/v1beta1
kind:Ingress
metadata:
name: canary
annotations:
kubernetes.io/ingress.class: nginx
nginx.ingress.kubernetes.io/canary:"true"
nginx.ingress.kubernetes.io/canary-weight:"30"
spec:
rules:
-host: canary-service.abc.com
http:
paths:
-backend:
serviceName: canary-hello-service
servicePort:80
测试结果如下：
$foriin$(seq 1 10);docurl http://canary-service.abc.com;echo'\n'; done
hello world-version1
hello world-version1
hello world-version2
hello world-version2
hello world-version1
hello world-version1
hello world-version1
hello world-version1
hello world-version1
hello world-version1
根据请求头转发
annotation 配置如下（ingress 其余部分省略）
annotations:
kubernetes.io/ingress.class: nginx
nginx.ingress.kubernetes.io/canary:"true"
nginx.ingress.kubernetes.io/canary-by-header:"test"
测试结果如下:
$foriin$(seq 1 5);docurl http://canary-service.abc.com;echo'\n'; done
hello world-version1
hello world-version1
hello world-version1
hello world-version1
hello world-version1
$foriin$(seq 1 5);docurl -H'test:always'http://canary-service.abc.com;echo'\n'; done
hello world-version2
hello world-version2
hello world-version2
hello world-version2
hello world-version2
根据特定的请求头和值转发
annotation 配置如下:
kubernetes.io/ingress.class: nginx
nginx.ingress.kubernetes.io/canary:"true"
nginx.ingress.kubernetes.io/canary-by-header:"test"
nginx.ingress.kubernetes.io/canary-by-header-value:"abc"
测试结果如下：
$foriin$(seq 1 5);docurl -H'test:always'http://canary-service.abc.com;echo'\n'; done
hello world-version1
hello world-version1
hello world-version1
hello world-version1
hello world-version1
$foriin$(seq 1 5);docurl -H'test:abc'http://canary-service.abc.com;echo'\n'; done
hello world-version2
hello world-version2
hello world-version2
hello world-version2
hello world-version2
根据 cookie 转发
使用cookie来进行流量管理的场景比较适合用于A/B test，比如用户的请求 cookie 中含有特殊的标签，那么我们可以把这部分用户的请求转发到特定的服务进行处理。annotation 配置如下:
kubernetes.io/ingress.class: nginx
nginx.ingress.kubernetes.io/canary:"true"
nginx.ingress.kubernetes.io/canary-by-cookie:"like_music"
测试结果如下：
$foriin$(seq 1 5);docurl -b'like_music=1'http://canary-service.abc.com;echo'\n'; done
hello world-version1
hello world-version1
hello world-version1
hello world-version1
hello world-version1
$foriin$(seq 1 5);docurl -b'like_music=always'http://canary-service.abc.com;echo'\n'; done
hello world-version2
hello world-version2
hello world-version2
hello world-version2
hello world-version2
三种annotation按如下顺序匹配
canary-by-header > canary-by-cookie > canary-weight
总结
我们从以上的测试结果来看，可以把流量的转发分成以下两类：
1.根据权重
nginx.ingress.kubernetes.io/canary:"true"
nginx.ingress.kubernetes.io/canary-weight:"30"
70%
|------> 生产版本
users --- 100% ---> Nginx Ingress ----| 30%
|------> canary 版本
2.根据用户
nginx.ingress.kubernetes.io/canary:"true"
nginx.ingress.kubernetes.io/canary-by-header:"test"
nginx.ingress.kubernetes.io/canary-by-header-value:"abc"
others
|-----------> 生产版本
users ------> Nginx Ingress ------|"test:abc"
|-----------> canary 版本
网友评论