Ingress と負荷分散

手順

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 アプリケーションに対して、セキュアではないルートを作成します。

   $ oc expose svc hello-openshift

手順

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
     name: hello-openshift-edge
     namespace: hello-openshift
   spec:
     subdomain: hello-openshift
     tls:
       termination: edge
     to:
       kind: Service
       name: hello-openshift

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

   type

   ラベルキーとその対応するラベル値は、Ingress Controller で指定されたものと一致する必要があることを指定します。この例では、Ingress Controller にはラベルキーと値 type: sharded があります。

   subdomain

   サブドメイン フィールドの値を使用して公開されるルートを指定します。subdomain フィールドを指定するときは、ホスト名を未設定のままにしておく必要があります。ホストフィールド と サブドメイン フィールドの両方を指定した場合、ルートは ホスト フィールドの値を使用し、サブドメイン フィールドは無視します。

5. 次のコマンドを実行し、hello-openshift-route.yaml を使用して hello-openshift アプリケーションへのルートを作成します。

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

手順

1. OpenShift Container Platform コンソールで Ingress オブジェクトを定義するか、oc create コマンドを実行します。

   Ingress の YAML 定義

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: frontend
     annotations:
       route.openshift.io/termination: "reencrypt"
       route.openshift.io/destination-ca-certificate-secret: secret-ca-cert
   spec:
     rules:
     - host: www.example.com
       http:
         paths:
         - backend:
             service:
               name: frontend
               port:
                 number: 443
           path: /
           pathType: Prefix
     tls:
     - hosts:
       - www.example.com
       secretName: example-com-tls-certificate
   # ...

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

   route.openshift.io/termination

   route.openshift.io/termination アノテーションを指定します。Ingress には このパラメーターがないため、Route の spec.tls.termination パラメーターを設定できます。受け入れられる値は、edge、passthrough、reencrypt です。その他のすべての値は警告なしに無視されます。アノテーション値が設定されていない場合は、edge がデフォルトルートになります。デフォルトの edge ルートを実装するには、TLS 証明書の詳細をテンプレートファイルで定義する必要があります。

   ルールホスト

   Ingress オブジェクトのホスト名を明示的に指定します。必須パラメーター。<host_name>.<cluster_ingress_domain> 構文 (apps.openshiftdemos.com など) を使用して、*.<cluster_ingress_domain> ワイルドカード DNS レコードとクラスターのサービング証明書を利用できます。それ以外の場合は、選択したホスト名の DNS レコードがあることを確認する必要があります。

   宛先 CA 証明書シークレット

   route.openshift.io/destination-ca-certificate-secret アノテーションを指定します。このアノテーションは、Ingress オブジェクトで使用して、カスタム宛先証明書 (CA) を使用したルートを定義するために使用できます。アノテーションは、生成されたルートに挿入される kubernetes シークレット secret-ca-cert を参照します。

   1. route.openshift.io/termination アノテーションで passthrough の値を指定する場合は、仕様で path を '' に設定し、pathType を ImplementationSpecific に設定します。

      apiVersion: networking.k8s.io/v1
      kind: Ingress
      # ...
        spec:
          rules:
          - host: www.example.com
            http:
              paths:
              - path: ''
                pathType: ImplementationSpecific
                backend:
                  service:
                    name: frontend
                    port:
                      number: 443
      # ...

      $ oc apply -f ingress.yaml

   2. Ingress オブジェクトから宛先 CA を使用してルートオブジェクトを指定するには、シークレットの data.tls.crt 指定子に PEM エンコード形式の証明書を使用して kubernetes.io/tls または Opaque タイプのシークレットを作成する必要があります。

2. ルートを一覧表示します。

   $ oc get routes

   結果には、frontend- で始まる名前の自動生成ルートが含まれます。

   NAME             HOST/PORT         PATH    SERVICES    PORT    TERMINATION          WILDCARD
   frontend-gnztq   www.example.com           frontend    443     reencrypt/Redirect   None

   自動生成されたルートの YAML 定義例

   apiVersion: route.openshift.io/v1
   kind: Route
   metadata:
     name: frontend-gnztq
     ownerReferences:
     - apiVersion: networking.k8s.io/v1
       controller: true
       kind: Ingress
       name: frontend
       uid: 4e6c59cc-704d-4f44-b390-617d879033b6
   spec:
     host: www.example.com
     path: /
     port:
       targetPort: https
     tls:
       certificate: |
         -----BEGIN CERTIFICATE-----
         [...]
         -----END CERTIFICATE-----
       insecureEdgeTerminationPolicy: Redirect
       key: |
         -----BEGIN RSA PRIVATE KEY-----
         [...]
         -----END RSA PRIVATE KEY-----
       termination: reencrypt
       destinationCACertificate: |
         -----BEGIN CERTIFICATE-----
         [...]
         -----END CERTIFICATE-----
     to:
       kind: Service
       name: frontend

