文档中心

容器服务

请输入

CLB Ingress

通过控制台创建 CLB Ingress

CLB Ingress 采用自研 Ingress Controller 结合负载均衡的方式，提供更强大的 Ingress 流量管理。本文主要描述通过控制台配置 CLB Ingress 的方法。

注意

配置 CLB Ingress 前，请务必仔细阅读 CLB Ingress 使用注意事项。

前提条件

已安装 kubectl 工具到本地。具体操作说明，请参见安装和设置 kubectl。

已通过 Kubectl 连接目标集群。具体操作说明，请参见连接集群。

已创建服务，详情请参见创建服务。

操作步骤

登录容器服务控制台。

单击左侧导航栏中的集群。

在集群列表页面，单击需要配置路由规则的目标集群。

在集群管理页面的左侧导航栏中，选择服务与路由 > 路由规则，单击创建路由规则，创建路由规则。

基本配置

参数	说明
名称	根据系统提示，配置路由规则的名称。在同一个命名空间下，名称必须唯一。
命名空间	选择路由规则所属的命名空间。建议选择您自定义的命名空间，或系统默认创建的 default 命名空间。命名空间相关介绍，请参见命名空间概述。
注解	单击添加注解，为路由规则添加注解并配置键值对。也可通过配置路由规则 YAML 文件中特定的注解内容，以实现更加丰富的七层负载均衡能力和更加多样的服务路由规则。详细说明，请参见使用 Annotation 配置 CLB Ingress。

Ingress 配置

参数
说明
ingress 类型
配置 Ingress Controller 的类型，本例中选择负载均衡 CLB。

负载均衡器配置

参数	说明
直通 Pod 模式	仅 VPC-CNI 容器网络模型集群中显示该参数。默认开启，开启后不再通过 NodePort 转发，直接关联 Pod 作为负载均衡器的后端，同时支持健康检查。注意 CLB 负载均衡器允许的后端服务器数有限，需自行规划和保证。详细限制，请参见 CLB 约束限制。
负载均衡器	按需选择已有或自动创建一个负载均衡器。支持公网访问和私网访问两种访问模式。使用已有：仅支持已有的且未被容器服务使用的 CLB 实例。使用已有 CLB 实例时不覆盖该实例已有的监听器规则。非特殊情况建议选择全新创建的 CLB 实例。自动创建：自动创建新的 CLB 实例。您需要配置以下参数，详细参数说明，请参见创建负载均衡实例：注意请勿将该自动创建的 CLB 实例使用到其他 Ingress 或者 Service 资源中，避免资源残留。通过容器服务创建的 CLB，支持多可用区能力。若当前地域的负载均衡器支持跨可用区容灾，将默认创建主备可用区负载均衡器实例，当主可用区故障时，访问流量切换至备可用区，从而保障业务正常运行。名称：根据系统提示的命名规则，自定义负载均衡器的名称。子网：为负载均衡器实例提供私网部署环境，分配私网 IP 地址。负载均衡器实例创建成功后，不支持修改私网 IP 地址。线路类型：提供公网服务的线路类型，不同类型的线路在性能和计费标准上存在差异。支持 BGP（多线）、融合 BGP、中国移动、中国电信和中国联通。注意除 BGP（多线）外，其他线路类型均为 EIP 产品的邀测功能，如需使用，请联系客户经理申请。计费方式：负载均衡器的计费方式，当前支持如下两种：按量计费-按带宽上限：指定带宽上限后，将按照使用时长计费，与实际流量无关。按量计费-按实际流量：指定带宽上限后，将按照实际使用的出公网流量计费，与使用时长无关。带宽上限：公网 IP 的带宽上限，单位为 Mbps。实例创建后，您可以随时按需调整公网带宽上限。 IP 版本：IP 地址版本类型。当前仅支持 IPv4。实例规格：CLB 实例规格。您可以根据不同业务场景对性能的要求，选择适合的规格。规格说明，请参见产品类型与规格。
监听器	监听器负责监听负载均衡器上的请求，并分发流量。您需要配置监听器的调度算法和健康检查：调度算法：指定监听器转发请求时需要遵循的规则。加权轮询（WRR）：基于权重值进行流量的分发，权重值越高的后端服务器，被轮询到的次数（概率）越高。加权最小连接数（WLC）：优先将流量分发给当前连接数与权重比值最小的后端。源地址哈希（SH）：基于源 IP 地址的一致性哈希，相同源地址的请求会调度到相同的后端服务器。健康检查：按需选择是否启用健康检查。若启用健康检查，需要配置以下参数：说明 CLB Ingress 类型路由规则的健康检查路径仅支持/，且不可配置。健康检查方法：对监听器进行健康检查的请求方法，支持 GET 或 HEAD。默认采用 GET 方法。使用 HEAD 方法，服务器仅返回 HEAD 头部信息，可以降低后端开销，但要求服务器支持 HEAD 方法。使用 GET 方法，要求服务器支持 GET 方法。正常状态码：如收到此处选中类型的响应码，则判定该服务器为正常状态。默认选中 2xx 和 3xx。响应超时：等待健康检查响应的时间。如果后端服务器在指定的时间内没有正确响应，则判定为健康检查异常。检测间隔：执行健康检查的时间间隔。默认间隔为 2 秒，表示每 2 秒对后端服务器进行一次健康检查。注意检测间隔时间需大于响应超时时间。健康阈值：判断后端服务器正常的健康检查次数。默认为 3 次，表示连续执行 3 次健康检查，结果均为“正常”的后端服务器则判定为健康检查正常。不健康阈值：判断后端服务器异常的健康检查次数。默认为 3 次，表示连续执行 3 次健康检查，结果均为“异常”的后端服务器则判定为健康检查异常。

