为ELB Ingress配置URL重定向

Ingress支持将特定的访问请求重定向至指定的路径。配置Ingress重定向规则的YAML示例如下，本示例将访问example.com的请求重定向至指定路径example.com/testa，并返回301状态码。

前提条件

已创建一个CCE Standard或CCE Turbo集群，且集群版本满足以下要求：
- v1.23集群：v1.23.14-r0及以上
- v1.25集群：v1.25.9-r0及以上
- v1.27集群：v1.27.6-r0及以上
- v1.28集群：v1.28.4-r0及以上
- 其他更高版本的集群
集群中需提前部署可用的工作负载用于对外提供访问。若您无可用工作负载，可参考创建无状态负载（Deployment）、创建有状态负载（StatefulSet）或创建守护进程集（DaemonSet）部署工作负载。
为提供对外访问的工作负载配置Service，ELB Ingress支持的Service类型请参见ELB Ingress支持的Service类型。

约束与限制

仅使用独享型ELB时，Ingress支持配置URL重定向。

配置Ingress重定向至URL规则

您可以使用以下方式配置Ingress重定向至URL规则。

登录CCE控制台，单击集群名称进入集群。
选择左侧导航栏的“服务”，在右侧选择“路由”页签，单击右上角“创建路由”。

设置Ingress参数。

本示例中展示配置URL重定向的关键参数，其余参数可按需配置，详情请参见通过控制台创建ELB Ingress。

表1 关键参数说明
参数	配置说明	示例
名称	自定义Ingress名称。	ingress-test
负载均衡器	选择对接的ELB实例或自动创建ELB实例。本例中仅支持选择“独享型”。	独享型ELB
监听器配置	前端协议：可选择“HTTP”或“HTTPS”。对外端口：ELB监听器的端口。	前端协议：“HTTP” 对外端口：80
转发策略配置	域名：实际访问的域名地址，不配置时可通过IP地址访问Ingress。请确保所填写的域名已注册并备案，一旦配置了域名规则后，必须使用域名访问。路径匹配规则：支持前缀匹配、精确匹配、正则匹配，请按需选择。路径：后端应用对外提供访问的路径，此处添加的访问路径要求后端应用内存在相同的路径，否则转发无法生效。目标服务名称：请选择已有Service或新建Service。页面列表中的查询结果已自动过滤不符合要求的Service。目标服务访问端口：可选择目标Service的访问端口。执行动作动作：选择“重定向至URL”，当访问请求满足转发策略时，会将请求重定向至指定的URL，并返回指定的状态码。 URL：以 "http://" 或 "https://" 开头的合法的URL。说明： HTTP协议的路由，支持重定向到HTTP/HTTPS协议；HTTPS协议的路由，只能重定向到HTTPS协议。返回码：支持返回码包括"301"、"302"、"303"、"307"、"308"。	域名：example.com 路径匹配规则：前缀匹配路径：/ 目标服务名称：nginx 目标服务访问端口：80 执行动作：动作：重定向至URL URL：https://example.com/testa 返回码：301

图1 配置重定向至URL规则
点击放大

配置完成后，单击“确定”。

Ingress重定向至URL可通过注解实现，示例如下：

请参见通过kubectl连接集群，使用kubectl连接集群。

创建名为“ingress-test.yaml”的YAML文件，此处文件名可自定义。

vi ingress-test.yaml

以关联已有ELB为例，YAML配置文件如下：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: test-redirect-url
  namespace: default
  annotations:
    kubernetes.io/elb.id: df76342f-e898-402a-bac8-bde5bf974da8
    kubernetes.io/elb.class: performance
    kubernetes.io/elb.port: '80'
    kubernetes.io/elb.redirect-url: https://example.com/testa        # 重定向URL的信息
    kubernetes.io/elb.redirect-url-code: '301'     # 重定向URL后的返回码
spec:
  rules:
    - host: "example.com"
      http:
        paths:
          - path: /
            backend:
              service:
                name: test-service
                port:
                  number: 80
            property:
              ingress.beta.kubernetes.io/url-match-mode: STARTS_WITH
            pathType: ImplementationSpecific
  ingressClassName: cce

表2 关键参数说明
参数	是否必填	参数类型	描述
kubernetes.io/elb.redirect-url	是	string	重定向URL信息。格式说明：以 "http://" 或 "https://" 开头的合法的URL，如 https://example.com/。参数说明：对单个Ingress下所有的转发规则均生效，配置删除后自动清理对应的重定向URL规则。该注解不能和灰度发布的注解一起配置。
kubernetes.io/elb.redirect-url-code	否	string	重定向URL后的返回码。格式说明：支持返回码包括"301"、"302"、"303"、"307"、"308"。参数说明：默认值为"301"。

创建Ingress。

kubectl create -f ingress-test.yaml

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

ingress/test-redirect-url created

查看已创建的Ingress。

kubectl get ingress

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

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

使用curl测试重定向后的能力，其中${ELB_IP}为Ingress访问的IP。

curl -I -H "Host:example.com" ${ELB_IP}

最终访问路径会被重定向至example.com/testa。

HTTP/1.1 301 Moved Permanently
Date: Thu, 07 Mar 2024 11:04:31 GMT
Content-Type: text/html
Content-Length: 134
Connection: keep-alive
Location: https://example.com/testa
Server: elb

父主题： ELB Ingress高级配置示例

上一篇：为ELB Ingress配置gzip数据压缩

下一篇：为ELB Ingress配置Rewrite重写