手順

1. ルート定義を作成し、app-example-route.yaml というファイルに保存します。

   HTTP ヘッダーディレクティブを使用して作成されたルートの YAML 定義

   apiVersion: route.openshift.io/v1
   kind: Route
   # ...
   spec:
     host: app.example.com
     tls:
       termination: edge
     to:
       kind: Service
       name: app-example
     httpHeaders:
       actions:
         response:
         - name: Content-Location
           action:
             type: Set
             set:
               value: /lang/en-us
   # ...

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

   actions

   HTTP ヘッダーに対して実行するアクションのリストを指定します。

   response

   変更したいヘッダーの種類を指定します。この場合は、応答ヘッダーです。

   レスポンス名

   変更したいヘッダーの名前を指定します。設定または削除できる使用可能なヘッダーのリストは、HTTP ヘッダーの設定 を参照してください。

   アクション.タイプ

   ヘッダーに対して実行されるアクションの種類を指定します。このフィールドには、Set または Delete の値を指定できます。

   設定値

   HTTP ヘッダーの設定時は、値 を指定する必要があります。値は、そのヘッダーで使用可能なディレクティブのリストからの文字列 (例: DENY) にすることも、HAProxy の動的値構文を使用して解釈される動的値にすることもできます。この場合、値はコンテンツの相対位置に設定されます。

2. 新しく作成したルート定義を使用して、既存の Web アプリケーションへのルートを作成します。

   $ oc -n app-example create -f app-example-route.yaml

   HTTP リクエストヘッダーの場合、ルート定義で指定されたアクションは、Ingress Controller の HTTP リクエストヘッダーに対して実行されたアクションの後に実行されます。これは、ルート内のこれらのリクエストヘッダーに設定された値が、Ingress Controller に設定された値よりも優先されることを意味します。HTTP ヘッダーの処理順序の詳細は、HTTP ヘッダーの設定 を参照してください。

手順

1. Ingress Controller が、IPv4 / IPv6 を介してトラフィックをワークロードに提供するようにするには、ipFamilies フィールドおよび ipFamilyPolicy フィールドを設定して、サービス YAML ファイルを作成するか、既存のサービス YAML ファイルを変更します。以下に例を示します。

   サービス YAML ファイルの例

   apiVersion: v1
   kind: Service
   metadata:
     creationTimestamp: yyyy-mm-ddT00:00:00Z
     labels:
       name: <service_name>
       manager: kubectl-create
       operation: Update
       time: yyyy-mm-ddT00:00:00Z
     name: <service_name>
     namespace: <namespace_name>
     resourceVersion: "<resource_version_number>"
     selfLink: "/api/v1/namespaces/<namespace_name>/services/<service_name>"
     uid: <uid_number>
   spec:
     clusterIP: 172.30.0.0/16
     clusterIPs: 

   1

   
     - 172.30.0.0/16
     - <second_IP_address>
     ipFamilies: 

   2

   
     - IPv4
     - IPv6
     ipFamilyPolicy: RequireDualStack 

   3

   
     ports:
     - port: 8080
       protocol: TCP
       targetport: 8080
     selector:
       name: <namespace_name>
     sessionAffinity: None
     type: ClusterIP
   status:
     loadbalancer: {}

   1 1

   デュアルスタックインスタンスでは、2 つの異なる clusterIPs が提供されます。

   2

   シングルスタックインスタンスの場合は、IPv4 または IPv6 と入力します。デュアルスタックインスタンスの場合は、IPv4 と IPv6 の両方を入力します。

   3

   シングルスタックインスタンスの場合は、SingleStack と入力します。デュアルスタックインスタンスの場合は、RequireDualStack と入力します。

   これらのリソースは、対応する endpoints を生成します。Ingress Controller は、endpointslices を監視するようになりました。