监听配置

参数	说明
协议	监听器的协议。容器服务支持 HTTP 和 HTTPS 两种对外协议。创建完成路由规则时，CLB 实例根据您的监听配置，自动创建监听器，名称默认为k8s_ <CLB Ingress 所在命名空间>_<CLB Ingress 路由规则名称>_<端口号>，例如k8s_ default_demo-ingress_80。
端口号	监听器监听的端口号。若不填写，则 HTTP 协议时，默认监听80端口； HTTPS 协议时，默认监听443端口。
证书	当协议选择 HTTPS 时，需要选择服务器证书，以支持数据传输加密认证。您需要通过创建密钥，绑定服务器证书，默认全部域名使用同一个密钥。在证书来源下拉菜单中选择证书的来源，支持全部来源、负载均衡 CLB 或证书中心。在密钥下拉菜单中选择对应的密钥，如无密钥，可以单击创建密钥，创建新的密钥：名称：根据系统提示的命名规则，设置密钥名称。同一个命名空间下名称须唯一。命名空间：选择与本路由规则相同的命名空间。证书来源：选择加密证书来源，支持负载均衡 CLB 和证书中心。项目：选择证书所在的项目。服务器证书：选择服务器证书。说明【邀测·申请试用】：使用证书中心的证书创建 HTTPS 协议的 CLB Ingress 目前处于邀测阶段，如需使用，请联系客户经理。

转发配置

参数

说明

转发规则

请求的访问地址与转发规则匹配时，该请求会被转发到对应的服务（Service）处理。单击添加转发策略，可添加多条转发策略。

域名：请求的域名与此处设置的域名匹配时，请求会被转发到指定的服务。

注意

不支持以*结尾的域名。

路径：请求的路径与此处设置的路径匹配时，请求会被转发到指定的服务。

路径匹配规则：负载均衡 CLB Ingress 类型的路由规则，当前仅支持前缀匹配，表示只要符合此前缀的路径均可访问。例如路径为/foo，则/foo/v1，/foo/v2都可以访问后端服务。

服务：请求被转发到的目标服务和端口。若无可用服务，请参考服务创建服务。

注意

当集群的容器网络模型为 Flannel 时，仅支持关联和选择 NodePort、LoadBalancer（非直通 Pod）类型的服务。

当集群的容器网络模型为 VPC-CNI 时：

若 Ingress 开启了直通 Pod 模式，则支持关联和选择 NodePort、LoadBalancer（直通或非直通 Pod）、ClusterIP 类型的服务。

若 Ingress 未开启直通 Pod 模式，则仅支持关联和选择 NodePort、LoadBalancer（直通或非直通 Pod）类型的服务。

单击确认，完成配置。

最近更新时间：2026.04.07 14:29:42

这个页面对您有帮助吗？

有用

无用

参数	说明
ingress 类型	配置 Ingress Controller 的类型，本例中选择负载均衡 CLB。