2.4. Ingress Controller エンドポイント公開戦略の設定

手順

1. Ingress Controller のカスタムリソース (CR) ファイルを作成します。

   IngressController オブジェクトの情報を定義する CR ファイルの例

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

   ここでは、以下のようになります。

   metadata.name

   IngressController CR のカスタム 名 を指定します。

   仕様ドメイン

   Ingress Controller がサービスを提供する DNS 名を指定します。たとえば、デフォルトのイングレスコントローラーのドメインは apps.ipi-cluster.example.com なので、<custom_ic_domain_name> には nodeportsvc.ipi-cluster.example.com を指定します。

   nodeSelector.matchLabels.<key>

   カスタム Ingress コントローラーを含むノードのラベルを指定します。

   namespaceSelector.matchLabels.<key>

   一連の名前空間のラベルを指定します。<key>:<value> は、キーと値のペアのマップに置き換えます。<key> は新しいラベルの一意の名前、<value> はその値です。たとえば、ingresscontroller: custom-ic です。

2. oc label node コマンドを使用してノードにラベルを追加します。

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

   • <key>=<value>: ここで、<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. 新しい namespace にラベルを付けるために、次のコマンドを入力します。

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

   • <key>=<value>:: ここで、<key>=<value> は Ingress Controller CR の namespaceSelector セクションの値と一致する必要があります。

7. クラスター内に新しいアプリケーションを作成します。

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

   • <image_name>: <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>

   注記

   --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 解決に外部 DNS サーバーの IP アドレスを使用していることを確認するために、次のコマンドを入力してクラスターの接続を確認します。

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

   1

   • <custom_ic_domain_name>:<port>: ここで、<port> は NodePort タイプの サービス からのノードポートです。oc get svc -n openshift-ingress コマンドの出力例の 80:32432/TCP HTTP ルートから、32432 がノードポートであることがわかります。

     出力例

     Hello OpenShift!