2. endpoints を表示するには、以下のコマンドを入力します。

   $ oc get endpoints

3. endpointslices を表示するには、以下のコマンドを入力します。

   $ oc get endpointslices

手順

1. 次のコマンドを入力して、宛先 CA 証明書のシークレットを作成します。

   $ oc create secret generic dest-ca-cert --from-file=tls.crt=<file_path>

   以下に例を示します。

   $ oc -n test-ns create secret generic dest-ca-cert --from-file=tls.crt=tls.crt

   出力例

   secret/dest-ca-cert created

2. route.openshift.io/destination-ca-certificate-secret を Ingress アノテーションに追加します。

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: frontend
     annotations:
       route.openshift.io/termination: "reencrypt"
       route.openshift.io/destination-ca-certificate-secret: secret-ca-cert
   ...

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

   宛先 CA 証明書シークレット

   route.openshift.io/destination-ca-certificate-secret アノテーションを指定します。このアノテーションは Kubernetes のシークレットを参照しています。

   Ingress コントローラーは、アノテーションで参照されているシークレットを生成されたルートに挿入します。

   出力例

   apiVersion: route.openshift.io/v1
   kind: Route
   metadata:
     name: frontend
     annotations:
       route.openshift.io/termination: reencrypt
       route.openshift.io/destination-ca-certificate-secret: secret-ca-cert
   spec:
   ...
     tls:
       insecureEdgeTerminationPolicy: Redirect
       termination: reencrypt
       destinationCACertificate: |
         -----BEGIN CERTIFICATE-----
         [...]
         -----END CERTIFICATE-----
   ...

手順

1. 次のコマンドを実行して、シークレットと同じ namespace に role オブジェクトを作成し、ルーターサービスアカウントに読み取りアクセスを許可します。

   $ oc create role secret-reader --verb=get,list,watch --resource=secrets --resource-name=<secret-name> \
   --namespace=<current-namespace>

   • <secret-name>: シークレットの実際の名前を指定します。
   • <current-namespace>: シークレットとルートの両方が存在する namespace を指定します。

2. 次のコマンドを実行して、シークレットと同じ namespace に rolebinding オブジェクトを作成し、ルーターサービスアカウントを新しく作成されたロールにバインドします。

   $ oc create rolebinding secret-reader-binding --role=secret-reader --serviceaccount=openshift-ingress:router --namespace=<current-namespace>

   • <current-namespace>: シークレットとルートの両方が存在する namespace を指定します。

3. 次の例を使用して、route を定義し、証明書を含むシークレットを指定する YAML ファイルを作成します。

   セキュアなルートの YAML 定義

   apiVersion: route.openshift.io/v1
   kind: Route
   metadata:
     name: myedge
     namespace: test
   spec:
     host: myedge-test.apps.example.com
     tls:
       externalCertificate:
         name: <secret-name>
       termination: edge
       [...]
   [...]

   • <secret-name>: シークレットの実際の名前を指定します。

4. 次のコマンドを実行して route リソースを作成します。

   $ oc apply -f <route.yaml>

   • <route.yaml>: 生成された YAML ファイル名を指定します。

     シークレットが存在し、証明書/キーペアがある場合、すべての前提条件が満たされていれば、ルーターは生成された証明書を提供します。

     注記

     .spec.tls.externalCertificate が指定されていないと、ルーターはデフォルトで生成された証明書を使用します。

     .spec.tls.externalCertificate フィールドを使用する場合は、.spec.tls.certificate フィールドまたは .spec.tls.key フィールドを指定することはできません。

手順

1. Ingress オブジェクトの YAML ファイルを作成します。次の例では、ファイル名は example-ingress.yaml です。

   Ingress オブジェクトの YAML 定義

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: frontend
     ...
   spec:
     rules:
       ...
     tls:
     - {}

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

   spec.tls

   TLS 設定を指定します。カスタム証明書を指定せずに TLS を指定するには、示されている構文を正確に使用してください。

2. 次のコマンドを実行して、Ingress オブジェクトを作成します。

   $ oc create -f example-ingress.yaml

手順

1. オプション: 現在の外部 IP 設定を表示するには、以下のコマンドを入力します。

   $ oc describe networks.config cluster

2. 設定を編集するには、以下のコマンドを入力します。

   $ oc edit networks.config cluster

