为ELB Ingress配置高级转发策略

您可以对请求中指定的Header进行修改或删除。以下示例中，当用户访问该Ingress时，会同时写入/删除部分Header：

• 写入用户自定义Header（aa:aa）、系统定义的Header（bb:ELB-ID）和用户引用的Header（cc:cc）
• 删除键为dd和ee的Header

具体操作及参数配置说明如下：

1. 请参见通过kubectl连接集群，使用kubectl连接集群。
2. 创建名为“ingress-test.yaml”的YAML文件，此处文件名可自定义。

   vi ingress-test.yaml

   以使用已有ELB创建Ingress的场景为例，YAML配置如下：

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     annotations:
       kubernetes.io/elb.class: performance
       kubernetes.io/elb.id: *****
       kubernetes.io/elb.port: "80"
       # 以下注解对名为test-service的Service生效，为其配置写入/删除Header的转发动作
       kubernetes.io/elb.actions.test-service: |
         [{
             "type": "InsertHeader",
             "InsertHeaderConfig": {
                 "key": "aa",
                 "value_type": "USER_DEFINED",
                 "value": "aa"
             }
         },
         {
             "type": "InsertHeader",
             "InsertHeaderConfig": {
                 "key": "bb",
                 "value_type": "SYSTEM_DEFINED",
                 "value": "ELB-ID"
             }
         },
         {
             "type": "InsertHeader",
             "InsertHeaderConfig": {
                 "key": "cc",
                 "value_type": "REFERENCE_HEADER",
                 "value": "cc"
             }
         },
         {
             "type": "RemoveHeader",
             "RemoveHeaderConfig": {
                 "key": "dd"
             }
         },
         {
             "type": "RemoveHeader",
             "RemoveHeaderConfig": {
                 "key": "ee"
             }
         }]      
     name: ingress-test
     namespace: default
   spec:
     ingressClassName: cce
     rules:
       - http:
           paths:
             - backend:
                 service:
                   name: test-service
                   port:
                     number: 80
               path: /
               pathType: ImplementationSpecific
               property:
                 ingress.beta.kubernetes.io/url-match-mode: STARTS_WITH

   表5 高级转发动作注解

   参数	类型	描述
   kubernetes.io/elb.actions.${svc_name}	String	为Ingress配置高级转发动作，${svc_name}即对应的Service名称，其最大长度为51个字符。 如果该注解值配置成[]则表示删除所有高级转发动作。 配置写入/删除Header的注解值格式为JSON字符串数组，具体参数请参见表6，例如： [{"type":"InsertHeader","InsertHeaderConfig":{"key":"aa","value_type":"USER_DEFINED","value":"aa"}}]

   表6 重写Header参数配置说明

   参数	使用说明	示例
   type	表示重写Header的类型，支持设置以下几种参数值： InsertHeader：表示写入Header，需要与InsertHeaderConfig字段搭配使用。 RemoveHeader：表示删除Header，需要与RemoveHeaderConfig字段搭配使用。 说明： 高级转发动作注解中最多添加5条写入Header或删除Header配置。	-
   InsertHeaderConfig	表示写入Header，仅当type参数值为InsertHeader时使用。 key：重写Header的Key值，长度限制1-40字符, 只能由英文字母、数字、下划线和中划线组成。不能是以下字符中的一种（不区分大小写）： connection、upgrade、content-length、transfer-encoding、keep-alive、te、host、cookie、remoteip、authority、x-forwarded-host、x-forwarded-for、x-forwarded-for-port、x-forwarded-tls-certificate-id、x-forwarded-tls-protocol、x-forwarded-tls-cipher、x-forwarded-elb-ip、x-forwarded-port、x-forwarded-elb-id、x-forwarded-elb-vip、x-real-ip、x-forwarded-proto、x-nuwa-trace-ne-in、x-nuwa-trace-ne-out value_type：写入Header的类型（删除Header时该字段配置无效）。仅支持以下字段： USER_DEFINED：表示用户自定义的Header。 REFERENCE_HEADER：表示用户引用的Header。 SYSTEM_DEFINED：表示系统定义的Header。 value：写入Header的value值（删除Header时该字段配置无效）。取值范围为1-128个字符，支持ASCII码值32<=ch<=127范围内可打印字符，*和英文问号?。不能以空格开头或结尾。 value_type为SYSTEM_DEFINED时，value只可从CLIENT-PORT、CLIENT-IP、ELB-PROTOCOL、ELB-ID、ELB-PORT、ELB-EIP、ELB-VIP中取值。	{ "type": "InsertHeader", "InsertHeaderConfig": { "key": "aa", "value_type": "USER_DEFINED", "value": "aa" } }
   RemoveHeaderConfig	表示删除Header，仅当type参数值为RemoveHeader时使用。 key：删除Header的Key值，长度限制1-40字符, 只能由英文字母、数字、下划线和中划线组成。不能是以下字符中的一种（不区分大小写）： connection、upgrade、content-length、transfer-encoding、keep-alive、te、host、cookie、remoteip、authority、x-forwarded-host、x-forwarded-for、x-forwarded-for-port、x-forwarded-tls-certificate-id、x-forwarded-tls-protocol、x-forwarded-tls-cipher、x-forwarded-elb-ip、x-forwarded-port、x-forwarded-elb-id、x-forwarded-elb-vip、x-real-ip、x-forwarded-proto、x-nuwa-trace-ne-in、x-nuwa-trace-ne-out	{ "type": "RemoveHeader", "RemoveHeaderConfig": { "key": "ee" } }

