部署多套 Nginx Ingress Controller

本文介绍如何在容器服务集群中同时部署多套独立的 Nginx Ingress Controller，对外提供不同的服务访问。

前提条件

• 已创建集群。具体操作，请参见 创建集群。
• 已连接集群。具体操作，请参见 连接集群。

背景信息

容器服务支持在集群中同时部署多套独立的 Nginx Ingress Controller 服务，各服务之间互不影响，允许您基于实际业务需求或场景，对外提供不同的服务访问。例如：

• 在多业务共享集群的场景下，您可以为不同业务配置各自独立的 Nginx Ingress Controller 服务，保证不同的业务匹配不同的服务规则。
• 在公网和私网业务分离的场景下，同一个集群内，部署两套独立的 Nginx Ingress Controller 服务，两者前端绑定不同网络类型的负载均衡（CLB）实例，满足该集群内部分服务提供公网访问，另一部分服务提供私网访问的需求。

操作步骤

步骤一：部署 Nginx Ingress Controller

容器服务通过应用模板提供名为 ingress-nginx 的 Nginx Ingress Controller。

1. 登录 容器服务控制台。
2. 在左侧导航栏，选择 应用中心 > 应用模板。
3. 在 应用模板 页面，找到 ingress-nginx 应用模板，鼠标悬停在该应用模板区域，然后单击 部署。
4. 在 部署应用 页面，配置 Nginx Ingress Controller 服务参数。
   

   参数	说明
   基本信息
   名称	设置应用名称，同一个命名空间里名称必须唯一。
   项目	【邀测·申请试用】选择需要部署应用的项目。默认选择 default（默认项目）。更多项目相关操作和说明，请参见 项目管理。
   集群	选择需要部署应用的目标集群。
   命名空间	选择目标集群下的命名空间。
   编排模板
   Chart 来源	选择应用的 Chart 来源。默认来源为 应用模板，不可配置。
   Chart	选择应用的 Chart 版本。
   配置方式	选择应用的配置方法。每个应用模板的values.yaml文件配置方法不同，详细说明，请参见values.yaml文件中的注释说明。 单击 图标，编辑values.yaml文件。编辑完成后单击 确定。 说明 values.yaml文件中的常用参数说明，请参见 Nginx Ingress Controller 参数说明。

5. 单击 确定，部署完成应用。
   应用部署完成后会显示在 Helm 应用 页面。选择目标项目、集群、命名空间，找到已部署的 nginx-ingress 应用，单击名称，进入详情页面查看该应用的基本信息、关联创建的工作负载、服务、其他资源等。

   注意

   已部署的 nginx-ingress 应用，若删除其关联的工作负载、服务等资源，但未删除 Webhook 时，会对该 nginx-ingress 应用所在集群中创建路由规则（Ingress）的操作产生影响。更多说明，请参见 FAQ。

   

步骤二：部署应用和服务

在集群中部署独立的 Nginx Ingress Controller 服务后，可以使用 Nginx Ingress Controller 暴露内部的服务。本小节以一个 nginx 应用为例，为您介绍如何使用独立的 Nginx Ingress Controller 暴露后端服务并验证结果。

创建应用和服务的 YAML 文件。示例文件service-demo.yaml代码如下：

1. 在集群中部署 nginx 应用和服务。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx # 应用名称
  namespace: doc-ns
spec: 
  replicas: 1 # 应用副本数
  selector: 
    matchLabels: 
      app: nginx
  template: 
    metadata: 
      labels: 
        app: nginx
    spec:
      containers:
      - name: nginx # 容器名称
        image: nginx:latest # 容器镜像地址和版本
        ports:
        - containerPort: 80 # 容器开放的端口号
---
apiVersion: v1
kind: Service
metadata:
  name: service-demo # 服务的名称
  namespace: doc-ns
spec:
  selector:
    app: nginx # 通过标签选择器将服务与后端的容器组（Pod）绑定
  ports:
  - name: rule 
    protocol: TCP
    port: 80
    targetPort: 80
  type: NodePort

2. 执行以下命令，创建应用和服务。

kubectl apply -f service-demo.yaml

步骤三：配置 Nginx Ingress