3. 以下の例のように ExternalIP 設定を変更します。

   apiVersion: config.openshift.io/v1
   kind: Network
   metadata:
     name: cluster
   spec:
     ...
     externalIP:
     ...

   • externalIP: externalIP スタンザの設定を指定します。

4. 更新された ExternalIP 設定を確認するには、以下のコマンドを入力します。

   $ oc get networks.config cluster -o go-template='{{.spec.externalIP}}{{"\n"}}'

手順

1. oc new-project コマンドを実行して、サービス用の新しいプロジェクトを作成します。

   $ oc new-project <project_name>

2. oc new-app コマンドを使用してサービスを作成します。

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

3. サービスが作成されたことを確認するには、以下のコマンドを実行します。

   $ oc get svc -n <project_name>

   出力例

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

   注記

   デフォルトで、新規サービスには外部 IP アドレスがありません。

手順

1. 公開するサービスが置かれているプロジェクトにログインします。

   $ oc project <project_name>

2. oc expose service コマンドを実行して、ルートを公開します。

   $ oc expose service nodejs-ex

   出力例

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

3. サービスが公開されていることを確認するには、curl などのツールを使用して、クラスター外からサービスにアクセスできることを確認します。

   1. ルートのホスト名を見つけるには、次のコマンドを入力します。

      $ oc get route

      出力例

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

   2. ホストが GET 要求に応答することを確認するには、次のコマンドを入力します。

      curl コマンドの例

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

      出力例

      HTTP/1.1 200 OK
      ...

手順

1. oc new-project コマンドを実行して、サービス用の新しいプロジェクトを作成します。

   $ oc new-project <project_name>

2. oc new-app コマンドを使用してサービスを作成します。

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

3. サービスが作成されたことを確認するには、以下のコマンドを実行します。

   $ oc get svc -n <project_name>

   出力例

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

   注記

   デフォルトで、新規サービスには外部 IP アドレスがありません。

手順

1. 公開するサービスが置かれているプロジェクトにログインします。

   $ oc project <project_name>

2. oc expose service コマンドを実行して、ルートを公開します。

   $ oc expose service nodejs-ex

   出力例

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

3. サービスが公開されていることを確認するには、curl などのツールを使用して、クラスター外からサービスにアクセスできることを確認します。

   1. ルートのホスト名を見つけるには、次のコマンドを入力します。

      $ oc get route

      出力例

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

   2. ホストが GET 要求に応答することを確認するには、次のコマンドを入力します。

      curl コマンドの例

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

      出力例

      HTTP/1.1 200 OK
      ...

手順

1. OpenShift Container Platform にログインします。

2. 公開するサービスが置かれているプロジェクトを読み込みます。

   コマンドの例

   $ oc project project1

3. コントロールプレーンノード上のテキストファイルを開き、以下のテキストをファイルに貼り付けてください。必要に応じてファイルを編集してください。

   ロードバランサー設定ファイルのサンプル

   apiVersion: v1
   kind: Service
   metadata:
     name: egress-2
   spec:
     ports:
     - name: db
       port: 3306
     loadBalancerIP:
     loadBalancerSourceRanges:
     - 10.0.0.0/8
     - 192.168.0.0/16
     type: LoadBalancer
     selector:
       name: mysql

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

   metadata.name

   ロードバランサーサービスの説明的な名前を指定します。

   ポート.ポート

   公開したいサービスがリッスンしているポートと同じポートを指定します。

   loadBalancerSourceRanges

   ロードバランサーを通過するトラフィックを制限する特定の IP アドレスのリストを指定します。クラウドプロバイダーがこの機能をサポートしていない場合、このパラメーターは無視されます。

   type

   タイプとして ロードバランサーを 指定します。

   セレクター名

   サービスの名前を指定します。

   注記

   ロードバランサーを経由するトラフィックを特定の IP アドレスに制限するには、spec.endpointPublishingStrategy.loadBalancer.allowedSourceRanges Ingress Controller パラメーターを使用します。loadBalancerSourceRanges パラメーターを設定しないでください。

4. ファイルを保存し、終了します。

5. 以下のコマンドを実行してサービスを作成します。

   $ oc create -f <file_name>

   以下に例を示します。

   $ oc create -f mysql-lb.yaml

