6.8. Ingress コントローラーの設定

前提条件

• PEM エンコードされたファイルに証明書/キーのペアがなければなりません。ここで、証明書は信頼される認証局またはカスタム PKI で設定されたプライベートの信頼される認証局で署名されます。

• 証明書が以下の要件を満たしている必要があります。

  • 証明書が Ingress ドメインに対して有効化されている必要があります。
  • 証明書は拡張を使用して、subjectAltName 拡張を使用して、*.apps.ocp4.example.com などのワイルドカードドメインを指定します。

• IngressController CR がなければなりません。デフォルトの CR を使用できます。

  $ oc --namespace openshift-ingress-operator get ingresscontrollers

  Copy to Clipboard Toggle word wrap

  出力例

  NAME      AGE
  default   10m

  Copy to Clipboard Toggle word wrap

前提条件

• cluster-admin ロールを持つユーザーとしてクラスターにアクセスできる。
• OpenShift CLI (oc) がインストールされている。
• Ingress Controller のカスタムデフォルト証明書を設定している。

手順

• カスタム証明書を削除し、OpenShift Container Platform に同梱されている証明書を復元するには、以下のコマンドを入力します。

  $ oc patch -n openshift-ingress-operator ingresscontrollers/default \
    --type json -p $'- op: remove\n  path: /spec/defaultCertificate'

  Copy to Clipboard Toggle word wrap

  クラスターが新しい証明書設定を調整している間、遅延が発生する可能性があります。

検証

• 元のクラスター証明書が復元されたことを確認するには、次のコマンドを入力します。

  $ echo Q | \
    openssl s_client -connect console-openshift-console.apps.<domain>:443 -showcerts 2>/dev/null | \
    openssl x509 -noout -subject -issuer -enddate

  Copy to Clipboard Toggle word wrap

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

  <domain>

  クラスターのベースドメイン名を指定します。

  出力例

  subject=CN = *.apps.<domain>
  issuer=CN = ingress-operator@1620633373
  notAfter=May 10 10:44:36 2023 GMT

  Copy to Clipboard Toggle word wrap

前提条件

• cluster-admin 権限を持つユーザーとしてログインしている。

• Ingress アクセスロギングを設定するには、spec.logging.access.destination を使用して宛先を指定する必要があります。サイドカーコンテナーへのロギングを指定するには、Container spec.logging.access.destination.type を指定する必要があります。以下の例は、コンテナー Container の宛先に対してログ記録する Ingress コントローラー定義です。

  apiVersion: operator.openshift.io/v1
  kind: IngressController
  metadata:
    name: default
    namespace: openshift-ingress-operator
  spec:
    replicas: 2
    logging:
      access:
        destination:
          type: Container

  Copy to Clipboard Toggle word wrap

• Ingress コントローラーをサイドカーに対してログを記録するように設定すると、Operator は Ingress コントローラー Pod 内に logs という名前のコンテナーを作成します。

  $ oc -n openshift-ingress logs deployment.apps/router-default -c logs

  Copy to Clipboard Toggle word wrap

  出力例

  2020-05-11T19:11:50.135710+00:00 router-default-57dfc6cd95-bpmk6 router-default-57dfc6cd95-bpmk6 haproxy[108]: 174.19.21.82:39654 [11/May/2020:19:11:50.133] public be_http:hello-openshift:hello-openshift/pod:hello-openshift:hello-openshift:10.128.2.12:8080 0/0/1/0/1 200 142 - - --NI 1/1/0/0/0 0/0 "GET / HTTP/1.1"

  Copy to Clipboard Toggle word wrap

• Ingress アクセスロギングを設定するには、spec.logging.access.destination を使用して宛先を指定する必要があります。Syslog エンドポイント宛先へのロギングを指定するには、spec.logging.access.destination.type に Syslog を指定する必要があります。宛先タイプが Syslog の場合、spec.logging.access.destination.syslog.endpoint を使用して宛先エンドポイントも指定する必要があります。また、spec.logging.access.destination.syslog.facility を使用してファシリティーを指定できます。以下の例は、Syslog 宛先に対してログを記録する Ingress コントローラーの定義です。

  apiVersion: operator.openshift.io/v1
  kind: IngressController
  metadata:
    name: default
    namespace: openshift-ingress-operator
  spec:
    replicas: 2
    logging:
      access:
        destination:
          type: Syslog
          syslog:
            address: 1.2.3.4
            port: 10514

  Copy to Clipboard Toggle word wrap
  注記

  syslog 宛先ポートは UDP である必要があります。

• spec.logging.access.httpLogFormat を指定して、ログ形式をカスタマイズできます。以下の例は、IP アドレスが 1.2.3.4 およびポート 10514 の syslog エンドポイントに対してログを記録する Ingress コントローラーの定義です。

  apiVersion: operator.openshift.io/v1
  kind: IngressController
  metadata:
    name: default
    namespace: openshift-ingress-operator
  spec:
    replicas: 2
    logging:
      access:
        destination:
          type: Syslog
          syslog:
            address: 1.2.3.4
            port: 10514
        httpLogFormat: '%ci:%cp [%t] %ft %b/%s %B %bq %HM %HU %HV'

  Copy to Clipboard Toggle word wrap