3. 创建Ingress。

   kubectl create -f ingress-test.yaml

   回显如下，表示Ingress服务已创建。

   ingress/ingress-test created

4. 查看已创建的Ingress。

   kubectl get ingress

   回显如下，表示Ingress服务创建成功。

   NAME          CLASS    HOSTS     ADDRESS          PORTS   AGE
   ingress-test  cce      *         121.**.**.**     80      10s

您可以为ELB Ingress配置固定的响应状态码及内容。以下示例中，当用户访问该Ingress时，会返回固定响应503状态码和"503 error text"的内容。

具体操作及参数配置说明如下：

1. 请参见通过kubectl连接集群，使用kubectl连接集群。
2. 创建名为“ingress-test.yaml”的YAML文件，此处文件名可自定义。

   vi ingress-test.yaml

   以使用已有ELB创建Ingress的场景为例，YAML配置如下：

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     annotations:
       kubernetes.io/elb.class: performance
       kubernetes.io/elb.id: *****
       kubernetes.io/elb.port: "80"
       # 以下注解对名为test-service的Service生效，为其配置返回固定响应的转发动作
       kubernetes.io/elb.actions.test-service: |
        [{ 
          "type": "FixedResponse", 
          "fixedResponseConfig": { 
              "contentType": "text/plain", 
              "statusCode": "503",
              "messageBody": "503 error text"  
          } 
        }]
     name: ingress-test
     namespace: default
   spec:
     ingressClassName: cce
     rules:
       - http:
           paths:
             - backend:
                 service:
                   name: test-service
                   port:
                     number: 80
               path: /
               pathType: ImplementationSpecific
               property:
                 ingress.beta.kubernetes.io/url-match-mode: STARTS_WITH

   表7 高级转发动作注解

   参数	类型	描述
   kubernetes.io/elb.actions.${svc_name}	String	为Ingress配置高级转发动作，${svc_name}即对应的Service名称，其最大长度为51个字符。 如果该注解值配置成[]则表示删除所有高级转发动作。 配置返回固定响应的注解值格式为JSON字符串数组，具体参数请参见表8。

   表8 返回固定响应参数配置说明

   参数	使用说明	示例
   type	固定值为“FixedResponse”，表示返回固定响应。 说明： 高级转发动作注解中最多添加1条返回固定响应配置。	-
   fixedResponseConfig	contentType：返回内容格式，可以选择“text/plain”、“text/css”、“text/html”、“application/javascript”、“application/json”。 statusCode：返回码，默认支持2XX、4XX、5XX系列状态码。 messageBody：取值范围是0~1024个字符。 须知： 同时配置限速时，该字段不允许为空值。	{ "type": "FixedResponse", "fixedResponseConfig": { "contentType": "text/plain", "statusCode": "503", "messageBody": "503 error text" } }

3. 创建Ingress。

   kubectl create -f ingress-test.yaml

   回显如下，表示Ingress服务已创建。

   ingress/ingress-test created

4. 查看已创建的Ingress。

   kubectl get ingress

   回显如下，表示Ingress服务创建成功。

   NAME          CLASS    HOSTS     ADDRESS          PORTS   AGE
   ingress-test  cce      *         121.**.**.**     80      10s

