文档中心

容器服务

自定义转发规则配置示例

配置转发流量重定向

ALB Ingress 支持配置流量重定向，当请求经过 ALB 时，ALB 可以将特定的访问请求重定向至指定的路径。

注意

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

前提条件

使用限制

操作步骤

通过控制台配置

说明

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

配置项	说明
转发条件	配置转发条件，包括域名、路径和 HTTP 标头。转发条件允许单独配置，也可以组合配置。当配置多个转发条件组合时，这些转发条件之间是且的关系。例如，假设您在一条转发规则中同时配置了域名和路径，只有同时匹配指定域名和路径的请求，才会匹配这条转发规则。同一转发条件下允许配置多个值，这些值之间是或的关系。例如，假设您在域名转发条件下配置了多个值，当请求的域名匹配其中任何一个值时，即满足该转发条件。
转发动作	转发动作选择重定向至，并配置重定向规则。协议：重定向使用的协议，支持 HTTP、HTTPS。域名：重定向域名。仅支持精确域名。若未配置，则默认与请求域名保持一致。端口：重定向端口。取值范围为 1～65535。若未配置，则默认与请求端口保持一致。 URI：重定向 URI。必须以正斜线/开头。仅允许包含字母、数字、-、_、/、.、%、?、#、&、＝等字符。长度限制为 1～128 个字符。若未配置，则默认与请求 URI 保持一致。状态码：重定向状态码，支持301、302、307、308。

通过 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	自定义转发规则的动作类型，当配置重定向时，必须配置为Redirect。	无
redirectConfig.host	String	重定向域名。仅支持精确域名。	无
redirectConfig.path	String	重定向 URI。必须以正斜线/开头。仅允许包含字母、数字、-、_、/、.、%、?、#、&、＝等字符。长度限制为 1～128 个字符。	无
redirectConfig.httpCode	String	重定向状态码，支持301、302、307、308。	无
redirectConfig.port	Integer	重定向端口。取值范围为 1～65535。	无
redirectConfig.protocol	String	重定向使用的协议，支持 HTTP、HTTPS。	无

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

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

字段	类型	描述	默认值
host	String	匹配重定向规则的转发域名。	无
path	String	匹配重定向规则的转发路径。	无
ruleAction	String	配置转发规则动作。取值：空：表示默认转发至服务器组。 Redirect：表示开启重定向。	Redirect
redirectConfig	Array of redirectConfig	转发重定向规则。	无

redirectConfig

字段	类型	描述	默认值
domain	String	重定向域名。仅支持精确域名。若该参数不指定，则为默认值（空），最终效果为与请求域名保持一致。	无
uri	String	重定向 URI。必须以正斜线/开头。仅允许包含字母、数字、-、_、/、.、%、?、#、&、＝等字符。长度限制为 1～128 个字符。若该参数不指定，则为默认值（空），最终效果为与请求 URI 保持一致。	空
port	Integer	重定向端口。取值范围为 1～65535。若该参数不指定，将赋值为默认值（空），最终效果为与请求端口保持一致。	空
httpCode	String	重定向状态码，支持 301、302、307、308。若该参数不指定，则为默认值 301。	301
protocol	String	重定向使用的协议，支持 HTTP、HTTPS。若该参数不指定，则为默认值 HTTPS 。	HTTPS