k8s 中的 nginx-ingress 如何配置路径重定向
2021-11-17 本文已影响0人
惜鸟
一. 需求描述
路径重定向的一般应用场景:
- 调整用户浏览的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 |
必须重定向流量的目标URI | string |
nginx.ingress.kubernetes.io/ssl-redirect |
表示位置部分是否可访问SSL(当Ingress包含证书时默认为True) | bool |
nginx.ingress.kubernetes.io/force-ssl-redirect |
强制重定向到HTTPS,即使入口没有启用TLS | bool |
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