ELB Ingress支持配置访问限速。以下示例中，当用户访问该Ingress时，会对访问进行限速，每秒查询速率（QPS）为4，并设置每个客户端源IP的QPS为2，允许短时间超过限制的缓冲区大小为2。

具体操作及参数配置说明如下：

1. 请参见通过kubectl连接集群，使用kubectl连接集群。
2. 创建名为“ingress-test.yaml”的YAML文件，此处文件名可自定义。

   vi ingress-test.yaml

   以使用已有ELB创建Ingress的场景为例，YAML配置如下：

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     annotations:
       kubernetes.io/elb.class: performance
       kubernetes.io/elb.id: *****
       kubernetes.io/elb.port: "80"
       # 以下注解对名为test-service的Service生效，为其配置访问限速
       kubernetes.io/elb.actions.test-service: |
        [{ 
          "type": "TrafficLimit", 
          "trafficLimitConfig": { 
              "QPS": 4,
              "perSourceIpQps": 2,
              "burst": 2
          } 
        }]
     name: ingress-test
     namespace: default
   spec:
     ingressClassName: cce
     rules:
       - http:
           paths:
             - backend:
                 service:
                   name: test-service
                   port:
                     number: 80
               path: /
               pathType: ImplementationSpecific
               property:
                 ingress.beta.kubernetes.io/url-match-mode: STARTS_WITH

   表9 高级转发动作注解

   参数	类型	描述
   kubernetes.io/elb.actions.${svc_name}	String	为Ingress配置高级转发动作，${svc_name}即对应的Service名称，其最大长度为51个字符。 如果该注解值配置成[]则表示删除所有高级转发动作。 配置限速的注解值格式为JSON字符串数组，具体参数请参见表10。

   表10 限速参数配置说明

   参数	使用说明	示例
   type	固定值为“TrafficLimit”，表示为ELB配置限速。 说明： 高级转发动作注解中最多添加1条限速配置。	-
   trafficLimitConfig	QPS：总限速，每秒查询速率，支持的取值范围为0~100000，0表示不限速。请求速率超过设置的限速后，新建连接请求将被丢弃，并会返回给客户端503状态码。 perSourceIpQps：可选参数，基于客户端源IP进行限速，支持的取值范围为0~100000，0表示不限速。 同时配置QPS（总限速）和perSourceIpQps（基于客户端源IP限速）时，基于客户端源IP限速值要小于总限速值。请求速率超过设置的限速后，新建连接请求将被丢弃，并会返回给客户端503状态码。 burst：可选参数，限速缓冲区大小，支持的取值范围为0~100000。限速burst允许短时间内超过设置的平均速率，以应对突发请求。例如，如果限速值是5，但是burst是10，那么1s内，可以访问超过5个请求，如果达到10个请求，又会回落到5。 注意： 配置trafficLimitConfig后，在CCE侧删除其中的字段不会在ELB生效，您可以通过指定参数值为0值来定义不限速，也可以通过删除整个trafficLimitConfig字段删除限速配置。	{ "type": "TrafficLimit", "trafficLimitConfig": { "QPS": "4", "perSourceIpQps": "2", "burst": "2" } }

3. 创建Ingress。

   kubectl create -f ingress-test.yaml

   回显如下，表示Ingress服务已创建。

   ingress/ingress-test created

4. 查看已创建的Ingress。

   kubectl get ingress

   回显如下，表示Ingress服务创建成功。

   NAME          CLASS    HOSTS     ADDRESS          PORTS   AGE
   ingress-test  cce      *         121.**.**.**     80      10s

• ELB Ingress配置自定义后端服务器组的功能依赖ELB能力，使用该功能前请提交工单申请开通ELB相关能力。
• 配置自定义后端服务器组不可与灰度发布、返回固定响应、重定向到URL同时使用。
• ELB Ingress配置自定义后端服务器组时，定义Ingress后端Service时的number字段失效，且必须指定Service端口名为use-annotation，详情请参见以下示例。
• ELB Ingress配置自定义后端服务器组时，不可配置重复的Service名称和重复的后端服务器组ID。
• ELB Ingress配置自定义后端服务器组时，如果同时配置kubernetes.io/elb.slowstart或kubernetes.io/elb.pool-protocol注解，上述注解仅对CCE自动创建的默认后端服务器组生效，将不会对ELB侧的自定义后端服务器组生效。

