22.6. AWS での Ingress クラスタートラフィックの設定

手順

1. oc annotate コマンドを使用して、ルートにタイムアウトを追加します。

   $ oc annotate route <route_name> \
       --overwrite haproxy.router.openshift.io/timeout=<timeout><time_unit> 1

   1

   サポートされる時間単位は、マイクロ秒 (us)、ミリ秒 (ms)、秒 (s)、分 (m)、時間 (h)、または日 (d) です。

   以下の例では、2 秒のタイムアウトを myroute という名前のルートに設定します。

   $ oc annotate route myroute --overwrite haproxy.router.openshift.io/timeout=2s

手順

1. 次のコマンドを実行して、デフォルト ingresscontroller の AWS 接続アイドルタイムアウトを 5 分に設定します。

   $ oc -n openshift-ingress-operator patch ingresscontroller/default \
       --type=merge --patch='{"spec":{"endpointPublishingStrategy": \
       {"type":"LoadBalancerService", "loadBalancer": \
       {"scope":"External", "providerParameters":{"type":"AWS", "aws": \
       {"type":"Classic", "classicLoadBalancer": \
       {"connectionIdleTimeout":"5m"}}}}}}}'

2. オプション: 次のコマンドを実行して、タイムアウトのデフォルト値を復元します。

   $ oc -n openshift-ingress-operator patch ingresscontroller/default \
       --type=merge --patch='{"spec":{"endpointPublishingStrategy": \
       {"loadBalancer":{"providerParameters":{"aws":{"classicLoadBalancer": \
       {"connectionIdleTimeout":null}}}}}}}'

手順

1. NLB を使用して切り替える既存の Ingress Controller を変更します。この例では、デフォルトの Ingress Controller に External スコープがあり、他のカスタマイズがないことを前提としています。

   ingresscontroller.yaml ファイルの例

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     creationTimestamp: null
     name: default
     namespace: openshift-ingress-operator
   spec:
     endpointPublishingStrategy:
       loadBalancer:
         scope: External
         providerParameters:
           type: AWS
           aws:
             type: NLB
       type: LoadBalancerService

   注記

   spec.endpointPublishingStrategy.loadBalancer.providerParameters.aws.type フィールドの値を指定しない場合、Ingress Controller は、インストール時に設定されたクラスター Ingress 設定の spec.loadBalancer.platform.aws.type 値を使用します。

   ヒント

   Ingress Controller に、ドメインの変更など、更新したい他のカスタマイズがある場合は、代わりに Ingress Controller 定義ファイルを強制的に置き換えることを検討してください。

2. 次のコマンドを実行して、Ingress Controller YAML ファイルに変更を適用します。

   $ oc apply -f ingresscontroller.yaml

   Ingress Controller の更新中は、数分間の停止が予想されます。

手順

1. CLB を使用して切り替える既存の Ingress Controller を変更します。この例では、デフォルトの Ingress Controller に External スコープがあり、他のカスタマイズがないことを前提としています。

   ingresscontroller.yaml ファイルの例

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     creationTimestamp: null
     name: default
     namespace: openshift-ingress-operator
   spec:
     endpointPublishingStrategy:
       loadBalancer:
         scope: External
         providerParameters:
           type: AWS
           aws:
             type: Classic
       type: LoadBalancerService

   注記

   spec.endpointPublishingStrategy.loadBalancer.providerParameters.aws.type フィールドの値を指定しない場合、Ingress Controller は、インストール時に設定されたクラスター Ingress 設定の spec.loadBalancer.platform.aws.type 値を使用します。

   ヒント

   Ingress Controller に、ドメインの変更など、更新したい他のカスタマイズがある場合は、代わりに Ingress Controller 定義ファイルを強制的に置き換えることを検討してください。

2. 次のコマンドを実行して、Ingress Controller YAML ファイルに変更を適用します。

   $ oc apply -f ingresscontroller.yaml

   Ingress Controller の更新中は、数分間の停止が予想されます。

手順

