29.4. 配置 Ingress Controller 端点发布策略

流程

1. 为 Ingress Controller 创建自定义资源 (CR) 文件：

   定义 IngressController 对象的信息的 CR 文件示例

   apiVersion: v1
   items:
   - apiVersion: operator.openshift.io/v1
     kind: IngressController
     metadata:
       name: <custom_ic_name> 1
       namespace: openshift-ingress-operator
     spec:
       replicas: 1
       domain: <custom_ic_domain_name> 2
       nodePlacement:
         nodeSelector:
           matchLabels:
             <key>: <value> 3
       namespaceSelector:
        matchLabels:
          <key>: <value> 4
       endpointPublishingStrategy:
         type: NodePortService
   # ...

   1

   为 IngressController CR 指定一个自定义名称。

   2

   Ingress Controller 服务的 DNS 名称。例如，默认的 ingresscontroller 域是 apps.ipi-cluster.example.com，因此您要将 <custom_ic_domain_name> 指定为 nodeportsvc.ipi-cluster.example.com。

   3

   指定包含自定义 Ingress Controller 的节点的标签。

   4

   指定一组命名空间的标签。使用键值对替换 <key>:<value>，其中 <key> 是新标签的唯一名称，<value> 是它的值。例如：ingresscontroller: custom-ic。

2. 使用 oc label node 命令给节点添加标签：

   $ oc label node <node_name> <key>=<value> 1

   1

   其中 <value> 必须与 IngressController CR 的 nodePlacement 部分中指定的键值对匹配。

3. 创建 IngressController 对象：

   $ oc create -f <ingress_controller_cr>.yaml

4. 查找为 IngressController CR 创建的服务的端口：

   $ oc get svc -n openshift-ingress

   显示 router-nodeport-custom-ic3 服务的端口 80:32432/TCP 的示例

   NAME                        TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)                                     AGE
   router-internal-default      ClusterIP   172.30.195.74    <none>        80/TCP,443/TCP,1936/TCP                     223d
   router-nodeport-custom-ic3   NodePort    172.30.109.219   <none>        80:32432/TCP,443:31366/TCP,1936:30499/TCP   155m

5. 要创建新项目，请输入以下命令：

   $ oc new-project <project_name>

6. 要标记新命名空间，请输入以下命令：

   $ oc label namespace <project_name> <key>=<value> 1

   1

   其中 <key>=<value> 需要与 Ingress Controller CR 的 namespaceSelector 部分中的值匹配。

7. 在集群中创建新应用程序：

   $ oc new-app --image=<image_name> 1

   1

   一个 <image_name> 的示例是 quay.io/openshifttest/hello-openshift:multiarch。

8. 为服务创建 Route 对象，以便 pod 可以使用该服务向集群外部公开应用程序。

   $ oc expose svc/<service_name> --hostname=<svc_name>-<project_name>.<custom_ic_domain_name> 1

   注意

   您必须在 --hostname 参数中指定自定义 Ingress Controller 的域名。如果没有这样做，Ingress Operator 会使用默认的 Ingress Controller 来提供集群的所有路由。

9. 检查路由是否具有 Admitted 状态，并且包含自定义 Ingress Controller 的元数据：

   $ oc get route/hello-openshift -o json | jq '.status.ingress'

   输出示例

   # ...
   {
     "conditions": [
       {
         "lastTransitionTime": "2024-05-17T18:25:41Z",
         "status": "True",
         "type": "Admitted"
       }
     ],
     [
       {
         "host": "hello-openshift.nodeportsvc.ipi-cluster.example.com",
         "routerCanonicalHostname": "router-nodeportsvc.nodeportsvc.ipi-cluster.example.com",
         "routerName": "nodeportsvc", "wildcardPolicy": "None"
       }
     ],
   }

10. 更新默认的 IngressController CR，以防止默认 Ingress Controller 管理 NodePort 类型 Service。默认 Ingress Controller 将继续监控所有其他集群流量。

    $ oc patch --type=merge -n openshift-ingress-operator ingresscontroller/default --patch '{"spec":{"namespaceSelector":{"matchExpressions":[{"key":"<key>","operator":"NotIn","values":["<value>]}]}}}'

验证

1. 输入以下命令验证 DNS 条目是否可以在集群内部和外部路由。命令输出之前从运行 oc label node 命令接收标签的节点的 IP 地址。

   $ dig +short <svc_name>-<project_name>.<custom_ic_domain_name>

2. 要验证集群是否使用来自外部 DNS 服务器的 IP 地址进行 DNS 解析，请输入以下命令检查集群的连接：

   $ curl <svc_name>-<project_name>.<custom_ic_domain_name>:<port> 1

   1 1

   其中 <port> 是来自 NodePort 类型的 Service 的节点端口。根据 oc get svc -n openshift-ingress 命令的输出示例，80:32432/TCP HTTP 路由意味着 32432 是节点端口。

   输出示例

   Hello OpenShift!