k8s中的nginx-ingress如何配置路径重定向?

一. 需求描述

路径重定向的一般应用场景:

  • 调整用户浏览的URL,看起来更规范
  • 为了让搜索引擎收录网站内容,让用户体验更好
  • 网站更换新域名后
  • 根据特殊的变量、目录、客户端信息进行跳转

我这里遇到的问题是,以前的很多服务路径配置不规范,有的服务使用项目名作为二级路径,有的服务是随意定义的访问路径,为了统一使用项目名作为访问的二级路径,避免修改代码,所以需要配置路径重定向。

举一个例子,我有一个 a 服务,它原来的访问路径是 api/v1/apps,现在我需要通过路径 a/api/v1/apps 访问,需要将 a/ 重定向到 /

也就是 www.test.com/a/api/v1/apps 重定向到 www.test.com/api/v1/apps

二. 解决方法

需要确保在集群中有一个 ingress controller 正在运行。我们可以按照如下方式配置 ingress

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /$2
  name: rewrite
  namespace: default
spec:
  ingressClassName: nginx
  rules:
  - host: www.test.com
    http:
      paths:
      - path: /a(/|$)(.*)
        pathType: Prefix
        backend:
          service:
            name: http-svc
            port: 
              number: 80

在这个 ingress 的定义中,通过在 annotations 中指定了 nginx.ingress.kubernetes.io/rewrite-target: /$2 来进行重定向,(.*) 捕获的任何字符都将被分配给占位符 $2,然后在 rewrite-target 中用作参数。

应用上面的 ingress 配置,可以实现下面的重定向:

  • www.test.com/a 重定向到 www.test.com/
  • www.test.com/a/ 重定向到 www.test.com/
  • www.test.com/a/api/v1/apps 重定向到 www.test.com/api/v1/apps

rewriting 可以使用下面的 anntations 进行控制:

名称描述
nginx.ingress.kubernetes.io/rewrite-target必须重定向流量的目标URIstring
nginx.ingress.kubernetes.io/ssl-redirect表示位置部分是否可访问SSL(当Ingress包含证书时默认为True)bool
nginx.ingress.kubernetes.io/force-ssl-redirect强制重定向到HTTPS,即使入口没有启用TLSbool
nginx.ingress.kubernetes.io/app-root定义应用根,如果它在'/'上下文中,控制器必须重定向它string
nginx.ingress.kubernetes.io/use-regex表示Ingress上定义的路径是否使用正则表达式bool

App Root

创建一个带有 nginx.ingress.kubernetes.io/app-root 注解的 ingress,如下所示:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  annotations:
    nginx.ingress.kubernetes.io/app-root: /app1
  name: approot
  namespace: default
spec:
  ingressClassName: nginx
  rules:
  - host: approot.bar.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: http-svc
            port: 
              number: 80

检查 rewrite 是否起作用:

$ curl -I -k http://approot.bar.com/
HTTP/1.1 302 Moved Temporarily
Server: nginx/1.11.10
Date: Mon, 13 Mar 2017 14:57:15 GMT
Content-Type: text/html
Content-Length: 162
Location: http://approot.bar.com/app1
Connection: keep-alive

参考文档

https://github.com/kubernetes/ingress-nginx/blob/main/docs/examples/rewrite/README.md

https://www.cnblogs.com/brianzhu/p/8624703.html