1. 新しいデフォルトの Ingress Controller を含むファイルを作成します。以下の例では、デフォルトの Ingress Controller の範囲が External で、その他のカスタマイズをしていないことを想定しています。

   ingresscontroller.yml ファイルの例

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     creationTimestamp: null
     name: default
     namespace: openshift-ingress-operator
   spec:
     endpointPublishingStrategy:
       loadBalancer:
         scope: External
         providerParameters:
           type: AWS
           aws:
             type: NLB
       type: LoadBalancerService

   デフォルトの Ingress Controller が他にカスタマイズされている場合には、それに応じてファイルを修正してください。

   ヒント

   Ingress Controller に他のカスタマイズがなく、ロードバランサータイプのみを更新する場合は、「Ingress Controller を Classic Load Balancer から Network Load Balancer に切り替える」に記載の手順に従ってください。

2. Ingress Controller の YAML ファイルを強制的に置き換えます。

   $ oc replace --force --wait -f ingresscontroller.yml

   Ingress Controller の置き換えが完了するまでお待ちください。数分間の停止が予想されます。

1. Ingress Controller のマニフェストを作成します。

    $ cat ingresscontroller-aws-nlb.yaml

   出力例

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     name: $my_ingress_controller1
     namespace: openshift-ingress-operator
   spec:
     domain: $my_unique_ingress_domain2
     endpointPublishingStrategy:
       type: LoadBalancerService
       loadBalancer:
         scope: External3
         providerParameters:
           type: AWS
           aws:
             type: NLB

   1

   $my_ingress_controller を Ingress Controller の一意の名前に置き換えます。

   2

   $my_unique_ingress_domain を、クラスター内のすべての Ingress Controller 間で一意のドメイン名に置き換えます。この変数は、DNS 名 <clustername>.<domain> のサブドメインである必要があります。

   3

   External を内部 NLB を使用するために Internal に置き換えることができます。

2. クラスターにリソースを作成します。

   $ oc create -f ingresscontroller-aws-nlb.yaml

1. インストールプログラムが含まれるディレクトリーに切り替え、マニフェストを作成します。

   $ ./openshift-install create manifests --dir <installation_directory> 1

   1

   <installation_directory> については、クラスターの install-config.yaml ファイルが含まれるディレクトリーの名前を指定します。

2. cluster-ingress-default-ingresscontroller.yaml という名前のファイルを <installation_directory>/manifests/ ディレクトリーに作成します。

   $ touch <installation_directory>/manifests/cluster-ingress-default-ingresscontroller.yaml 1

   1

   <installation_directory> については、クラスターの manifests/ ディレクトリーが含まれるディレクトリー名を指定します。

   ファイルの作成後は、以下のようにいくつかのネットワーク設定ファイルが manifests/ ディレクトリーに置かれます。

   $ ls <installation_directory>/manifests/cluster-ingress-default-ingresscontroller.yaml

   出力例

   cluster-ingress-default-ingresscontroller.yaml

3. エディターで cluster-ingress-default-ingresscontroller.yaml ファイルを開き、必要な Operator 設定を記述するカスタムリソース (CR) を入力します。

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     creationTimestamp: null
     name: default
     namespace: openshift-ingress-operator
   spec:
     endpointPublishingStrategy:
       loadBalancer:
         scope: External
         providerParameters:
           type: AWS
           aws:
             type: NLB
       type: LoadBalancerService

4. cluster-ingress-default-ingresscontroller.yaml ファイルを保存し、テキストエディターを終了します。
5. オプション: manifests/cluster-ingress-default-ingresscontroller.yaml ファイルをバックアップします。インストールプログラムは、クラスターの作成時に manifests/ ディレクトリーを削除します。