6. 以下のコマンドを実行して新規サービスを表示します。

   $ oc get svc

   出力例

   NAME       TYPE           CLUSTER-IP      EXTERNAL-IP                             PORT(S)          AGE
   egress-2   LoadBalancer   172.30.22.226   ad42f5d8b303045-487804948.example.com   3306:30357/TCP   15m

   有効にされたクラウドプロバイダーがある場合、サービスには外部 IP アドレスが自動的に割り当てられます。

7. マスターサーバー上で、curl などのツールを使用して、パブリック IP アドレスを使用してサービスにアクセスできることを確認してください。

   $ curl <public_ip>:<port>

   以下に例を示します。

   $ curl 172.29.121.74:3306

   このセクションの例では、クライアントアプリケーションを必要とする MySQL サービスを使用しています。Got packets out of order のメッセージと共に文字ストリングを取得する場合は、このサービスに接続していることになります。

   MySQL クライアントがある場合は、標準 CLI コマンドでログインします。

   $ mysql -h 172.30.131.89 -u admin -p

   出力例

   Enter password:
   Welcome to the MariaDB monitor.  Commands end with ; or \g.
   
   MySQL [(none)]>

手順

1. CLI で次のコマンドを実行して、ExternalIP リソースの互換性のある IP アドレス範囲を確認します。

   $ oc get networks.config cluster -o jsonpath='{.spec.externalIP}{"\n"}'

   注記

   autoAssignCIDRs が設定されていて、ExternalIP リソースの spec.externalIPs の値を指定していないと、OpenShift Container Platform は新しい Service オブジェクトに ExternalIP を自動的に割り当てます。

2. サービスに ExternalIP リソースを割り当てるには、次のいずれかのオプションを選択します。

   1. 新しいサービスを作成する場合は、spec.externalIPs パラメーターに値を指定し、allowedCIDRs パラメーターに 1 つ以上の有効な IP アドレスの配列を指定してください。

      ExternalIP リソースをサポートするサービス YAML 設定ファイルの例

      apiVersion: v1
      kind: Service
      metadata:
        name: svc-with-externalip
      spec:
        externalIPs:
          policy:
            allowedCIDRs:
            - 192.168.123.0/28
      # ...

   2. ExternalIP を既存のサービスに割り当てる場合は、以下のコマンドを入力します。<name> をサービス名に置き換えます。<ip_address> を有効な ExternalIP アドレスに置き換えます。コンマで区切られた複数の IP アドレスを指定できます。

      $ oc patch svc <name> -p \
        '{
          "spec": {
            "externalIPs": [ "<ip_address>" ]
          }
        }'

      以下に例を示します。

      $ oc patch svc mysql-55-rhel7 -p '{"spec":{"externalIPs":["192.174.120.10"]}}'

      出力例

      "mysql-55-rhel7" patched

3. ExternalIP アドレスがサービスに割り当てられていることを確認するには、以下のコマンドを入力します。新規サービスに ExternalIP を指定した場合、まずサービスを作成する必要があります。

   $ oc get svc

   出力例

   NAME               CLUSTER-IP      EXTERNAL-IP     PORT(S)    AGE
   mysql-55-rhel7     172.30.131.89   192.174.120.10  3306/TCP   13m

手順

1. oc new-project コマンドを実行して、サービス用の新しいプロジェクトを作成します。

   $ oc new-project <project_name>

2. oc new-app コマンドを使用してサービスを作成します。

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

3. サービスが作成されたことを確認するには、以下のコマンドを実行します。

   $ oc get svc -n <project_name>

   出力例

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

   注記

   デフォルトで、新規サービスには外部 IP アドレスがありません。

手順

1. 公開するサービスが置かれているプロジェクトにログインします。

   $ oc project <project_name>

2. アプリケーションのノードポートを公開するには、次のコマンドを入力して、サービスのカスタムリソース定義 (CRD) を変更します。

   $ oc edit svc <service_name>

   出力例

   spec:
     ports:
     - name: 8443-tcp
       nodePort: 30327
       port: 8443
       protocol: TCP
       targetPort: 8443
     sessionAffinity: None
     type: NodePort

   • nodePort: オプションのパラメーター。アプリケーションのノードポート範囲を指定します。デフォルトでは、OpenShift Container Platform は 30000-32767 範囲で使用可能なポートを選択します。
   • type: サービスの種類を指定します。

3. オプション: サービスが公開されるノードポートで利用可能なことを確認するには、以下のコマンドを入力します。

   $ oc get svc -n myproject

   出力例

   NAME                TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)          AGE
   nodejs-ex           ClusterIP   172.30.217.127   <none>        3306/TCP         9m44s
   nodejs-ex-ingress   NodePort    172.30.107.72    <none>        3306:31345/TCP   39s