您可以将Ingress的访问请求转发到多个自定义的后端服务器组，不同的后端服务器组间通过权重分配流量。以下示例中，当用户通过example.com域名访问时，流量会被分配至两个后端服务器组：一部分流量分配至集群中名为test的Service，权重为90；另一部分流量分配至ELB后端服务器组，权重为70。

具体操作及参数配置说明如下：

1. 请参见通过kubectl连接集群，使用kubectl连接集群。
2. 创建名为“ingress-test.yaml”的YAML文件，此处文件名可自定义。

   vi ingress-test.yaml

   以使用已有ELB创建Ingress的场景为例，YAML配置如下：

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     annotations:
       kubernetes.io/elb.class: performance
       kubernetes.io/elb.id: *****
       kubernetes.io/elb.port: "80"
       # 以下注解为该Ingress同时配置一个Service和一个ELB后端服务器组，其中forward-demo为下文backend字段中的服务名称
       kubernetes.io/elb.actions.forward-demo: |
        [{ 
          "type": "ForwardPool", 
          "forwardConfig": [{ 
             "serviceName": "test",
             "servicePort": 80,
             "weight": 90,
             "type": "service"
             },{ 
             "poolID": "*****", 
             "weight": 70,
             "type": "pool"
          }]
        }] 
     name: ingress-test
     namespace: default
   spec:
     ingressClassName: cce
     rules:
       - host: example.com
         http:
           paths:
             - backend:
                 service:
                   name: forward-demo   # 配置自定义后端服务器组时，annotation中指定的Service名称需要与之对应，本示例中为forward-demo
                   port:
                     name: use-annotation   # 配置自定义后端服务器组时，原有的port.number字段失效，必须指定port.name参数且参数值固定为use-annotation
               path: /
               pathType: ImplementationSpecific
               property:
                 ingress.beta.kubernetes.io/url-match-mode: STARTS_WITH

   表11 高级转发动作注解

   参数	类型	描述
   kubernetes.io/elb.actions.${svc_name}	String	为Ingress配置高级转发动作，${svc_name}即对应的Service名称，其最大长度为51个字符。 如果该注解值配置成[]则表示删除所有高级转发动作。 配置自定义后端服务器组的注解值格式为JSON字符串数组，具体参数请参见表12。

   表12 自定义后端服务器组参数配置说明

   参数	使用说明	示例
   type	固定值为“ForwardPool”，表示为ELB配置自定义后端服务器组。 说明： 高级转发动作注解中最多添加1条自定义后端服务器组配置。	-
   forwardConfig	说明： forwardConfig中最多添加5条自定义后端服务器组配置。 type：自定义转发的后端服务器组，可指定“service”和“pool”。 service：转发的对象为Service类型，将由CCE自动创建Service对应的后端服务器组，并负责维护其生命周期。 pool：转发的对象为自定义后端服务器组，您需要在ELB侧自行创建并维护。 poolID：type指定为“pool”时填写。 后端服务器组的ID，需填写Ingress对应ELB下的后端服务器组，且不可重复配置相同的后端服务器组ID。 您可以前往后端服务器组控制台，通过Ingress对应ELB的名称或ELB ID查询该ELB下的后端服务器组，并获取后端服务器组ID。 serviceName：type指定为“service”时填写。 Service名称，您需要确认该Service在集群中真实存在，且不可重复配置相同的Service名称。 servicePort：type指定为“service”时填写。 Service端口。 weight：不同后端服务器组的流量分配权重，流量将根据权重的比值进行分配，权重取值范围为0-100。	{ "type": "ForwardPool", "forwardConfig": [{ "serviceName": "test", "servicePort": 80, "weight": 90, "type": "service" },{ "poolID": "53d8516e-xxxx-xxxx-xxxx-b15ffd6b3cca", "weight": 70, "type": "pool" }] }

3. 创建Ingress。

   kubectl create -f ingress-test.yaml

   回显如下，表示Ingress服务已创建。

   ingress/ingress-test created

4. 查看已创建的Ingress。

   kubectl get ingress

   回显如下，表示Ingress服务创建成功。

   NAME          CLASS    HOSTS         ADDRESS          PORTS   AGE
   ingress-test  cce      example.com   121.**.**.**     80      10s