common パラメーター

common を使用して、アプリケーション・サーバー用に公開する Ingress または経路を使用して、Ingress ホスト・サブドメインを定義します。

さらに、 common パラメータを使用して、すべての appServer インスタンスに適用可能な共通のイングレスおよびサービス構成を定義します。

以下の YAML ファイルは、 commonのサンプル・スキーマです。
  common:
    ingress:
      host: ""
      # annotations: {}
      # labels: {}
      # className: ""
      # skipDefaultAnnotations: false
      # ssl:
        # enabled: true
        # identitySecretName: ""
      # customDomains: 
      # - host: ""
      #   annotations: {}
      #   labels: {}
      #   className: ""
      #   skipDefaultAnnotations: false
      #   ssl:
      #     enabled: true
      #     identitySecretName: ""
      # - host: ""
      #   annotations: {}
      #   labels: {}
      #   className: ""
      #   skipDefaultAnnotations: false
      #   ssl:
      #     enabled: true
      #     identitySecretName: ""
    # pod:
      # podAnnotations: {}
      # podLabels: {}
以下の表で、 SIPEnvironmentの common パラメーターに適用される属性について説明します。
プロパティー デフォルト値 値タイプ 必須 説明
ingress   オブジェクト はい ingress パラメーターを指定します。 入口の構成について詳しくは、 入口パラメーターを参照してください。
pod.podAnnotations   オブジェクト いいえ ポッドまたはデプロイメントに関する追加のアノテーションを、キーと値のペアとして指定します。
pod.podLabels   オブジェクト いいえ ポッドまたはデプロイメントの追加ラベルをキーと値のペアで指定します。
覚えておいてください： 以下の3つのラベルは、オペレーターが内部的に使用するものであるため、上書きしないでください。
  • app
  • type
  • internal.sip.ibm.com/apps

ingress パラメーター

以下の表で、 commonの ingress パラメーターに適用される属性について説明します。
プロパティー デフォルト値 値タイプ 必須 説明
host   ストリング はい Ingress リソースまたは経路リソースの作成に使用されるクラスターの Ingress サブドメインを指定します。
annotations   オブジェクト いいえ ingress または routes リソースの追加のアノテーションをキーと値のペアとして指定します。
className   ストリング いいえ ingress クラス名を指定します。 もしあったらnon-OpenShiftKubernetesクラスターの場合、デフォルトはnginx。
customDomains array いいえ リストを指定するcustomDomainsアプリケーションが公開される 1 つ以上の完全修飾ドメイン名 (FQDN) を使用します。 customDomains の設定については、 SIPEnvironmentの customDomains の設定と サンプルスキーマを参照のこと。
labels   オブジェクト いいえ ingress または routes リソースの追加ラベルをキーと値のペアとして指定します。
skipDefaultAnnotations いいえ ブール値 いいえ オペレーターがデフォルトで追加するすべての注釈をスキップする場合は、このプロパティを true に指定します。
ssl   オブジェクト いいえ SSL のパラメータを指定してください。 詳しくは、 ssl パラメーターを参照してください。
ルートはOpenshift上で直接作成され、HTTPRoutes、TLSRoute、 BackendTLSPolicy, などの対応するGateway APIリソースは、Vanillaの Kubernetes で作成されます。
プロパティー デフォルト値 値タイプ 必須 説明
エクスポージャー   オブジェクト いいえ アプリケーションサーバーのネットワーク公開設定。

アプリケーションサーバーが、ルートまたはゲートウェイを介して外部にどのように公開されるかを定義します。
exposure.annotations   オブジェクト いいえ アノテーション
exposure.labels   オブジェクト いいえ ラベル
exposure.backendCASecretName   ストリング いいえ BackendCASecretName これは、CA証明書を含むOMSGatewayリソースと同じネームスペースにある Kubernetes のSecretの名前です。このSecretには、ゲートウェイが BackendTLSPolicy を介してバックエンドPodの TLS 証明書を検証するために使用する ca.crt キーが含まれています。
注： 名前空間をまたぐ参照はサポートされていません。 BackendTLSPolicy は、名前空間フィールドを持たない LocalObjectReference を使用しています（Gateway API仕様の制約による）。
exposure.host   ストリング はい DomainName サービスを公開するための名前。
exposure.tls   ストリング はい SecretName これは、フロントエンドの TLS での接続終了に使用される TLS 証明書を含む、 Kubernetes シークレットの名前です。
exposure.gateway   オブジェクト いいえ ゲートウェイ固有の設定。 OpenShiftでは、これは無視されます。
exposure.tls   オブジェクト いいえ TLS 構成
exposure.customDomains   アレイ いいえ 本サービスを公開するために必要な、完全修飾ドメイン名（FQDN）を含むカスタムドメインの一覧。
exposure.customDomains[ ].注釈   オブジェクト いいえ アノテーション
exposure.customDomains[ ].labels   オブジェクト いいえ ラベル
exposure.customDomains[ ].host   ストリング いいえ DomainName サービスを公開するための名前。
exposure.customDomains[ ].tls   ストリング いいえ SecretName これは、フロントエンドの TLS での接続終了に使用される TLS 証明書を含む、 Kubernetes シークレットの名前です。
exposure.customDomains[ ].gateway   オブジェクト いいえ gateway. と同様のゲートウェイ設定。 OpenShiftでは、これは無視されます。
exposure.customDomains[].gateway.gatewayName   ストリング はい GatewayName HTTPRoute をアタッチするための Gateway リソースの名前です <文が不完全なようです>
exposure.customDomains[].gateway.gatewayNamespace   ストリング はい GatewayNamespace は、ゲートウェイの名前空間です。 省略された場合、リソースのネームスペースが使用されます。
exposure.customDomains[].gateway.listenerName   ストリング いいえ ListenerName これは、HTTPRoute を関連付ける Gateway のリスナーセクションです。 指定がない場合、ゲートウェイコントローラが適切なリスナーを選択します。
exposure.customDomains[].gateway.create   オブジェクト いいえ 「作成」は、ゲートウェイがまだ存在しない場合に、オペレーターに対してゲートウェイを作成するよう指示します（任意）。 これは、オペレーターがインフラストラクチャリソースの管理を許可されている環境でのみ使用してください。
exposure.customDomains[].gateway.create.gatewayClassName   ストリング はい GatewayClassName これは、ゲートウェイの作成時に使用される GatewayClass です。
exposure.customDomains[].gateway.create.listeners   アレイ はい 「リスナー」では、ゲートウェイで設定されているリスナーを定義します。 ゲートウェイを作成する際は、少なくとも1つのリスナーを指定する必要があります。
exposure.customDomains[ ]. gateway.create.listeners [].name   ストリング はい Name はリスナーの名前です。 これは HTTPRoute によって参照できます - parentRefs.sectionName。
exposure.customDomains[ ]. gateway.create.listeners [].port   int いいえ Port は、このリスナーによって公開されるネットワークポートです。
exposure.customDomains[ ]. gateway.create.listeners [].protocol     ストリング いいえ

ssl パラメーター

以下の表で、 ingressの ssl パラメーターに適用される属性について説明します。
プロパティー デフォルト値 値タイプ 必須 説明
enabled はい ブール値 いいえ この値を に true 設定すると、インバウンドトラフィックに対して SSL が有効になります。
identitySecretName   ストリング いいえ Ingress またはルートにおける識別情報として使用する、 TLS 証明書を保持するシークレットの名前を指定します。 URL というインジェストまたはルートは、 TLS の証明書をクライアントに提示します。