4. オプション: oc new-app コマンドによって自動的に作成されたサービスを削除するには、以下のコマンドを入力します。

   $ oc delete svc nodejs-ex

手順

1. 以下のコマンドを入力して、service.beta.kubernetes.io/load -balancer-source-ranges が正しく設定されていることを確認してください。

   $ oc get svc router-default -n openshift-ingress -o yaml

   出力例

   apiVersion: v1
   kind: Service
   metadata:
     annotations:
       service.beta.kubernetes.io/load-balancer-source-ranges: 192.168.0.1/32

2. 以下のコマンドを入力して、spec.loadBalancerSourceRanges パラメーターが設定されていないことを確認してください。

   $ oc get svc router-default -n openshift-ingress -o yaml

   出力例

   ...
   spec:
     loadBalancerSourceRanges:
     - 0.0.0.0/0
   ...

3. クラスターを OpenShift Container Platform 4.20 に更新します。

4. 次のコマンドを実行して、ingresscontroller の許可されるソース範囲 API を設定します。

   $ oc -n openshift-ingress-operator patch ingresscontroller/default \
       --type=merge --patch='{"spec":{"endpointPublishingStrategy": \
       {"loadBalancer":{"allowedSourceRanges":["0.0.0.0/0"]}}}}'

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

   allowedSourceRanges

   例の値 0.0.0.0/0 は、許可されるソース範囲を指定します。

手順

1. すべての IngressClass オブジェクトをリスト表示します。

   $ oc get ingressclass

2. 全 namespace 内の Ingress オブジェクトをすべてリスト表示します。

   $ oc get ingress -A

3. 以下のコマンドを実行して、Ingress オブジェクトにパッチを適用します。このコマンドは、Ingress オブジェクトにパッチを適用して、目的の Ingress クラス名を含めます。

   $ oc patch ingress/<ingress_name> --type=merge --patch '{"spec":{"ingressClassName":"openshift-default"}}'

   • <ingress_name>: <ingress_name> をIngress オブジェクトの名前に置き換えてください。

手順

1. 次の内容を含む、sample-ingress.yaml という名前の IngressController カスタムリソース (CR) ファイルを作成します。

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

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

   metadata.name

   IngressController オブジェクトの名前で <name> を指定します。

   仕様ドメイン

   前提として作成した DNS レコードをもとに domain を指定します。

   loadBalancer.scope

   scope を External として指定して、ロードバランサーを外部に公開します。loadBalancer.dnsManagementPolicy: Ingress Controller がロードバランサーに関連付けられたワイルドカード DNS レコードのライフサイクルを管理するかどうかを指定します。有効な値は Managed および Unmanaged です。デフォルト値は Managed です。

2. マニフェストを適用して IngressController オブジェクトを作成します。

   $ oc apply -f sample-ingress.yaml

3. 次のコマンドを実行して、Ingress Controller が正しいポリシーで作成されたことを確認します。

   $ oc get ingresscontroller <name> -n openshift-ingress-operator -o=jsonpath={.spec.endpointPublishingStrategy.loadBalancer}

   出力を検査し、dnsManagementPolicy が Unmanaged に設定されていることを確認します。

手順

1. 選択した Ingress Controller を変更して、dnsManagementPolicy パラメーターを設定します。

   $ SCOPE=$(oc -n openshift-ingress-operator get ingresscontroller <name> -o=jsonpath="{.status.endpointPublishingStrategy.loadBalancer.scope}")

   $ oc -n openshift-ingress-operator patch ingresscontrollers/default --type=merge --patch="{\"spec\":{\"endpointPublishingStrategy\":{\"type\":\"LoadBalancerService\",\"loadBalancer\":{\"dnsManagementPolicy\":\"Unmanaged\", \"scope\":\"${SCOPE}\"}}}}"
   ingresscontroller.operator.openshift.io/default patched

2. 次のコマンドを実行して、Ingress Controller が正しく変更されたことを確認します。

   $ oc get ingresscontroller <name> -n openshift-ingress-operator -o=jsonpath={.spec.endpointPublishingStrategy.loadBalancer}

   出力を検査し、dnsManagementPolicy が Unmanaged に設定されていることを確認します。