1. 程式人生 > >K8S基於ingress-nginx實現灰度釋出

K8S基於ingress-nginx實現灰度釋出

之前介紹過使用ambassador實現灰度釋出,今天介紹如何使用ingre-nginx實現。

介紹

Ingress-Nginx 是一個K8S ingress工具,支援配置 Ingress Annotations 來實現不同場景下的灰度釋出和測試。 Nginx Annotations 支援以下 4 種 Canary 規則:

  • nginx.ingress.kubernetes.io/canary-by-header:基於 Request Header 的流量切分,適用於灰度釋出以及 A/B 測試。當 Request Header 設定為 always時,請求將會被一直髮送到 Canary 版本;當 Request Header 設定為 never
    時,請求不會被髮送到 Canary 入口;對於任何其他 Header 值,將忽略 Header,並通過優先順序將請求與其他金絲雀規則進行優先順序的比較。
  • nginx.ingress.kubernetes.io/canary-by-header-value:要匹配的 Request Header 的值,用於通知 Ingress 將請求路由到 Canary Ingress 中指定的服務。當 Request Header 設定為此值時,它將被路由到 Canary 入口。該規則允許使用者自定義 Request Header 的值,必須與上一個 annotation (即:canary-by-header)一起使用。
  • nginx.ingress.kubernetes.io/canary-weight:基於服務權重的流量切分,適用於藍綠部署,權重範圍 0 - 100 按百分比將請求路由到 Canary Ingress 中指定的服務。權重為 0 意味著該金絲雀規則不會向 Canary 入口的服務傳送任何請求。權重為 100 意味著所有請求都將被髮送到 Canary 入口。
  • nginx.ingress.kubernetes.io/canary-by-cookie:基於 Cookie 的流量切分,適用於灰度釋出與 A/B 測試。用於通知 Ingress 將請求路由到 Canary Ingress 中指定的服務的cookie。當 cookie 值設定為 always
    時,它將被路由到 Canary 入口;當 cookie 值設定為 never時,請求不會被髮送到 Canary 入口;對於任何其他值,將忽略 cookie 並將請求與其他金絲雀規則進行優先順序的比較。

注意:金絲雀規則按優先順序進行如下排序:

canary-by-header - > canary-by-cookie - > canary-weight

我們可以把以上的四個 annotation 規則可以總體劃分為以下兩類:

  • 基於權重的 Canary 規則

  • 基於使用者請求的 Canary 規則

注意: Ingress-Nginx 實在0.21.0 版本 中,引入的Canary 功能,因此要確保ingress版本OK

測試

應用準備

兩個版本的服務,正常版本:

import static java.util.Collections.singletonMap;

@SpringBootApplication
@Controller
public class RestPrometheusApplication {

    @Autowired
    private MeterRegistry registry;

    @GetMapping(path = "/", produces = "application/json")
    @ResponseBody
    public Map<String, Object> landingPage() {
        Counter.builder("mymetric").tag("foo", "bar").register(registry).increment();
        return singletonMap("hello", "ambassador");
    }

    public static void main(String[] args) {
        SpringApplication.run(RestPrometheusApplication.class, args);
    }

}

訪問會輸出:

{"hello":"ambassador"}  

灰度版本:

import static java.util.Collections.singletonMap;

@SpringBootApplication
@Controller
public class RestPrometheusApplication {

    @Autowired
    private MeterRegistry registry;

    @GetMapping(path = "/", produces = "application/json")
    @ResponseBody
    public Map<String, Object> landingPage() {
        Counter.builder("mymetric").tag("foo", "bar").register(registry).increment();
        return singletonMap("hello", "ambassador, this is a gray version");
    }

    public static void main(String[] args) {
        SpringApplication.run(RestPrometheusApplication.class, args);
    }

}

訪問會輸出:

{"hello":"ambassador, this is a gray version"}  

ingress 配置

我們部署好兩個服務,springboot-rest-demo是正常的服務,springboot-rest-demo-gray是灰度服務,我們來配置ingress,通過canary-by-header來實現:

正常服務的:

apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  name: springboot-rest-demo
  annotations:
    kubernetes.io/ingress.class: nginx
spec:
  rules:
  - host: springboot-rest.jadepeng.com
    http:
      paths:
      - backend:
          serviceName: springboot-rest-demo
          servicePort: 80

canary 的:

apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  name: springboot-rest-demo-gray
  annotations:
    kubernetes.io/ingress.class: nginx
    nginx.ingress.kubernetes.io/canary: "true"
    nginx.ingress.kubernetes.io/canary-by-header: "canary"
    nginx.ingress.kubernetes.io/canary-by-header-value: "true"
spec:
  rules:
  - host: springboot-rest.jadepeng.com
    http:
      paths:
      - backend:
          serviceName: springboot-rest-demo-gray
          servicePort: 80

將上面的檔案執行:

kubectl -n=default apply -f ingress-test.yml 
ingress.extensions/springboot-rest-demo created
ingress.extensions/springboot-rest-demo-gray created

執行測試,不新增header,訪問的預設是正式版本:

# curl http://springboot-rest.jadepeng.com; echo
{"hello":"ambassador"}
# curl http://springboot-rest.jadepeng.com; echo
{"hello":"ambassador"}

新增header,可以看到,訪問的已經是灰度版本了

# curl -H "canary: true" http://springboot-rest.jadepeng.com; echo
{"hello":"ambassador, this is a gray version"}

多例項Ingress controllers

參考

  • https://kubesphere.com.cn/docs/v2.0/zh-CN/quick-start/ingress-canary/#ingress-nginx-annotation-%E7%AE%80%E4%BB%8B
  • https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/annotations/#canary

作者:Jadepeng
出處:jqpeng的技術記事本--http://www.cnblogs.com/xiaoqi
您的支援是對博主最大的鼓勵,感謝您的認真閱讀。
本文版權歸作者所有,歡迎轉載,但未經作者同意必須保留此段宣告,且在文章頁面明顯位置給出原文連線,否則保留追究法律責任的權利。