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 のカスタムの name を指定します。

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

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

   1

   Copy to Clipboard Toggle word wrap
   注記

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

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

   $ 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 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>]}]}}}'

    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 タイプの Service のノードポートです。oc get svc -n openshift-ingress コマンドの出力例の 80:32432/TCP HTTP ルートから、32432 がノードポートであることがわかります。

   出力例

   Hello OpenShift!

   Copy to Clipboard Toggle word wrap