26.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
   # ...

   Copy to Clipboard Toggle word wrap

   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

   namespace のセットのラベルを指定します。< key>:<value> をキーと値のペアのマップに置き換えます。ここで、< key > は新規ラベルの一意の名前で、< value > はその値になります。例： ingresscontroller: custom-ic

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

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

   1

   Copy to Clipboard Toggle word wrap

   1

   ここで 、<value > は IngressController CR の nodePlacement セクションで指定されたキーと値のペアと一致する必要があります。

3. IngressController オブジェクトを作成します。

   $ oc create -f <ingress_controller_cr>.yaml

   Copy to Clipboard Toggle word wrap

4. IngressController CR 用に作成されたサービスのポートを見つけます。

   $ oc get svc -n openshift-ingress

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

5. 新しいプロジェクトを作成するために、次のコマンドを入力します。

   $ oc new-project <project_name>

   Copy to Clipboard Toggle word wrap

6. 新しい namespace にラベルを付けるために、次のコマンドを入力します。

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

   1

   Copy to Clipboard Toggle word wrap

   1

   ここで 、<key>=<value > は Ingress コントローラー CR の namespaceSelector セクションの値と一致する必要があります。

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

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

   1

   Copy to Clipboard Toggle word wrap

   1

   < image_name> の例は quay.io/openshifttest/hello-openshift:multiarch です。

8. Pod がサービスを使用してアプリケーションをクラスター外の公開できるように、サービスの Route オブジェクトを作成します。

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

   1

   Copy to Clipboard Toggle word wrap
   注記

   カスタム Ingress コントローラーのドメイン名を the- hostname 引数に指定する必要があります。これを行わない場合、Ingress Operator がデフォルトの Ingress Controller を使用してクラスターのすべてのルートを提供します。

9. ルートに Admitted ステータスがあり、カスタム Ingress コントローラーのメタデータが含まれていることを確認します。

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

   Copy to Clipboard Toggle word wrap

   出力例

   # ...
   {
     "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"
       }
     ],
   }

   Copy to Clipboard Toggle word wrap

10. デフォルトの IngressController CR を更新して、デフォルトの Ingress コントローラーが NodePortタイプの サービス を管理しないようにします。他のすべてのクラスタートラフィックは、引き続きデフォルトの Ingress Controller によって監視します。

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

    Copy to Clipboard Toggle word wrap

検証

1. 次のコマンドを入力して、DNS エントリーがクラスターの内外にルーティングできることを確認します。このコマンドは、この手順の前の oc label node コマンド実行からラベルを受け取ったノードの IP アドレスを出力します。

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

   Copy to Clipboard Toggle word wrap

2. クラスターが DNS 解決に外部 DNS サーバーの IP アドレスを使用していることを確認するために、次のコマンドを入力してクラスターの接続を確認します。

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

   1

   Copy to Clipboard Toggle word wrap

   1 1

   ここで 、<port > は NodePortタイプの サービス からのノードポートです。oc get svc -n openshift-ingress コマンドからの出力例に基づいて、80:32432/TCP HTTP ルート は、32432 がノードポートであることを意味します。

   出力例

   Hello OpenShift!

   Copy to Clipboard Toggle word wrap