# ELB Ingress注解（Annotations）配置合集 通过在YAML中添加注解（Annotations），您可以实现更多的Ingress高级功能。本文介绍在创建ELB类型的Ingress时可供使用的Annotation。 #### 索引 | 功能分类 | Ingress注解配置 | |:---|:---| | ELB配置 | - [对接ELB的基本配置] - [添加资源标签] - [为自动创建的ELB配置回收策略] | | 证书与安全管理 | - [配置ELB证书] - [配置双向认证] - [黑名单/白名单设置] | | 协议与监听配置 | - [使用HTTP/2] - [对接HTTPS/GRPC协议的后端服务] - [配置多个监听端口] - [配置QUIC监听器] - [配置新建与并发限速] | | 路由转发策略 | - [配置高级转发规则] - [配置高级转发动作] - [配置URL重定向] - [配置Rewrite重写] - [配置HTTP重定向到HTTPS] - [配置转发规则优先级] - [配置自定义Header转发策略] - [配置HTTP/HTTPS头字段] | | 流量与性能调优配置 | - [配置灰度发布] - [配置Ingress超时时间] - [设置慢启动持续时间] - [开启gzip压缩] | | 网络与后端配置 | - [配置自定义EIP] - [配置跨域访问] - [配置IP类型的后端] | ![](https://support.huaweicloud.com/usermanual-cce/public_sys-resources/notice_3.0-zh-cn.png) 在同一个集群中，多个Ingress可以使用同一个监听器（即使用同一个负载均衡器的同一个端口）。如果两个Ingress设置了不同的监听器配置，则实际生效的监听器配置将以最早创建的Ingress（简称为"首路由"）配置为准。关于如何确认首路由，详情请参见[如何确认监听器配置生效的Ingress](https://support.huaweicloud.com/cce_faq/cce_faq_00460.html)。 涉及以下场景： - [配置ELB证书] - [使用HTTP/2] - [配置Ingress超时时间] - [黑名单/白名单设置] - [配置HTTP/HTTPS头字段] - [开启gzip压缩] 如果不同的Ingress设置了不同的监听器配置，建议同步每个Ingress中的监听器配置。详情请参见[同一集群中多个Ingress使用同一个ELB的配置说明](https://support.huaweicloud.com/usermanual-cce/cce_10_0954.html)。 #### ELB配置 #### 对接ELB的基本配置 具体使用场景和示例如下： - 关联已有ELB场景：详情请参见[添加Ingress时对接已有ELB](https://support.huaweicloud.com/usermanual-cce/cce_10_0252.html#cce_10_0252__section32300431736) - 自动创建ELB场景：详情请参见[添加Ingress时自动创建ELB](https://support.huaweicloud.com/usermanual-cce/cce_10_0252.html#cce_10_0252__section3675115714214) 表1对接ELB注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.class | String | 请根据不同的应用场景和功能需求选择合适的负载均衡器类型。**该参数在创建完成后不可修改**。 取值如下： - union：共享型负载均衡。 - performance：独享型负载均衡，仅支持1.17及以上集群，详情请参见[共享型弹性负载均衡与独享型负载均衡的功能区别](https://support.huaweicloud.com/productdesc-elb/elb_pro_0004.html)。 默认值为"union" | v1.9及以上 | | kubernetes.io/ingress.class | String | - cce：表示使用自研ELB Ingress。 - nginx：表示使用Nginx Ingress，未安装NGINX Ingress控制器插件时无法使用，详情请参见[通过Kubectl命令行创建Nginx Ingress](https://support.huaweicloud.com/usermanual-cce/cce_10_0364.html)。 当NGINX Ingress控制器插件为2.5.4及以上时，集群中支持同时安装多套NGINX Ingress控制器，该参数值需设置为安装控制器时指定的自定义[控制器名称](https://support.huaweicloud.com/usermanual-cce/cce_10_0034.html#cce_10_0034__li0953175016455)，表示该Ingress由此控制器进行管理。 创建Ingress时必须增加该参数，默认值为cce。 v1.23及以上集群使用ingressClassName参数代替，详情请参见[通过Kubectl命令行创建ELB Ingress](https://support.huaweicloud.com/usermanual-cce/cce_10_0252.html)。 | 仅v1.21及以下集群 | | kubernetes.io/elb.port | String | 界面上的对外端口，为注册到负载均衡服务地址上的端口。 取值范围：1\~65535，HTTP协议默认为80，HTTPS协议默认为443。 说明： 共享型ELB的部分端口为高危端口，默认被屏蔽，如21端口。 | v1.9及以上 | | kubernetes.io/elb.id | String | **仅关联已有ELB的场景** ：该参数可与kubernetes.io/elb.ip二选一填写，二者产生冲突时以kubernetes.io/elb.id为准。**该参数在创建完成后不可修改**。 为负载均衡实例的ID。 **获取方法：** 登录[ELB控制台](https://console.huaweicloud.com/vpc/#/elb/list/grid)，单击ELB的名称，在ELB详情页的"基本信息"页签下找到"ID"字段复制即可。 | v1.9及以上 | | kubernetes.io/elb.ip | String | **仅关联已有ELB的场景** ：该参数可与kubernetes.io/elb.id二选一填写，二者产生冲突时以kubernetes.io/elb.id为准。**该参数在创建完成后不可修改**。 为负载均衡实例的服务地址。 创建Ingress时，共享型ELB支持指定公网IP或私网IP，独享型ELB只支持指定私网IP。 | v1.9及以上 | | kubernetes.io/elb.autocreate | [表2] Object | **仅自动创建ELB的场景** ：必填。**该参数在创建完成后不可修改**。 注意： kubernetes.io/elb.id 和kubernetes.io/elb.autocreate不能同时填写。 如果在Service中同时填写以上两个注解，CCE优先使用已有的ELB实例，而不会再自动创建新的ELB实例。在这种情况下如果删除Service，这个已有的ELB会被系统视作自动创建，如果该ELB未关联其他资源，则会被同时删除。 **示例：** - 自动创建公网独享型ELB： 值为'{"type":"public","bandwidth_name":"cce-bandwidth-1741230802502","bandwidth_chargemode":"bandwidth","bandwidth_size":5,"bandwidth_sharetype":"PER","eip_type":"5_bgp","available_zone":\["\*\*\*\*\*"\],"elb_virsubnet_ids":\["\*\*\*\*\*"\],"l7_flavor_name":"L7_flavor.elb.pro.max","l4_flavor_name":"","vip_subnet_cidr_id":"\*\*\*\*\*"}' - 自动创建私网独享型ELB： 值为'{"type":"inner","available_zone":\["\*\*\*\*\*"\],"elb_virsubnet_ids":\["\*\*\*\*\*"\],"l7_flavor_name":"L7_flavor.elb.pro.max","l4_flavor_name":"","vip_subnet_cidr_id":"\*\*\*\*\*"}' - 自动创建公网共享型ELB： 值为 '{"type":"public","bandwidth_name":"cce-bandwidth-1551163379627","bandwidth_chargemode":"bandwidth","bandwidth_size":5,"bandwidth_sharetype":"PER","eip_type":"5_bgp","name":"james"}' - 自动创建私网共享型ELB： 值为 '{"type":"inner", "name": "A-location-d-test"}' - 自动创建加入共享带宽的公网独享型ELB： 值为'{"type":"public","bandwidth_id":"\*\*\*\*\*","bandwidth_sharetype":"WHOLE","eip_type":"5_bgp","available_zone":\["\*\*\*\*\*"\],"elb_virsubnet_ids":\["\*\*\*\*\*"\],"l7_flavor_name":"","l4_flavor_name":"L4_flavor.elb.pro.max","vip_subnet_cidr_id":"\*\*\*\*\*"}' - 自动创建加入共享带宽的公网共享型ELB： 值为'{"type":"public","bandwidth_id":"\*\*\*\*\*","bandwidth_sharetype":"WHOLE","eip_type":"5_bgp","name":"james"}' | v1.9及以上 | | kubernetes.io/elb.enterpriseID | String | **仅自动创建ELB的场景**：选填。 **v1.15及以上版本的集群支持此字段，v1.15以下版本默认创建到default项目下。** 为ELB企业项目ID，选择后可以直接创建在具体的ELB企业项目下。 该字段不传（或传为字符串'0'），则将资源绑定给默认企业项目。 **获取方法：** 登录[企业项目管理控制台](https://console.huaweicloud.com/eps/#/projects/list)，单击企业项目名称，在详情页找到"ID"字段复制即可。 | v1.15及以上 | | kubernetes.io/elb.subnet-id | String | **仅自动创建ELB的场景**：选填。 为集群所在子网的ID，取值范围：1-100字符。 - Kubernetes v1.11.7-r0及以下版本的集群自动创建时：必填 - Kubernetes v1.11.7-r0以上版本的集群：可不填。 | v1.11.7-r0以下必填 v1.11.7-r0以上该字段废弃 | #### 附：关于自动创建ELB的参数说明 表2elb.autocreate字段数据结构说明 | 参数 | 是否必填 | 参数类型 | 描述 | |:---|:---|:---|:---| | name | 否 | String | 自动创建的负载均衡的名称。 取值范围：只能由中文、英文字母、数字、下划线、中划线、点组成，且长度范围为1-64个字符。 默认名称：cce-lb+service.UID | | type | 否 | String | 负载均衡实例网络类型，公网或者私网。 - public：公网型负载均衡 - inner：私网型负载均衡 默认类型：inner | | bandwidth_id | 否 | String | 共享带宽ID。使用已存在的共享带宽时填写。集群版本需满足v1.30.14-r100、v1.31.14-r60、v1.32.13-r30、v1.33.12-r10、v1.34.8-r10、v1.35.5-r10、v1.36.2-r0及以上。 | | bandwidth_name | 公网型负载均衡且共享带宽ID为空时必填。 | String | 带宽的名称，默认值为：cce-bandwidth-\*\*\*\*\*\*。 取值范围：只能由中文、英文字母、数字、下划线、中划线、点组成，且长度范围为1-64个字符。 | | bandwidth_chargemode | 公网型负载均衡且共享带宽ID为空时必填。 | String | 带宽付费模式。 - bandwidth：按带宽 - traffic：按流量 | | bandwidth_size | 公网型负载均衡且共享带宽ID为空时必填。 | Integer | 带宽大小，默认1Mbit/s\~2000Mbit/s，请根据Region带宽支持范围设置。 调整带宽时的最小单位会根据带宽范围不同存在差异。 - 小于等于300Mbit/s：默认最小单位为1Mbit/s。 - 300Mbit/s\~1000Mbit/s：默认最小单位为50Mbit/s。 - 大于1000Mbit/s：默认最小单位为500Mbit/s。 | | bandwidth_sharetype | 公网型负载均衡且共享带宽ID为空时必填。 | String | 带宽共享方式。 - PER：独享带宽 - WHOLE：共享带宽。仅v1.30.14-r100、v1.31.14-r60、v1.32.13-r30、v1.33.12-r10、v1.34.8-r10、v1.35.5-r10、v1.36.2-r0及以上版本支持。 说明： 该字段为WHOLE时，必须指定共享带宽ID。 | | eip_type | 公网型负载均衡必填 | String | 弹性公网IP类型。 - 5_telcom：电信 - 5_union：联通 - 5_bgp：全动态BGP - 5_sbgp：静态BGP 具体类型以各区域配置为准，详情请参见弹性公网IP控制台。 | | vip_subnet_cidr_id | 否 | String | 填写子网的IPv4子网ID，指定ELB所在的子网，用于分配ELB实例对外服务的IP地址，该子网必须属于集群所在的VPC。 如不指定，则默认与集群在同一个子网。 仅v1.21及以上版本的集群支持指定该字段。 **获取方式：** 登录[VPC控制台](https://console.huaweicloud.com/vpc/#/vpc/vpcs/list)，在左侧导航栏选择"子网"，根据集群所在的VPC名称筛选子网，单击子网名称，在"基本信息"页签下找到"IPv4子网ID"字段复制即可。 | | ipv6_vip_virsubnet_id | 否 | String | 双栈类型负载均衡器所在IPv6子网的网络ID，需要对应的子网开启IPv6。 独享型负载均衡器独有字段。 **获取方式：** 登录[VPC控制台](https://console.huaweicloud.com/vpc/#/vpc/vpcs/list)，在左侧导航栏选择"子网"，根据集群所在的VPC名称筛选子网，单击子网名称，在"基本信息"页签下找到"网络ID"字段复制即可。 | | elb_virsubnet_ids | 否 | Array of strings | 填写子网的网络ID，指定负载均衡后端所在子网，用于分配与后端服务建立连接的IP地址，不填默认为vip_subnet_cidr_id参数所选的子网。不同实例规格将占用不同数量子网IP，不建议使用其他资源（如集群，节点等）的子网网段。 独享型负载均衡器独有字段。 示例： ``` "elb_virsubnet_ids": [ "14567f27-8ae4-42b8-ae47-9f847a4690dd" ] ``` **获取方式：** 登录[VPC控制台](https://console.huaweicloud.com/vpc/#/vpc/vpcs/list)，在左侧导航栏选择"子网"，根据集群所在的VPC名称筛选子网，单击子网名称，在"基本信息"页签下找到"网络ID"字段复制即可。 | | vip_address | 否 | String | 负载均衡器的内网IP。仅支持指定IPv4地址，不支持指定IPv6地址。 该IP必须为ELB所在子网网段中的IP。若不指定，自动从ELB所在子网网段中生成一个IP地址。 仅v1.23.11-r0、v1.25.6-r0、v1.27.3-r0及以上版本集群支持指定该字段。 | | available_zone | 是 | Array of strings | 负载均衡所在可用区。 可以通过[查询可用区列表](https://support.huaweicloud.com/api-elb/ListAvailabilityZones.html)获取所有支持的可用区。 独享型负载均衡器独有字段。 | | l4_flavor_name | 否 | String | 四层负载均衡实例规格名称。需要使用TCP、UDP、TLS协议时必填。 可以通过[查询规格列表](https://support.huaweicloud.com/api-elb/ListFlavors.html)获取所有支持的类型。 - 弹性规格：适用于业务用量波动较大的场景，按实际使用量收取每小时使用的容量费用。v1.21.10-r10、v1.23.8-r10、v1.25.3-r10及以上版本集群支持使用弹性规格。 - 固定规格：适用于业务用量较为稳定的场景，按固定规格折算收取每小时使用的容量费用。 独享型负载均衡器独有字段。 | | l7_flavor_name | 否 | String | 七层负载均衡实例规格名称。使用HTTP/HTTPS协议时必填。 可以通过[查询规格列表](https://support.huaweicloud.com/api-elb/ListFlavors.html)获取所有支持的类型。 - 弹性规格：适用于业务用量波动较大的场景，按实际使用量收取每小时使用的容量费用。v1.21.10-r10、v1.23.8-r10、v1.25.3-r10及以上版本集群支持使用弹性规格。 - 固定规格：适用于业务用量较为稳定的场景，按固定规格折算收取每小时使用的容量费用。 独享型负载均衡器独有字段，必须与l4_flavor_name对应规格的类型一致，即都为弹性规格或都为固定规格。 | #### 添加资源标签 具体使用场景和示例请参见[添加Ingress时自动创建ELB](https://support.huaweicloud.com/usermanual-cce/cce_10_0252.html#cce_10_0252__section3675115714214)。 表3添加资源标签注解 | 参数 | 类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.tags | String | 为ELB添加资源标签，仅自动创建ELB时支持设置。 格式为key=value，同时添加多个标签时以英文逗号（,）隔开。 | v1.23.11-r0、v1.25.6-r0、v1.27.3-r0v1.23.8-r1、v1.25.3-r1及以上 | #### 为自动创建的ELB配置回收策略 表4为自动创建的ELB配置回收策略注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.instance-reclaim-policy | String | **仅自动创建ELB的场景**：选填。 为自动创建的ELB配置回收策略，取值如下： - 不填或为空（默认行为）：在删除Service/Ingress时删除自动创建的ELB。但是ELB被多个Service/Ingress关联时，如果先删除自动创建ELB的Service/Ingress，即使最后删除了所有的Service/Ingress，ELB也可能残留。 - retain：在删除Service/Ingress时保留自动创建的ELB。 - alwaysDelete：在删除Service/Ingress时会删除自动创建的ELB。若ELB被多个Service/Ingress关联，删除所有的关联该ELB的Service/Ingress后，会保证该ELB被同步删除。 说明： - 当ELB被其他资源关联，或者计费模式转为包年/包月后，即使没有配置回收策略retain，也会保留自动创建的ELB。 - 若多个Service/Ingress使用同一自动创建的ELB，仅在创建了该ELB的Service/Ingress上配置该参数才生效。 | v1.28.15-r60、v1.29.15-r20、v1.30.14-r20、v1.31.10-r20、v1.32.6-r20、v1.33.5-r10及以上 | 上述注解的使用方法如下： ``` apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: ingress-1 namespace: default annotations: kubernetes.io/elb.port: '80' kubernetes.io/elb.class: performance kubernetes.io/elb.autocreate: '{"type":"inner","available_zone":["******"],"elb_virsubnet_ids":["*****"],"ipv6_vip_virsubnet_id":"******","l7_flavor_name":"L7_flavor.elb.pro.max","l4_flavor_name":"","vip_subnet_cidr_id":"******"}' kubernetes.io/elb.enterpriseID: '0' kubernetes.io/elb.instance-reclaim-policy: retain # 为自动创建的ELB配置回收策略 spec: rules: - host: '' http: paths: - path: / backend: service: name: service-1 port: number: 80 property: ingress.beta.kubernetes.io/url-match-mode: STARTS_WITH pathType: ImplementationSpecific ingressClassName: cce ``` #### 证书与安全管理 #### 配置ELB证书 具体使用场景和示例请参见[为ELB Ingress配置HTTPS证书](https://support.huaweicloud.com/usermanual-cce/cce_10_0687.html)。 表5配置ELB证书注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.tls-certificate-ids | String | ELB服务中的证书ID列表，不同ID间使用英文逗号隔开，列表长度大于等于1。列表中的首个ID为服务器证书，其余ID为SNI证书（SNI证书中必须带有域名）。独享型ELB最多支持50本SNI证书，共享型ELB最多支持30本SNI证书。 获取方法：登录[ELB控制台](https://console.huaweicloud.com/vpc/#/elb/list/grid)，选择"证书管理"。在列表中复制对应证书名称下的ID即可。 | v1.19.16-r2、v1.21.5-r0、v1.23.3-r0及以上版本 | | kubernetes.io/elb.tls-ciphers-policy | String | 默认值为"tls-1-2"，为监听器使用的默认安全策略，仅在HTTPS协议下生效。 取值范围： - tls-1-0 - tls-1-1 - tls-1-2 - tls-1-2-strict - tls-1-0-with-1-3（独享型实例） - tls-1-2-fs（独享型实例） - tls-1-2-fs-with-1-3（独享型实例） 各安全策略使用的加密套件列表详细参见[表3](https://support.huaweicloud.com/usermanual-cce/cce_10_0687.html#cce_10_0687__table9419191416246)。 | v1.17.17及以上版本 | | kubernetes.io/elb.security_policy_id | String | ELB中自定义安全组策略ID，请前往ELB控制台获取。该字段仅在HTTPS协议下生效，且优先级高于默认安全策略。 自定义安全策略的创建、更新步骤请参见[TLS安全策略](https://support.huaweicloud.com/usermanual-elb/elb_ug_jt_0022.html)。 | v1.17.17及以上版本 | #### 配置双向认证 表6配置双向认证注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.client-ca-cert-id | String | 仅配置双向认证时填写该注解，ELB服务中的证书ID，作为CA证书。 获取方法：在[ELB控制台](https://console.huaweicloud.com/vpc/#/elb/list/grid)，选择"证书管理"。在列表中复制对应证书名称下的ID即可。 | 在v1.28.15-r60、v1.29.15-r20、v1.30.14-r20、v1.31.10-r20、v1.32.6-r20、v1.33.5-r10及以上版本的集群支持。 | 上述注解的使用方法如下： ``` apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: test namespace: default annotations: kubernetes.io/elb.port: '443' kubernetes.io/elb.id: ***** kubernetes.io/elb.class: performance kubernetes.io/elb.tls-certificate-ids: ***** kubernetes.io/elb.client-ca-cert-id: ***** # 配置双向认证 spec: rules: - host: '' http: paths: - path: / backend: service: name: test port: number: 80 property: ingress.beta.kubernetes.io/url-match-mode: STARTS_WITH pathType: ImplementationSpecific ingressClassName: cce ``` #### 黑名单/白名单设置 具体使用场景和示例请参见[为ELB Ingress配置黑名单/白名单访问策略](https://support.huaweicloud.com/usermanual-cce/cce_10_0832.html)。 表7ELB访问控制注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.acl-id | String | - 不填写该参数时：表示CCE不对ELB侧访问控制进行修改。 - 参数值填写为空值时：表示允许所有IP访问。 - 参数值填写为ELB的IP地址组ID时：表示开启访问控制，为ELB设置IP地址黑名单或白名单。此时需同时填写kubernetes.io/elb.acl-status和kubernetes.io/elb.acl-type参数。 说明： v1.25.16-r10、v1.27.16-r10、v1.28.15-r0、v1.29.10-r0、v1.30.6-r0、v1.31.1-r0及以上版本的集群中，使用独享型ELB时可同时填写多个IP地址组，最多同时填写5个，用英文逗号分隔。 **获取方法：** 登录[ELB控制台](https://console.huaweicloud.com/vpc/#/elb/list/grid)，单击"弹性负载均衡 \> IP地址组"，复制目标IP地址组的"ID"即可。详情请参见[IP地址组](https://support.huaweicloud.com/usermanual-elb/elb_ug_ip_0000.html)。 | v1.23.12-r0、v1.25.7-r0、v1.27.4-r0、v1.28.2-r0及以上 | | kubernetes.io/elb.acl-status | String | 为ELB设置IP地址黑名单或白名单时需填写，取值如下： - on或true：表示开启访问控制。 - off或false：表示不开启访问控制。 | v1.23.12-r0、v1.25.7-r0、v1.27.4-r0、v1.28.2-r0及以上 | | kubernetes.io/elb.acl-type | String | 为ELB设置IP地址黑名单或白名单时需填写，取值如下： - black：表示黑名单，所选IP地址组无法访问ELB地址。 - white：表示白名单，仅所选IP地址组可以访问ELB地址。 | v1.23.12-r0、v1.25.7-r0、v1.27.4-r0、v1.28.2-r0及以上 | #### 协议与监听配置 #### 使用HTTP/2 具体使用场景和示例请参见[为ELB Ingress配置HTTP/2](https://support.huaweicloud.com/usermanual-cce/cce_10_0694.html)。 表8使用HTTP/2注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.http2-enable | String | 表示HTTP/2功能的开启状态。开启后，可提升客户端与ELB间的访问性能，但ELB与后端服务器间仍采用HTTP1.X协议。 取值范围： - true：开启HTTP/2功能； - false：关闭HTTP/2功能（默认为关闭状态）。 注意：**只有当监听器的协议为HTTPS时，才支持开启或关闭HTTP/2功能**。当监听器的协议为HTTP时，该字段无效，默认将其设置为false。 | v1.23.13-r0、v1.25.8-r0、v1.27.5-r0、v1.28.3-r0及以上版本 | #### 对接HTTPS/GRPC协议的后端服务 具体使用场景和示例请参见[为ELB Ingress配置HTTPS协议的后端服务](https://support.huaweicloud.com/usermanual-cce/cce_10_0691.html)和[为ELB Ingress配置GRPC协议的后端服务](https://support.huaweicloud.com/usermanual-cce/cce_10_0790.html)。 表9对接HTTPS协议的后端服务注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.pool-protocol | String | 对接HTTPS协议的后端服务，取值为'https'。 | v1.23.8、v1.25.3及以上 | | kubernetes.io/elb.pool-protocol | String | 对接GRPC协议的后端服务，取值为'grpc'。 | v1.23.10-r20、v1.25.5-r20、v1.27.2-r20、v1.28.1-r0及以上 | #### 配置多个监听端口 当前支持Ingress配置自定义监听端口。通过该方式，可以将服务同时暴露80端口和443端口。 具体使用场景和示例请参见[为ELB Ingress配置多个监听端口](https://support.huaweicloud.com/usermanual-cce/cce_10_0937.html)。 表10自定义监听端口注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.listen-ports | String | 为同一个Ingress创建多个监听端口，端口号范围为1\~65535。 参数值为JSON格式的字符串，示例如下： ``` kubernetes.io/elb.listen-ports: '[{"HTTP":80},{"HTTPS":443}]' ``` - 仅支持同时配置HTTP和HTTPS协议的监听端口。 - v1.23.18-r10、v1.25.16-r0、v1.27.16-r0、v1.28.13-r0、v1.29.8-r0、v1.30.4-r0以下集群版本中仅支持新建Ingress场景，且配置多个监听端口后annotation不支持修改和删除。v1.23.18-r10、v1.25.16-r0、v1.27.16-r0、v1.28.13-r0、v1.29.8-r0、v1.30.4-r0及以上集群版本中支持修改和删除。 - 同时指定多监听器（kubernetes.io/elb.listen-ports）和单监听器（kubernetes.io/elb.port）配置时，多监听器优先级更高。 - Ingress内配置项对多个监听器同时生效，如黑白名单配置、超时时间配置。Ingress开启HTTP/2配置时，HTTP/2仅在HTTPS端口生效。 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | #### 配置QUIC监听器 具体使用场景和示例请参见[为ELB Ingress配置QUIC监听器](https://support.huaweicloud.com/usermanual-cce/cce_10_1101.html)。 表11配置QUIC监听器注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.protocol | String | ELB监听器前端协议，配置QUIC前端协议时必须指定为QUIC。 | v1.28.15-r80、v1.29.15-r40、v1.30.14-r40、v1.31.14-r0、v1.32.9-r0、v1.33.7-r0、v1.34.2-r0及以上 | #### 配置新建与并发限速 具体使用场景和示例请参见[为ELB Ingress监听器配置新建与并发连接限速](https://support.huaweicloud.com/usermanual-cce/cce_10_11010.html)。 表12配置新建与并发限速注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.cps | Integer | **参数解释**：监听器新建限速。 **约束限制**：当该限速值大于LB的限速值时，以LB的限速值生效。 **取值范围**：0-1000000 **默认取值**：0，表示不限速。 | v1.30.14-r100、v1.31.14-r60、v1.32.13-r30、v1.33.12-r10、v1.34.8-r10、v1.35.5-r10、v1.36.2-r0及以上 | | kubernetes.io/elb.connection | Integer | **参数解释**：监听器并发限速 **约束限制**：当该限速值大于LB的限速值时，以LB的限速值生效。 **取值范围**：0-1000000 **默认取值**：0，表示不限速。 | v1.30.14-r100、v1.31.14-r60、v1.32.13-r30、v1.33.12-r10、v1.34.8-r10、v1.35.5-r10、v1.36.2-r0及以上 | #### 路由转发策略 #### 配置高级转发规则 具体使用场景和示例请参见[为ELB Ingress配置高级转发策略](https://support.huaweicloud.com/usermanual-cce/cce_10_0949.html)。 表13高级转发规则注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.conditions.*${svc_name}* | String | 配置高级转发规则，*${svc_name}*即对应的Service名称，其最大长度为51个字符。 如果该annotation值配置成*\[\]*则表示删除相应的高级转发规则。 注解值格式为Json字符串数组，具体格式请参见[表4](https://support.huaweicloud.com/usermanual-cce/cce_10_0949.html#cce_10_0949__cce_10_0940_table18956183913383)。 须知： - 由于ELB的API限制，conditions设置的数量上限为10，即一条kubernetes.io/elb.conditions.{svcName}中，最多包含十条key-value键值对。 - 一条conditions中的数组中不同的规则是"与"关系，但同一个规则块中的值是"或"关系。例如，Method和QueryString两种转发条件都配置时，需要同时满足，才能实现目标流量分发。但如果Method值为GET，POST，即只需要满足Method为GET或POST，且QueryString满足条件即可。 | v1.23.18-r10、v1.25.16-r0、v1.27.16-r0、v1.28.13-r0、v1.29.8-r0、v1.30.4-r0及以上版本 | #### 配置高级转发动作 具体使用场景和示例请参见[为ELB Ingress配置高级转发策略](https://support.huaweicloud.com/usermanual-cce/cce_10_0949.html)。 表14配置高级转发动作注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.actions.*${svc_name}* | String | Ingress关联的Service配置高级转发动作，*${svc_name}*即对应的Service名称，其最大长度为51个字符。 注解值格式为JSON字符串数组，如果配置成*\[\]*则表示删除相应的高级转发动作。 支持以下高级转发动作： - [写入/删除Header](https://support.huaweicloud.com/usermanual-cce/cce_10_0949.html#cce_10_0949__section776311276199) - [返回固定响应](https://support.huaweicloud.com/usermanual-cce/cce_10_0949.html#cce_10_0949__section1848134064919) - [限速](https://support.huaweicloud.com/usermanual-cce/cce_10_0949.html#cce_10_0949__section1026923902417) - [自定义后端服务器组](https://support.huaweicloud.com/usermanual-cce/cce_10_0949.html#cce_10_0949__section8498141262) - [配置流量镜像](https://support.huaweicloud.com/usermanual-cce/cce_10_0949.html#cce_10_0949__section4511200183916) | 不同的转发动作支持的集群版本不同，详情请参见[表2](https://support.huaweicloud.com/usermanual-cce/cce_10_0949.html#cce_10_0949__table17914047164212)。 | #### 配置URL重定向 具体使用场景和示例请参见[为ELB Ingress配置URL重定向](https://support.huaweicloud.com/usermanual-cce/cce_10_0690.html)。 表15配置URL重定向注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.redirect-url | String | 重定向URL信息。 格式说明： - HTTPS协议的Ingress：支持以"https://" 开头的合法的URL，如 https://example.com/。 - HTTP协议的Ingress：支持以 "http://" 或 "https://" 开头的合法的URL，如https://example.com/。 参数说明：对单个Ingress下所有的转发规则均生效，配置删除后自动清理对应的重定向URL规则。 该注解不能和灰度发布的注解一起配置。 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | | kubernetes.io/elb.redirect-url-code | String | 重定向URL后的返回码。 格式说明：支持返回码包括"301"、"302"、"303"、"307"、"308"。 参数说明：默认值为"301"。 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | #### 配置Rewrite重写 具体使用场景和示例请参见[为ELB Ingress配置Rewrite重写](https://support.huaweicloud.com/usermanual-cce/cce_10_0770.html)。 表16配置Rewrite重写注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.rewrite-target | String | 重写路径的信息。 格式说明：以 "/" 开头的合理的正则匹配规则。 参数说明：对单个Ingress下正则匹配的URL转发规则生效，配置删除后自动清理对应的重写规则。 该注解不能和灰度发布的注解一起配置。 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | #### 配置HTTP重定向到HTTPS 具体使用场景和示例请参见[为ELB Ingress配置HTTP重定向到HTTPS](https://support.huaweicloud.com/usermanual-cce/cce_10_0771.html)。 表17配置HTTP重定向到HTTPS注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.ssl-redirect | String | 是否开启HTTP重定向到HTTPS。 格式说明：支持字段 "true" 和 "false" 参数说明："true" 表示开启重定向能力，"false"或参数不存在表示不开启重定向能力 说明： 该注解不能和灰度发布的注解一起配置。 | 使用独享型ELB：集群版本为v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上 使用共享型ELB：集群版本为v1.27.16-r50、v1.28.15-r40、v1.29.15-r0、v1.30.14-r0、v1.31.10-r0、v1.32.6-r0、v1.33.1-r0及以上 | #### 配置转发规则优先级 Ingress使用同一个ELB监听器时，支持按照以下规则进行转发规则优先级排序： - 不同Ingress的转发规则：按照"kubernetes.io/elb.ingress-order"注解的优先级（取值范围为1\~1000）进行排序，值越小表示优先级越高。 - 同一个Ingress的转发规则："kubernetes.io/elb.rule-priority-enabled"注解设置为"true"时，根据创建Ingress时的转发规则先后顺序进行排序，配置在上面的优先级高；未配置该注解时，同一个Ingress的转发规则会使用ELB侧的默认排序。 未配置以上注解时，同一个ELB监听器下无论包含多个Ingress还是同一个Ingress的转发规则，都会使用ELB侧的默认排序规则。 具体使用场景和说明请参见[为ELB Ingress配置转发规则优先级](https://support.huaweicloud.com/usermanual-cce/cce_10_0939.html)。 表18转发规则优先级注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.ingress-order | String | 不同Ingress间的转发规则排序，参数值越小表示优先级越高，且同一个监听内规则优先级必须唯一，取值范围为1\~1000。 仅独享型ELB支持配置。 说明： - 配置该注解时，默认开启"kubernetes.io/elb.rule-priority-enabled"注解，即同时对每个Ingress的转发规则进行排序。 - CCE会将按照Ingress间的排序和Ingress内的转发策略的配置情况，对同一监听器下的所有转发策略进行整体排序。配置的数值不等于ELB的转发策略优先级。 | v1.23.15-r0、v1.25.10-r0、v1.27.7-r0、v1.28.5-r0、v1.29.1-r10及以上版本 | | kubernetes.io/elb.rule-priority-enabled | String | 仅支持设置为"true"，表示对同一个Ingress的转发规则进行排序，系统将会根据创建Ingress时的转发规则先后顺序确定优先级，配置在上面的优先级高。 未开启该参数时，同一个Ingress的转发规则会使用ELB侧的默认排序，开启后则不允许关闭。 仅独享型ELB支持配置。 | v1.23.15-r0、v1.25.10-r0、v1.27.7-r0、v1.28.5-r0、v1.29.1-r10及以上版本 | #### 配置自定义Header转发策略 具体使用场景和示例请参见[为ELB Ingress配置自定义Header转发策略](https://support.huaweicloud.com/usermanual-cce/cce_10_0896.html)。 表19自定义Header转发策略注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.headers.*${svc_name}* | String | Ingress关联的Service配置自定义的Header，${svc_name}即对应的Service名称。 格式说明：Json字符串，如 {"key": "test", "values": \["value1", "value2"\]} - key/value表示自定义Header的键值对，value最多可以配置9个（如果同时配置了host，则只能配置8个value）。 key的取值范围：长度限制1-40字符，只允许包含字母、数字、中划线（-）和下划线（_） value的取值范围：长度限制1-128字符，不支持空格，双引号，支持以下通配符：\*（匹配0个或更多字符）和?（正好匹配1个字符） - 不能和灰度发布同时配置 - svc_name最大长度51个字符 | v1.23.16-r0、v1.25.11-r0、v1.27.8-r0、v1.28.6-r0、v1.29.2-r0及以上版本 | #### 配置HTTP/HTTPS头字段 具体使用场景和示例请参见[为ELB Ingress配置HTTP/HTTPS头字段](https://support.huaweicloud.com/usermanual-cce/cce_10_0867.html)。 表20配置HTTP/HTTPS头字段注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.x-forwarded-port | String | ELB可通过X-Forwarded-Port头字段获取监听器的端口号，传输到后端服务器的报文中。 - true：开启获取监听器端口号开关。 - false：关闭获取监听器端口号开关。 | v1.23.13-r0、v1.25.8-r0、v1.27.5-r0、v1.28.3-r0及以上版本 | | kubernetes.io/elb.x-forwarded-for-port | String | ELB可通过X-Forwarded-For-Port头字段获取客户端请求的端口号，传输到后端服务器的报文中。 - true：开启获取客户端请求端口号开关。 - false：关闭获取客户端请求端口号开关。 | v1.23.13-r0、v1.25.8-r0、v1.27.5-r0、v1.28.3-r0及以上版本 | | kubernetes.io/elb.x-forwarded-host | String | - true：开启重写X-Forwarded-Host开关，ELB以客户端请求头的Host重写X-Forwarded-Host传递到后端服务器。 - false：关闭重写X-Forwarded-Host开关，ELB透传客户端的X-Forwarded-Host到后端服务器。 | v1.23.13-r0、v1.25.8-r0、v1.27.5-r0、v1.28.3-r0及以上版本 | | kubernetes.io/elb.x-real-ip | String | - true：开启重写X-Real-IP开关，ELB以客户端的源IP地址重写X-Real-IP传递到后端服务器 - false：关闭重写X-Real-IP开关，ELB透传客户端的X-Real-IP到后端服务器。 | v1.25.16-r30、v1.27.16-r30、v1.28.15-r20、v1.29.13-r0、v1.30.10-r0、v1.31.6-r0、v1.32.1-r0及以上版本 | #### 流量与性能调优配置 #### 配置灰度发布 具体使用场景和示例请参见[为ELB Ingress配置灰度发布](https://support.huaweicloud.com/usermanual-cce/cce_10_0736.html)。 表21灰度发布参数说明 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.canary | string | 设置Ingress灰度发布的开关。设置为true后，配合不同的注解，可以实现不同的灰度发布功能。 取值范围：true - 独享型负载均衡器生效。 - 设置为true后，不允许删除或修改。 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | | kubernetes.io/elb.canary-weight | string | 权重灰度发布权重值，设置后Ingress以权重灰度形式发布。 - 取值为0-100的整数，为灰度流量分配的百分比。 - 发布成权重灰度Ingress时，该参数必填。 - 不能与其他灰度发布功能同时设置。 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | | kubernetes.io/elb.session-affinity-mode | string | 开启权重灰度发布后，配置会话保持能力。 灰度发布仅支持设置为 "HTTP_COOKIE"。 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | | kubernetes.io/ elb.session-affinity-option | string | 开启权重灰度发布会话保持能力后，会话保持的超时时间。 参数值为json字符串，格式如下： ``` {"persistence_timeout": "1440"} ``` 参数说明： - 超时时间范围为1-1440。 - 默认值为1440。 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | | kubernetes.io/elb.canary-by-header | string | header灰度发布的Key值，表示请求头参数的名称。需要与kubernetes.io/elb.canary-by-header-value成对使用。 参数说明： 长度限制1-40字符，只允许包含字母、数字、中划线（-）和下划线（_）。 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | | kubernetes.io/elb.canary-by-header-value | string | header灰度发布的Values值，需要与kubernetes.io/elb.canary-by-header成对使用。 参数值为json格式的数组，例如： ``` '{"values":["a","b"]}' ``` 参数说明： - Values数组长度：至少需要配置1个Values值。 - 如果Ingress转发策略配置了域名和路径，最多支持配置8个Values值。 - 如果Ingress转发策略仅配置了路径，最多支持配置9个Values值。 - Values数组取值：长度限制1-128字符，不支持空格，双引号，支持以下通配符：\*（匹配0个或更多字符）和？（正好匹配1个字符）。 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | | kubernetes.io/elb.canary-by-cookie | string | cookie灰度发布的key值，表示请求cookie参数的名称。需要与kubernetes.io/elb.canary-by-cookie-value成对使用。 参数说明： 长度限制1-100字符，支持包含字母、数字、以及 !%'"()\*+,./:=?@\^\\\\-_\`\~ 等字符。 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | | kubernetes.io/elb.canary-by-cookie-value | string | cookie灰度发布的values值，需要与kubernetes.io/elb.canary-by-cookie成对使用。 参数值为json格式的数组，例如： ``` '{"values":["a","b"]}' ``` 参数说明： - Values数组长度：至少需要配置1个Values值。 - 如果Ingress转发策略配置了域名和路径，最多支持配置8个Values值。 - 如果Ingress转发策略仅配置了路径，最多支持配置9个Values值。 - Values数组取值：长度限制1-100字符，不支持空格，支持包含字母、数字、以及 !%'"()\*+,./:=?@\^\\\\-_\`\~ 等字符。 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | | kubernetes.io/elb.canary-related-ingress-uid | string | 灰度发布Ingress关联的原始Ingress的uid信息，用于前端展示原始Ingress和灰度发布的Ingress的关联关系。 ● 参数格式：字符串 ● 取值：原始Ingress的metadata.uid字段 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | #### 配置Ingress超时时间 具体使用场景和示例请参见[为ELB Ingress配置超时时间](https://support.huaweicloud.com/usermanual-cce/cce_10_0730.html)。 表22配置Ingress超时时间注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.keepalive_timeout | String | 客户端连接空闲超时时间，在超过keepalive_timeout时长一直没有请求， 负载均衡会暂时中断当前连接，直到下一次请求时重新建立新的连接。 取值范围为0-4000s，默认值为60s。 | 独享型ELB：v1.19.16-r30、v1.21.10-r10、v1.23.8-r10、v1.25.3-r10及以上 共享型ELB：v1.23.13-r0、v1.25.8-r0、v1.27.5-r0、v1.28.3-r0及以上版本 | | kubernetes.io/elb.client_timeout | String | 等待客户端请求超时时间，包括两种情况： - 读取整个客户端请求头的超时时长：如果客户端未在超时时长内发送完整个请求头，则请求将被中断 - 两个连续body体的数据包到达LB的时间间隔，超出client_timeout将会断开连接。 取值范围为1-300s，默认值为60s。 | 独享型ELB：v1.19.16-r30、v1.21.10-r10、v1.23.8-r10、v1.25.3-r10及以上 共享型ELB：v1.23.13-r0、v1.25.8-r0、v1.27.5-r0、v1.28.3-r0及以上版本 | | kubernetes.io/elb.member_timeout | String | 等待后端服务器响应超时时间。请求转发后端服务器后，在等待超时member_timeout时长没有响应，负载均衡将终止等待，并返回 HTTP504错误码。 取值范围为1-300s，默认值为60s。 | 独享型ELB：v1.19.16-r30、v1.21.10-r10、v1.23.8-r10、v1.25.3-r10及以上 共享型ELB：v1.23.13-r0、v1.25.8-r0、v1.27.5-r0、v1.28.3-r0及以上版本 | #### 设置慢启动持续时间 具体使用场景和示例请参见[为ELB Ingress配置慢启动持续时间](https://support.huaweicloud.com/usermanual-cce/cce_10_0735.html)。 表23设置慢启动持续时间注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.slowstart | String | 参数说明：慢启动持续时间，单位秒。 取值范围：30-1200。 - 独享型负载均衡器生效。 - 目标服务分配策略类型为加权轮询算法且不开启会话保持时生效。 说明： 负载均衡器向慢启动模式下Pod线性增加请求分配权重，当配置的慢启动持续时间期限结束后，负载均衡器向Pod发送完整的请求比例，此后本次添加的后端服务器退出慢启动模式。 | v1.23及以上 | #### 开启gzip压缩 具体使用场景和示例请参见[为ELB Ingress配置gzip数据压缩](https://support.huaweicloud.com/usermanual-cce/cce_10_0868.html)。 表24开启gzip压缩注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.gzip-enabled | String | LoadBalancer支持开启数据压缩，通过数据压缩可缩小传输文件大小，提升文件传输效率减少带宽消耗。 开启将对特定文件类型进行压缩，关闭则不会对任何文件类型进行压缩。在默认情况下数据压缩为关闭。 支持的压缩类型如下： - Brotli支持压缩所有类型。 - Gzip支持压缩的类型包括：text/xml text/plain text/css application/javascript application/x-javascript application/rss+xml application/atom+xml application/xml application/json。 仅独享型ELB的HTTP/HTTPS类型监听器支持配置。删除开启数据压缩高级配置或对应的annotation，将不会对ELB侧配置进行修改。 | v1.23.14-r0、v1.25.9-r0、v1.27.6-r0、v1.28.4-r0及以上版本 | #### 网络与后端配置 #### 配置自定义EIP 具体使用场景和示例请参见[为ELB Ingress配置自定义EIP](https://support.huaweicloud.com/usermanual-cce/cce_10_0925.html)。 表25配置自定义EIP注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.custom-eip-id | String | 自定义EIP的ID，您可以前往EIP控制台查看。该EIP必须是处于可绑定状态。 | v1.23.18-r0、v1.25.13-r0、v1.27.10-r0、v1.28.8-r0、v1.29.4-r0、v1.30.1-r0及以上版本 | #### 配置跨域访问 具体使用场景和示例请参见[为ELB Ingress配置跨域访问](https://support.huaweicloud.com/usermanual-cce/cce_10_0931.html)。 表26配置跨域访问注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.cors-allow-origin | Array\[string\] | 指定Access-Control-Allow-Origin响应头的值，表示允许访问的域。 支持以下取值： - 通配符\*：表示允许所有域名访问。 - 配置域名列表：必须为http://或者https://开头的域名，支持填写一级泛域名。格式为"http(s)://example.com"或"http(s)://example.com:port"，端口范围为1\~65535。 可填写多个值，以英文逗号分隔。 | v1.23.18-r10、v1.25.16-r0、v1.27.16-r0、v1.28.13-r0、v1.29.8-r0、v1.30.4-r0及以上版本 | | kubernetes.io/elb.cors-allow-headers | Array\[string\] | 指定Access-Control-Allow-Headers响应头的值，表示允许的请求头。可填写多个值，以英文逗号分隔。 | v1.23.18-r10、v1.25.16-r0、v1.27.16-r0、v1.28.13-r0、v1.29.8-r0、v1.30.4-r0及以上版本 | | kubernetes.io/elb.cors-expose-headers | Array\[string\] | 指定Access-Control-Expose-Headers响应头的值，表示可以被跨域请求读取的自定义响应头部，例如通过客户端的JavaScript代码获取非标准响应头字段。可填写多个值，以英文逗号分隔。 | v1.23.18-r10、v1.25.16-r0、v1.27.16-r0、v1.28.13-r0、v1.29.8-r0、v1.30.4-r0及以上版本 | | kubernetes.io/elb.cors-allow-methods | Array\[string\] | 指定Access-Control-Allow-Methods响应头的值，表示允许的HTTP请求方法。 可填写多个值，以英文逗号分隔。 | v1.23.18-r10、v1.25.16-r0、v1.27.16-r0、v1.28.13-r0、v1.29.8-r0、v1.30.4-r0及以上版本 | | kubernetes.io/elb.cors-allow-credentials | String | 指定Access-Control-Allow-Credentials响应头的值，表示是否允许发送凭据（如Cookies）。 取值如下： - true：允许发送凭据。 - false：不允许发送凭据。 设置后不允许删除，如需可通过kubernetes.io/elb.cors-disabled删除所有跨域配置。 | v1.23.18-r10、v1.25.16-r0、v1.27.16-r0、v1.28.13-r0、v1.29.8-r0、v1.30.4-r0及以上版本 | | kubernetes.io/elb.cors-max-age | String | 指定Access-Control-Max-Age响应头的值，表示CORS预检请求的缓存时长。单位：秒。取值范围：**-1** \~**172800**。 该参数值应该根据实际需求合理设置。如果设置得太短，可能会导致频繁的预检请求；如果设置得太长，可能会在CORS策略更新后延迟生效。 | v1.23.18-r10、v1.25.16-r0、v1.27.16-r0、v1.28.13-r0、v1.29.8-r0、v1.30.4-r0及以上版本 | | kubernetes.io/elb.cors-disabled | String | 该参数用于关闭所有跨域配置。取值如下： - **true**：关闭所有跨域配置。YAML中的参数值不会被删除，但所有配置均不生效。 - **false**：默认取值，跨域配置将根据用户设置生效。 | v1.23.18-r10、v1.25.16-r0、v1.27.16-r0、v1.28.13-r0、v1.29.8-r0、v1.30.4-r0及以上版本 | #### 配置IP类型的后端 具体使用场景和说明请参见[为ELB Ingress配置IP类型的后端](https://support.huaweicloud.com/usermanual-cce/cce_10_1022.html)。 表27配置IP类型的后端注解 | 参数 | 参数类型 | 描述 | 支持的集群版本 | |:---|:---|:---|:---| | kubernetes.io/elb.ip-target-enabled | String | 表示为ELB配置IP类型的后端，启用后该Service/Ingress添加的后端地址均为VPC子网内的IP。其中CCE Turbo集群的后端为\:\，CCE Standard集群的后端为\<节点IP\>:\。 - true：表示配置IP类型的后端。 - 不支持其他取值 注意： - 仅独享型ELB支持该特性。 - 该特性仅在创建Service/Ingress时支持开启，已经存在的Service/Ingress无法添加和删除该annotations，如需使用特性，请新建Service/Ingress。 - 如果Service/Ingress所使用的负载均衡器未开启IP类型后端功能，添加annotations后CCE会自动开启开关，且开启后无法关闭。 - 请确保Service/Ingress所使用的负载均衡器后端子网有足够的IP地址，否则该功能无法正常使用。您可以通过负载均衡器的"基本信息 \> 后端子网"添加多个后端子网来增加后端子网的IP地址。 - 其他注意事项请参考[通过IP类型后端功能添加服务器至ELB](https://support.huaweicloud.com/bestpractice-elb/elb_bp_0301.html)。 | v1.25.16-r30、v1.27.16-r30、v1.28.15-r20、v1.29.13-r0、v1.30.10-r0、v1.31.6-r0、v1.32.1-r0及以上版本 |