Nginx Ingress高级用法_容器服务Kubernetes版-阿里云帮助中心

在Kubernetes集群中，Nginx Ingress对集群服务（Service）中外部可访问的API对象进行管理，提供七层负载均衡能力。您可以给Nginx Ingress配置提供外部可访问的URL、Rewrite配置、HTTPS服务、以及灰度发布功能等。本文介绍如何配置安全的路由服务、HTTPS双向认证、域名支持正则化及泛化，申请免费的HTTPS证书等功能。

前提条件

已创建Kubernetes集群。具体操作，请参见创建Kubernetes托管版集群。
集群中的Nginx Ingress Controller运行正常。
已通过kubectl连接Kubernetes集群。具体操作，请参见步骤二：选择集群凭证类型。
已创建示例Deployment和Service。具体操作，请参见 Kubectl操作指导。

配置说明

针对Nginx Ingress Controller，阿里云容器服务团队采用与社区完全兼容的配置方式。关于所有的配置说明，请参见 NGINX Configuration 。

目前其主要支持三种配置方式：

基于Annotation的方式：在每个Nginx Ingress YAML的Annotation里配置，只对本Nginx Ingress生效。更多信息，请参见 Annotations 。
基于ConfigMap的方式：通过kube-system/nginx-configuration configmap的配置，是一个全局的配置，对所有的Nginx Ingress生效。更多信息，请参见 ConfigMaps 。
自定义NGINX Template模板的方式：对Nginx Ingress Controller内部的NGINX Template有特殊配置要求，且当前通过Annotation和ConfigMap方式都无法满足诉求的情况下采用该方式。更多信息，请参见 Custom NGINX template 。

配置URL重定向的路由服务

当您在使用Nginx Ingress Controller的时候，Nginx会将路径完整转发到后端（如，从Ingress访问的 /service1/api 路径会直接转发到后端Pod的 /service1/api/ 路径）。如果您后端的服务路径为 /api ，则会出现路径错误，导致404的情况。该情况下，您可以通过配置 rewrite-target 的方式，来将路径重写至需要的目录。

部署以下模板，创建Nginx Ingress。

1.19版本之前集群 1.19及之后版本集群

cat <<-EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: foo.bar.com
  namespace: default
  annotations:
    #URL重定向。
    nginx.ingress.kubernetes.io/rewrite-target: /$2
spec:
  rules:
  - host: foo.bar.com
    http:
      paths:
    # 在Ingress Controller的版本≥0.22.0之后，path中需要使用正则表达式定义路径，并在rewrite-target中结合捕获组一起使用。
      - path: /svc(/|$)(.*)
        backend:
          serviceName: web1-service
          servicePort: 80
    cat <<-EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: foo.bar.com
  namespace: default
  annotations:
    #URL重定向。
    nginx.ingress.kubernetes.io/rewrite-target: /$2
spec:
  rules:
  - host: foo.bar.com
    http:
      paths:
    # 在Ingress Controller的版本≥0.22.0之后，path中需要使用正则表达式定义路径，并在rewrite-target中结合捕获组一起使用。
      - path: /svc(/|$)(.*)
        backend:
          service: 
            name: web1-service
            port: 
              number: 80
        pathType: ImplementationSpecific

执行以下命令，访问Nginx服务。
替换 IP_ADDRESS 为Ingress对应的IP，可通过 kubectl get ing 获取。
```
curl -k -H "Host: foo.bar.com"  http://<IP_ADDRESS>/svc/foo
```
预期输出：
```
web1: /foo
```

Rewrite配置

使用 nginx.ingress.kubernetes.io/rewrite-target 注解支持基本的Rewrite配置，对于一些复杂高级的Rewrite需求，可以通过如下注解来实现：

nginx.ingress.kubernetes.io/server-snippet ：扩展配置到Server章节。
nginx.ingress.kubernetes.io/configuration-snippet ：扩展配置到Location章节。

配置示例：

annotations:
     nginx.ingress.kubernetes.io/server-snippet: |
         rewrite ^/v4/(.*)/card/query http://foo.bar.com/v5/#!/card/query permanent;
     nginx.ingress.kubernetes.io/configuration-snippet: |
         rewrite ^/v6/(.*)/card/query http://foo.bar.com/v7/#!/card/query permanent;

示例配置生成的 nginx.conf 如下所示。

## start server foo.bar.com
    server {
        server_name foo.bar.com ;
        listen 80;
        listen [::]:80;
        set $proxy_upstream_name "-";
    ### server-snippet配置。
        rewrite ^/v4/(.*)/card/query http://foo.bar.com/v5/#!/card/query permanent;
    ### configuration-snippet配置。
      rewrite ^/v6/(.*)/card/query http://foo.bar.com/v7/#!/card/query permanent;
    ## end server foo.bar.com

同时， snippet 也支持一些全局配置。详细信息，请参见 server-snippet 。

关于 rewrite 指令的具体用法，请参照 Nginx官方文档对该指令的描述。

为路由规则配置HTTPS证书

您可以通过Ingress提供的原生语义来为网站配置 HTTPS 证书。

准备您的服务证书。

前提条件

配置说明

配置URL重定向的路由服务

Rewrite配置

为路由规则配置HTTPS证书

配置HTTPS双向认证

配置HTTPS服务转发到后端容器为HTTPS协议

配置域名支持正则化

配置域名支持泛化

通过注解实现灰度发布

使用cert-manager申请免费的HTTPS证书