1. 配置 ingress 对外暴露服务。其中，在spec.ingressClassName字段中使用名称指定自定义的 Nginx Ingress Controller。示例文件ingress-demo.yaml代码如下：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: ingress-demo # ingress 的名称
  namespace: doc-ns # ingress 所在的命名空间
spec:
  ingressClassName: user-ingress-nginx # 自定义的 Nginx Ingress Controller 名称
  rules:
  - host: example.com # 外部访问的域名
    http:
      paths:
      - pathType: Prefix
        path: /
        backend:
          service:
            name: service-demo # ingress 后端对接的服务名称
            port:
              number: 80 # ingress 对接服务的端口号

2. 执行以下命令，创建应用和服务。

kubectl apply -f ingress-demo.yaml

结果验证

1. 完成部署后，执行以下命令，查看系统默认 Nginx Ingress Controller 的 IP 地址与自定义 Nginx Ingress Controller 的 IP 地址。
   • 查看系统默认 Nginx Ingress Controller 服务的 IP 地址。

   kubectl -n kube-system get svc
   

   预期输出为：

   NAME                       TYPE          CLUSTER-IP       EXTERNAL-IP       PORT(S)                      AGE
   
   ingress-nginx-controller   LoadBalancer  10.xxx.xxx.221   180.xxx.xxx.114   80:30234/TCP,443:30644/TCP   1d
   

   • 查看自定义 Nginx Ingress Controller 服务的 IP 地址。您可以通过-n doc-ns指定自定义 Nginx Ingress Controller 所在的命名空间。

   kubectl -n doc-ns get svc
   

   预期输出为：

   NAME                                    TYPE           CLUSTER-IP       EXTERNAL-IP      PORT(S)                      AGE
   user-ingress-ingress-nginx-controller   LoadBalancer   10.xxx.xxx.52    180.xxx.xxx.55   80:32697/TCP,443:31180/TCP   5m51s
   

2. 执行以下命令，查看 ingress 配置。可以发现 ingress 对应的 IP 地址与自定义 Nginx Ingress Controller 服务的 IP 地址一致。

kubectl -n doc-ns get ingress

预期输出为：

NAME           CLASS                HOSTS         ADDRESS         PORTS    AGE
ingress-demo   user-ingress-nginx   example.com   180.xxx.xxx.55   80      56s

5. 分别通过集群默认 Nginx Ingress Controller 服务和自定义 Nginx Ingress Controller 服务来访问该应用。
   • 通过集群默认 Nginx Ingress Controller 服务访问应用。预期输出为404，即无法访问到后端服务。

   curl -H "Host: example.com" http://180.xxx.xxx.114
   

   • 通过自定义 Nginx Ingress Controller 服务访问应用。

   curl -H "Host: example.com" http://180.xxx.xxx.55
   

   预期输出为：

   <!DOCTYPE html>
   <html>
   <head>
   <title>Welcome to nginx!</title>
   <style>
   html { color-scheme: light dark; }
   body { width: 35em; margin: 0 auto;
   font-family: Tahoma, Verdana, Arial, sans-serif; }
   </style>
   </head>
   <body>
   <h1>Welcome to nginx!</h1>
   <p>If you see this page, the nginx web server is successfully installed and
   working. Further configuration is required.</p>
   
   <p>For online documentation and support please refer to
   <a href="http://nginx.org/">nginx.org</a>.<br/>
   Commercial support is available at
   <a href="http://nginx.com/">nginx.com</a>.</p>
   
   <p><em>Thank you for using nginx.</em></p>
   </body>
   </html>
   

从上面的测试结果可以发现，不同 Nginx Ingress Controller 暴露的服务彼此完全独立，各服务之间互不影响。您可以为不同业务配置各自独立的 Nginx Ingress Controller 服务，实现多业务路由规则分离、公网和私网业务分离等场景需求。

监控运维

当您在集群中部署 Nginx Ingress Controller 后，可以使用集群的可观测能力，对 Nginx Ingress Controller 实例进行监控和运维。详情请参见 自定义 Nginx Ingress Controller 观测最佳实践。

参考信息

Nginx Ingress Controller 参数说明

userConfig字段的主要参数说明，如下表所示。

Controller字段的主要参数说明，如下表所示。

部署参数（Deployment/Daemonset）的说明，如下表所示。

PublicConfig字段的主要参数说明，如下表所示。