文档中心

容器服务

自定义转发规则配置示例

配置转发至多个后端服务

ALB Ingress 支持在配置转发规则时，配置多个后端服务器组，允许指定集群中的 Service 或已存在的后端服务器组。当请求经过 ALB 时，ALB 可以按照权重向不同后端服务器组转发。

注意

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

前提条件

操作步骤

通过控制台配置

说明

仅对接 ALB 标准版时支持使用控制台配置，如需对接 ALB 基础版，请参见下文中的 YAML 配置。

配置项	说明
转发条件	配置转发条件，包括域名、路径和 HTTP 标头。转发条件允许单独配置，也可以组合配置。当配置多个转发条件组合时，这些转发条件之间是且的关系。例如，假设您在一条转发规则中同时配置了域名和路径，只有同时匹配指定域名和路径的请求，才会匹配这条转发规则。同一转发条件下允许配置多个值，这些值之间是或的关系。例如，假设您在域名转发条件下配置了多个值，当请求的域名匹配其中任何一个值时，即满足该转发条件。
转发动作	配置请求被转发到的目标服务和端口。本例中选择转发至动作。服务名称：选择集群中已存在的服务名称。若无可用服务，请参考服务创建服务。端口：选择对应服务的端口号。权重：配置对应服务的权重，取值范围为 0～100。当服务器组数量为 1 时，默认权重为 100。当服务器组的权重设为 0 时，表示 ALB 不会转发客户端流量至该服务器组。说明当配置多个服务时，多个服务权重之和不要求为 100。ALB 能够根据每个服务的权重，按比例将客户端流量转发至对应的服务。详情请参见服务器组的权重。

通过 kubectl 命令行配置

ALB Ingress 支持通过 Annotation 指定多个后端服务器组。对接 ALB 标准版和基础版时的配置略有不同。

ALB 标准版

ALB 基础版

ALB 标准版的配置示例和注解说明，如下所示：

注意

注解中的{{service-name}}字段必须与spec.rules中配置的后端服务名称对应一致，例如在本例中，正确的注解为ingress.vke.volcengine.com/loadbalancer-actions.service-demo。

ingress.vke.volcengine.com/loadbalancer-actions.{{service-name}}注解中的参数说明如下表所示。

字段	类型	描述	默认值
type	String	自定义转发规则的动作类型，当配置转发至多个后端服务器组时，必须配置为ForwardGroup。	无
forwardGroupConfig	Object of StickySessionConfig	后端服务器组间会话保持配置。	无
backends	Array of BackendConfig	后端服务器配置。	无

StickySessionConfig

字段	类型	描述	默认值
serverGroupStickySession.enabled	String	是否开启后端服务组组间会话保持功能，取值： on：开启 off：禁用	禁用
serverGroupStickySession.timeout	Integer	配置后端服务组组间会话保持超时时间。取值范围：1～86400。单位：秒。默认值：1000。	1000

BackendConfig

字段	类型	描述	默认值
serviceName	String	后端服务名称。若无可用服务，请参考服务创建服务。	无
weight	Integer	后端服务权重，取值范围为 0～100。当服务器组数量为 1 时，默认权重为 100。当服务器组的权重设为 0 时，表示 ALB 不会转发客户端流量至该服务器组。说明当配置多个服务时，多个服务权重之和不要求为 100。ALB 能够根据每个服务的权重，按比例将客户端流量转发至对应的服务。详情请参见服务器组的权重。	无
servicePort	Integer	后端服务的端口号。取值范围为 1～65535。	无

ALB Ingress 支持通过 Annotation 指定多个后端服务器组。后端服务器组支持配置为集群中的 Service，也支持通过 ID 指定 ALB 中已存在的服务器组。示例和注解说明如下：

ingress.vke.volcengine.com/loadbalancer-rules-config-forwad注解中的参数说明如下表所示。

字段	类型	描述	默认值
host	String	匹配转发规则中的域名。	无
path	String	匹配转发规则中的路径。	无
serverGroups	Array of serverGroupConfig	配置 ALB Ingress 后端服务器组。最多支持配置 5 个后端服务器组。	无
stickySessionEnabled	Boolean	是否开启组间会话保持。取值： true：开启。 false：不开启。	false
stickySessionCookieTimeout	Integer	服务器组间会话保持超时时间。单位为秒，取值范围为 1～86400。	1000

serverGroupConfig

字段	类型	描述	默认值
serviceName	String	集群中的服务名称。说明配置该字段时，必须同时配置servicePort字段。	无
servicePort	Integer	服务端口号。取值范围：1～65535	80（HTTP）443（HTTPS）
serverGroupID	String	已存在后端服务器组 ID。说明该字段与serviceName字段不能同时配置。	无
weight	Integer	后端服务器组权重，取值范围为 0～100。当服务器组数量为 1，且未指定此参数时，默认权重为 100。当服务器组的权重设为 0 时，表示 ALB 不会转发客户端流量至该服务器组。说明更多服务器权重说明，请参见服务器组的权重。	无