手順

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

   次の内容の YAML ファイル (例: sample-ingress.yaml) を作成します。

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     namespace: openshift-ingress-operator
     name: <name>
   spec:
     domain: <domain>
     endpointPublishingStrategy:
       type: LoadBalancerService
       loadBalancer:
         scope: External
     dnsManagementPolicy: Managed

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

   YAML ファイルにサブネットを追加します。

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     name:  <name> 1
     namespace: openshift-ingress-operator
   spec:
     domain: <domain> 2
     endpointPublishingStrategy:
       type: LoadBalancerService
       loadBalancer:
         scope: External
         providerParameters:
           type: AWS
           aws:
             type: Classic
             classicLoadBalancer: 3
               subnets:
                 ids: 4
                 - <subnet> 5
                 - <subnet>
                 - <subnet>
   dnsManagementPolicy: Managed

   1

   <name> は、IngressController の名前に置き換えます。

   2

   <domain> は、IngressController によって提供される DNS 名に置き換えます。

   3

   NLB を使用する場合は、networkLoadBalancer フィールドを使用することもできます。

   4

   必要に応じて、ID でサブネットを指定する代わりに、names フィールドを使用して名前でサブネットを指定することもできます。

   5

   サブネット ID (names を使用する場合は名前) を指定します。

   重要

   アベイラビリティーゾーンごとに最大 1 つのサブネットを指定できます。外部 Ingress Controller にはパブリックサブネットだけを指定し、内部 Ingress Controller にはプライベートサブネットだけを指定してください。

3. CR ファイルを適用します。

   1. ファイルを保存し、OpenShift CLI (oc) を使用して適用します。

      $  oc apply -f sample-ingress.yaml

   2. IngressController の状態を確認して、ロードバランサーが正常にプロビジョニングされたことを確認します。

      $ oc get ingresscontroller -n openshift-ingress-operator <name> -o jsonpath="{.status.conditions}" | yq -PC

1. 既存の IngressController を変更して、新しいサブネットに更新します。

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     name:  <name> 1
     namespace: openshift-ingress-operator
   spec:
     domain: <domain> 2
     endpointPublishingStrategy:
       type: LoadBalancerService
       loadBalancer:
         scope: External
         providerParameters:
           type: AWS
           aws:
             type: Classic 3
             classicLoadBalancer: 4
               subnets:
                 ids: 5
                 - <updated_subnet> 6
                 - <updated_subnet>
                 - <updated_subnet>

   1

   <name> は、IngressController の名前に置き換えます。

   2

   <domain> は、IngressController によって提供される DNS 名に置き換えます。

   3

   新しいサブネット ID (names を使用する場合は名前) を指定します。

   4

   NLB を使用する場合は、networkLoadBalancer フィールドを使用することもできます。

   5

   必要に応じて、ID でサブネットを指定する代わりに、names フィールドを使用して名前でサブネットを指定することもできます。

   6

   サブネット ID (names を使用する場合は名前) を更新します。

   重要

   アベイラビリティーゾーンごとに最大 1 つのサブネットを指定できます。外部 Ingress Controller にはパブリックサブネットだけを指定し、内部 Ingress Controller にはプライベートサブネットだけを指定してください。

2. 次のコマンドを実行して、IngressController の Progressing 状態を調べ、サブネットの更新を適用する方法について確認します。

   $ oc get ingresscontroller -n openshift-ingress-operator subnets -o jsonpath="{.status.conditions[?(@.type==\"Progressing\")]}" | yq -PC

   出力例

   lastTransitionTime: "2024-11-25T20:19:31Z"
   message: 'One or more status conditions indicate progressing: LoadBalancerProgressing=True (OperandsProgressing: One or more managed resources are progressing: The IngressController subnets were changed from [...] to [...].  To effectuate this change, you must delete the service: `oc -n openshift-ingress delete svc/router-<name>`; the service load-balancer will then be deprovisioned and a new one created. This will most likely cause the new load-balancer to have a different host name and IP address and cause disruption. To return to the previous state, you can revert the change to the IngressController: [...]'
   reason: IngressControllerProgressing
   status: "True"
   type: Progressing

3. 更新を適用するために、次のコマンドを実行して、Ingress Controller に関連付けられているサービスを削除します。