ingress-nginx 中 url rewrite 的使用

图片来源：https://unsplash.com/photos/y9JdGEU7b5I

因为 nginx 的优秀性能表现，因此不少企业在 Kubernetes 中选择 Ingress Controller 的时候依然会选择基于 nginx 的 ingress-nginx(https://kubernetes.github.io/ingress-nginx)，前面文章中咱们更多的是介绍更加云原生配置更加灵活的 Traefik，特别是 Traefik 2.0 版本新增中间件概念之后，在配置上就更加方便了，各类需求均可以经过中间件来实现，对于 ingress-nginx 来讲配置就稍微麻烦一点，一些复杂的需求须要经过 Ingress 的 annotation 来实现，好比咱们如今须要实现一个 url rewrite 的功能，简单来讲就是咱们以前的应用在 todo.qikqiak.com 下面，如今咱们须要经过 todo.qikqiak.com/app/ 来进行访问。

本次测试使用的集群为 Kubernetes v1.16.2，ingess-nginx 镜像版本为 0.26.1

最原始的 Ingress 对象以下所示：

apiVersion: extensions/v1beta1

kind: Ingress

metadata:

  name: fe

  namespace: default

  annotations:

    kubernetes.io/ingress.class: "nginx"

spec:

  rules:

  - host: todo.qikqiak.com

    http:

      paths:

      - backend:

          serviceName: fe

          servicePort: 3000

        path: /

就是一个很常规的 Ingress 对象，部署该对象后，将域名解析后就能够正常访问到应用：

按照需求咱们须要对访问的 URL 路径作一个 Rewrite，在 ingress-nginx 官方文档中也给出了说明:

按照要求咱们须要在 path 中匹配前缀 app，而后经过 rewrite-target 指定目标，修改后的 Ingress 对象以下所示：

apiVersion: extensions/v1beta1

kind: Ingress

metadata:

  name: fe

  namespace: default

  annotations:

    kubernetes.io/ingress.class: "nginx"

    nginx.ingress.kubernetes.io/rewrite-target: /$2

spec:

  rules:

  - host: todo.qikqiak.com

    http:

      paths:

      - backend:

          serviceName: fe

          servicePort: 3000

        path: /app(/|$)(.*)

更新后，咱们能够碰见到直接访问域名确定是不行了，由于咱们没有匹配 / 的 path 路径：

可是咱们带上 app 的前缀再去访问:

咱们能够看到已经能够访问到页面内容了，这是由于咱们在 path 中经过正则表达式 /app(/|$)(.*) 将匹配的路径设置成了 rewrite-target 的目标路径了，因此咱们访问 todo.qikqiak.com/app 的时候实际上至关于访问的就是后端服务的 / 路径，可是咱们也能够发现如今页面的样式没有了：

这是由于应用的静态资源路径是在 /stylesheets 路径下面的，如今咱们作了 url rewrite 事后，要正常访问也须要带上前缀才能够：http://todo.qikqiak.com/stylesheets/screen.css，对于图片或者其余静态资源也是如此，固然咱们去更改页面引入静态资源的方式为相对路径也是能够的，可是毕竟要修改代码，这个时候咱们能够借助 ingress-nginx 中的 configuration-snippet 来对静态资源作一次跳转，以下所示：

apiVersion: extensions/v1beta1

kind: Ingress

metadata:

  name: fe

  namespace: default

  annotations:

    kubernetes.io/ingress.class: "nginx"

    nginx.ingress.kubernetes.io/rewrite-target: /$2

    nginx.ingress.kubernetes.io/configuration-snippet: |

      rewrite ^/stylesheets/(.*)$ /app/stylesheets/$1 redirect;  # 添加 /app 前缀

      rewrite ^/images/(.*)$ /app/images/$1 redirect;  # 添加 /app 前缀

spec:

  rules:

  - host: todo.qikqiak.com

    http:

      paths:

      - backend:

          serviceName: fe

          servicePort: 3000

        path: /app(/|$)(.*)

更新 Ingress 对象后，这个时候咱们刷新页面能够看到已经正常了：

要解决咱们访问主域名出现 404 的问题，咱们能够给应用设置一个 app-root 的注解，这样当咱们访问主域名的时候会自动跳转到咱们指定的 app-root 目录下面，以下所示：

apiVersion: extensions/v1beta1

kind: Ingress

metadata:

  name: fe

  namespace: default

  annotations:

    kubernetes.io/ingress.class: "nginx"

    nginx.ingress.kubernetes.io/app-root: /app/

    nginx.ingress.kubernetes.io/rewrite-target: /$2

    nginx.ingress.kubernetes.io/configuration-snippet: |

      rewrite ^/stylesheets/(.*)$ /app/stylesheets/$1 redirect;  # 添加 /app 前缀

      rewrite ^/images/(.*)$ /app/images/$1 redirect;  # 添加 /app 前缀

spec:

  rules:

  - host: todo.qikqiak.com

    http:

      paths:

      - backend:

          serviceName: fe

          servicePort: 3000

        path: /app(/|$)(.*)

这个时候咱们更新应用后访问主域名 http://todo.qikqiak.com 就会自动跳转到 http://todo.qikqiak.com/app/ 路径下面去了。可是还有一个问题是咱们的 path 路径其实也匹配了 /app 这样的路径，可能咱们更加但愿咱们的应用在最后添加一个 / 这样的 slash，一样咱们能够经过 configuration-snippet 配置来完成，以下 Ingress 对象：

apiVersion: extensions/v1beta1

kind: Ingress

metadata:

  name: fe

  namespace: default

  annotations:

    kubernetes.io/ingress.class: "nginx"

    nginx.ingress.kubernetes.io/app-root: /app/

    nginx.ingress.kubernetes.io/rewrite-target: /$2

    nginx.ingress.kubernetes.io/configuration-snippet: |

      rewrite ^(/app)$ $1/ redirect;

      rewrite ^/stylesheets/(.*)$ /app/stylesheets/$1 redirect;

      rewrite ^/images/(.*)$ /app/images/$1 redirect;

spec:

  rules:

  - host: todo.qikqiak.com

    http:

      paths:

      - backend:

          serviceName: fe

          servicePort: 3000

        path: /app(/|$)(.*)

更新后咱们的应用就都会以 / 这样的 slash 结尾了。这样就完成了咱们的需求，若是你本来对 nginx 的配置就很是熟悉的话应该能够很快就能理解这种配置方式了，固然若是你仍是喜欢更加简单明了的方式的话能够推荐使用 Traefik 。