• Ingress アクセスロギングを無効にするには、spec.logging または spec.logging.access を空のままにします。

  apiVersion: operator.openshift.io/v1
  kind: IngressController
  metadata:
    name: default
    namespace: openshift-ingress-operator
  spec:
    replicas: 2
    logging:
      access: null

  Copy to Clipboard Toggle word wrap

• Ingress コントローラーまたはルーターを複数のルートに分散し、変更に対する応答を加速します。
• 特定のルートを他のルートとは異なる信頼性の保証を持つように割り当てます。
• 特定の Ingress コントローラーに異なるポリシーを定義することを許可します。
• 特定のルートのみが追加機能を使用することを許可します。
• たとえば、異なるアドレスで異なるルートを公開し、内部ユーザーおよび外部ユーザーが異なるルートを認識できるようにします。

• 負荷は、外部からクラウドプロバイダーのロードバランサーを使用するか、内部から OpenShift Ingress Controller Load Balancer を使用して、分散できます。
• ロードバランサーのシングル IP アドレスと、図にあるクラスターのように、8080 や 4200 といった馴染みのあるポートを使用することができます。
• 外部のロードバランサーからのトラフィックは、ダウンしたノードのインスタンスで記載されているように、Pod の方向に進められ、ロードバランサーが管理します。実装の詳細については、Kubernetes サービスドキュメント を参照してください。

前提条件

• OpenShift CLI (oc) をインストールしている。
• cluster-admin 権限を持つユーザーとしてログインしている。

前提条件

• OpenShift CLI (oc) をインストールしている。
• cluster-admin 権限を持つユーザーとしてログインしている。

前提条件

• クラスター管理者の権限。

手順

• 以下のコマンドを使用して、ingresscontroller リソース変数の .spec.routeAdmission フィールドを編集します。

  $ oc -n openshift-ingress-operator patch ingresscontroller/default --patch '{"spec":{"routeAdmission":{"namespaceOwnership":"InterNamespaceAllowed"}}}' --type=merge

  Copy to Clipboard Toggle word wrap

  イメージコントローラー設定例

  spec:
    routeAdmission:
      namespaceOwnership: InterNamespaceAllowed
  ...

  Copy to Clipboard Toggle word wrap

• Ingress コントローラーに転送する前に、X-Forwarded-For ヘッダーを各リクエストに挿入する外部プロキシーを設定します。

  ヘッダーを変更せずに渡すように Ingress コントローラーを設定するには、never ポリシーを指定します。これにより、Ingress コントローラーはヘッダーを設定しなくなり、アプリケーションは外部プロキシーが提供するヘッダーのみを受信します。

• 外部プロキシーが外部クラスター要求を設定する X-Forwarded-For ヘッダーを変更せずに渡すように Ingress コントローラーを設定します。

  外部プロキシーを通過しない内部クラスター要求に X-Forwarded-For ヘッダーを設定するように Ingress コントローラーを設定するには、if-none ポリシーを指定します。外部プロキシー経由で HTTP 要求にヘッダーがすでに設定されている場合、Ingress コントローラーはこれを保持します。要求がプロキシーを通過していないためにヘッダーがない場合、Ingress コントローラーはヘッダーを追加します。

• X-Forwarded-For ヘッダーを挿入するアプリケーション固有の外部プロキシーを設定します。

  他の Route のポリシーに影響を与えずに、アプリケーションの Route 用にヘッダーを変更せずに渡すように Ingress コントローラーを設定するには、アプリケーションの Route に アノテーション haproxy.router.openshift.io/set-forwarded-headers: if-none または haproxy.router.openshift.io/set-forwarded-headers: never を追加します。

  注記

  Ingress コントローラーのグローバルに設定された値とは別に、haproxy.router.openshift.io/set-forwarded-headers アノテーションをルートごとに設定できます。

• Ingress コントローラーで HTTP/2 を有効にするには、oc annotate コマンドを入力します。

  $ oc -n openshift-ingress-operator annotate ingresscontrollers/<ingresscontroller_name> ingress.operator.openshift.io/default-enable-http2=true

  Copy to Clipboard Toggle word wrap

  <ingresscontroller_name> をアノテーションを付ける Ingress コントローラーの名前に置き換えます。

• クラスター全体で HTTP/2 を有効にするには、oc annotate コマンドを入力します。

  $ oc annotate ingresses.config/cluster ingress.operator.openshift.io/default-enable-http2=true

  Copy to Clipboard Toggle word wrap

前提条件

• OpenShift Container Platform クラスターをデプロイしていること。
• oc コマンドラインインターフェイスをインストールしている。