Red Hat OpenShift上的NGINX Ingress Operator入门

NGINX | 2020年4月30日

通过与Red Hat的合作，我们继续专注于为企业用户提供支持，满足其在OpenShift中实现兼容DevOps的服务交付时，对高性能、可扩展长期解决方案的需求。OpenShift版NGINX Ingress Operator是一种经过支持和认证的部署机制，可在OpenShift环境中将Kubernetes版NGINX Plus Ingress Controller与默认路由器一同部署，并支持点击式安装和自动升级。可以利用Operator Lifecycle Manager（OLM）安装、升级和配置NGINX Ingress Operator。

想知道为什么除了默认路由器之外，还要使用NGINX Plus Ingress Controller？请阅读我们的《Red Hat + NGINX的价值》博客，了解双方的合作如何实现安全、可扩展且有支持保障的应用交付。

本分步指南提供开始使用 NGINX Ingress Operator 所需的全部信息。开始前，请确保您拥有运行 OpenShift 4.3 或更高版本的 OpenShift 集群环境的管理员访问权限。

安装Operator

以下视频演示了如何安装NGINX Ingress Operator，随后还提供了包含屏幕截图的文字摘要。

我们从OpenShift控制台安装NGINX Ingress Operator。

以管理员身份登录OpenShift控制台。
在左侧导航栏中，点击“Operators”，然后点击“OperatorHub”。在搜索框中输入nginx，然后点击显示的Nginx Ingress Operator卡片。
查看产品信息后，单击“Install”按钮。
在打开的“创建操作器订阅”页面上，指定用于安装操作器的集群命名空间（本例中为nginx-ingress）。然后选择“自动”单选按钮（位于“审批策略”下），这样正在运行的操作器实例便可自动更新，无需管理员手动批准。点击“订阅”按钮。
安装完成后，在终端中运行以下命令，验证Operator是否正在运行：

# oc get pods –n nginx-ingressNAME                                     READY   STATUS    RESTARTS   AGE
nginx-ingress-operator-dd546d869-xxxxx   1/1     Running   0          7m29s

在左侧导航栏中点击“已安装的 Operator”。在打开的页面中，点击“提供的 API”列中的 NginxIngressController 链接。NginxIngressController 是一种自定义资源，Operator 使用该资源在 OpenShift 集群上部署 NGINX Plus Ingress Controller。
在打开的页面中，将类似以下示例的清单粘贴到文本字段中，然后单击“创建”按钮以部署NGINX Plus Ingress Controller for Kubernetes。请注意，我们在Secret的defaultSecret和wildcardTLS字段中嵌入了TLS证书和密钥。这样无需在Ingress策略中包含Secret，即可实现TLS终止和直通。配置NGINX Plus Ingress Controller for Kubernetes时，可以设置多种选项，具体请参阅我们的GitHub存储库。

apiVersion: k8s.nginx.org/v1alpha1kind: NginxIngressController
metadata:
  name: my-nginx-ingress-controller
  namespace: nginx-ingress
spec:
  enableCRDs: true
  image:
    pullPolicy: Always
    repository: registry.hub.docker.com/nginx/nginx-ingress
    tag: edge
  nginxPlus: false
  serviceType: LoadBalancer
  type: deployment
  replicas: 2
  defaultSecret: nginx-ingress/default-server-secret
  wildcardTLS: default/app-secret
  configMapData:
    error-log-level: debug
  enableTLSPassthrough: true
  globalConfiguration: nginx-ingress/nginx-configuration

要验证部署，请在终端中运行以下命令。如输出所示，上一步使用的清单部署了两个NGINX Plus Ingress Controller副本，并通过LoadBalancer服务将其公开。（为便于阅读，get命令的输出分为多行显示。）

# oc get pods -n nginx-ingressNAME                                          READY  STATUS   RESTARTS  AGE
my-nginx-ingress-controller-579f455d7d-xxxxx  1/1    Running  0         5m53s
my-nginx-ingress-controller-579f455d7d-xxxxx  1/1    Running  0         5m53s
nginx-ingress-operator-dd546d869-xxxxx        1/1    Running  0         56m

# oc get svc –n nginx-ingress
my-nginx-ingress-controller      LoadBalancer   172.xx.48.254    <pending>  ...   
nginx-ingress-operator-metrics   ClusterIP      172.xx.209.190   <none>     ...   

    ... 80:32028/TCP,443:31973/TCP   10m
    ... 80:32028/TCP,443:31973/TCP   10m

运行以下命令，验证NGINX Plus Ingress Controller是否响应请求。请将public_IP_address替换为用于公开NGINX Plus Ingress Controller的LoadBalancer服务的外部IP地址。请注意，此时该命令会返回404 Not Found。这是因为尚未配置和部署Ingress资源，无法将流量路由到后端Pod。有关详细信息，请参阅文档。

# curl public_IP_address <html> 
<head><title>404 Not Found</title></head> 
<body bgcolor="white"> 
<center><h1>404 Not Found</h1></center> 
<hr><center>nginx/1.13.4</center> 
</body> 
</html>