28.3. 使用 Ingress Controller 配置集群入口流量

流程

1. 运行 oc new-project 命令为您的服务创建一个新项目：

   $ oc new-project myproject

2. 使用 oc new-app 命令来创建服务：

   $ oc new-app nodejs:12~https://github.com/sclorg/nodejs-ex.git

3. 要验证该服务是否已创建，请运行以下命令：

   $ oc get svc -n myproject

   输出示例

   NAME        TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)    AGE
   nodejs-ex   ClusterIP   172.30.197.157   <none>        8080/TCP   70s

   默认情况下，新服务没有外部 IP 地址。

1. 登录 OpenShift Container Platform。

2. 登录您想公开的服务所在的项目：

   $ oc project myproject

3. 运行 oc expose service 命令以公开路由：

   $ oc expose service nodejs-ex

   输出示例

   route.route.openshift.io/nodejs-ex exposed

4. 要验证该服务是否已公开，您可以使用 cURL 等工具来确保该服务可从集群外部访问。

   1. 使用 oc get route 命令查找路由的主机名：

      $ oc get route

      输出示例

      NAME        HOST/PORT                        PATH   SERVICES    PORT       TERMINATION   WILDCARD
      nodejs-ex   nodejs-ex-myproject.example.com         nodejs-ex   8080-tcp                 None

   2. 使用 cURL 检查主机是否响应 GET 请求：

      $ curl --head nodejs-ex-myproject.example.com

      输出示例

      HTTP/1.1 200 OK
      ...

流程

1. 编辑 router-internal.yaml 文件：

   # cat router-internal.yaml
   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     name: sharded
     namespace: openshift-ingress-operator
   spec:
     domain: <apps-sharded.basedomain.example.net> 1
     nodePlacement:
       nodeSelector:
         matchLabels:
           node-role.kubernetes.io/worker: ""
     routeSelector:
       matchLabels:
         type: sharded

   1

   指定 Ingress Controller 使用的域。此域必须与默认 Ingress Controller 域不同。

2. 应用 Ingress Controller router-internal.yaml 文件：

   # oc apply -f router-internal.yaml

   Ingress Controller 选择具有 type: sharded 标签的任意命名空间中的路由。

3. 使用 router-internal.yaml 中配置的域创建新路由：

   $ oc expose svc <service-name> --hostname <route-name>.apps-sharded.basedomain.example.net

流程

1. 编辑 router-internal.yaml 文件：

   # cat router-internal.yaml

   输出示例

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     name: sharded
     namespace: openshift-ingress-operator
   spec:
     domain: <apps-sharded.basedomain.example.net> 1
     nodePlacement:
       nodeSelector:
         matchLabels:
           node-role.kubernetes.io/worker: ""
     namespaceSelector:
       matchLabels:
         type: sharded

   1

   指定 Ingress Controller 使用的域。此域必须与默认 Ingress Controller 域不同。

2. 应用 Ingress Controller router-internal.yaml 文件：

   # oc apply -f router-internal.yaml

   Ingress Controller 选择由命名空间选择器选择的具有 type: sharded 标签的任意命名空间中的路由。

3. 使用 router-internal.yaml 中配置的域创建新路由：

   $ oc expose svc <service-name> --hostname <route-name>.apps-sharded.basedomain.example.net

流程

1. 运行以下命令，创建一个名为 hello-openshift 的项目：

   $ oc new-project hello-openshift

2. 运行以下命令，在项目中创建 pod：

   $ oc create -f https://raw.githubusercontent.com/openshift/origin/master/examples/hello-openshift/hello-pod.json

3. 运行以下命令，创建名为 hello-openshift 的服务：

   $ oc expose pod/hello-openshift

4. 创建名为 hello-openshift-route.yaml 的路由定义：

   为分片创建的路由的 YAML 定义：

   apiVersion: route.openshift.io/v1
   kind: Route
   metadata:
     labels:
       type: sharded 1
     name: hello-openshift-edge
     namespace: hello-openshift
   spec:
     subdomain: hello-openshift 2
     tls:
       termination: edge
     to:
       kind: Service
       name: hello-openshift

   1

   标签键及其对应标签值必须与 Ingress Controller 中指定的标签值匹配。在本例中，Ingress Controller 具有标签键和值 type: sharded。

   2

   路由将使用 subdomain 字段的值公开。指定 subdomain 字段时，您必须保留主机名未设置。如果您同时指定了 host 和 subdomain 字段，则路由将使用 host 字段的值，并忽略 subdomain 字段。

5. 通过运行以下命令，使用 hello-openshift-route.yaml 创建到 hello-openshift 应用程序的路由：

   $ oc -n hello-openshift create -f hello-openshift-route.yaml