13.7. GenericKafkaListenerConfiguration スキーマプロパティー

brokerCertChainAndKey

CertAndKeySecretSource

このリスナーに使用される証明書とプライベートキーのペアを保持する Secret への参照。証明書には、任意でチェーン全体を含めることができます。このフィールドは、TLS による暗号化が有効なリスナーでのみ使用できます。

externalTrafficPolicy

string ([Local、Cluster] のいずれか)

サービスによって外部トラフィックがローカルノードのエンドポイントまたはクラスター全体のエンドポイントにルーティングされるかどうかを指定します。Cluster を指定すると、別のノードへの 2 回目のホップが発生し、クライアントソースの IP が特定しにくくなる可能性があります。Local を指定すると、LoadBalancer および Nodeport タイプのサービスに対して 2 回目のホップが発生しないようにし、クライアントソースの IP を維持します (インフラストラクチャーでサポートされる場合)。指定のない場合、OpenShift は Cluster をデフォルトとして使用します。このフィールドは、loadbalancer または nodeport タイプリスナーとのみ使用できます。

loadBalancerSourceRanges

string array

クライアントがロードバランサータイプのリスナーに接続できる CIDR 形式による範囲 (例: 10.0.0.0/8、130.211.204.1/32) のリスト。プラットフォームでサポートされる場合、ロードバランサー経由のトラフィックは指定された CIDR 範囲に制限されます。このフィールドは、ロードバランサータイプのサービスのみに適用され、クラウドプロバイダーがこの機能をサポートしない場合は無視されます。このフィールドは、loadbalancer のリスナーでのみ使用できます。

bootstrap

GenericKafkaListenerConfigurationBootstrap

ブートストラップの設定。

brokers

GenericKafkaListenerConfigurationBroker アレイ

ブローカーごとの設定。

ipFamilyPolicy

string ([RequireDualStack、SingleStack、PreferDualStack] のいずれか)

サービスによって使用される IP Family Policy を指定します。利用可能なオプションは、SingleStack、PreferDualStack、RequireDualStack です。SingleStack は単一の IP ファミリー用です。PreferDualStack は、デュアルスタック設定のクラスターでは 2 つの IP ファミリーを、シングルスタック設定のクラスターでは 1 つの IP ファミリーを対象としています。RequireDualStack は、デュアルスタック設定のクラスターに 2 つの IP ファミリーがないと失敗します。指定されていない場合、OpenShift はサービスタイプに基づいてデフォルト値を選択します。

ipFamilies

string ([IPv6, IPv4] の 1 つ以上) array

サービスによって使用される IP Families を指定します。利用可能なオプションは、IPv4 と IPv6 です。指定されていない場合、OpenShift は ipFamilyPolicy の設定に基づいてデフォルト値を選択します。

createBootstrapService

boolean

ブートストラップサービスを作成するかどうか。ブートストラップサービスはデフォルトで作成されます (指定されない場合)。このフィールドは、loadBalancer タイプリスナーと併用できます。

class

string

使用するコントローラーを定義する Ingress および LoadBalancer の特定のクラスを設定します。このフィールドは、ingress および loadbalancer タイプのリスナーでのみ使用できます。指定しない場合、デフォルトのコントローラーが使用されます。Ingress リスナーの場合、Ingress リソースで ingressClassName プロパティーを設定します。loadbalancer リスナーの場合は、Service リソースで loadBalancerClass プロパティーを設定します。

finalizers

string array

このリスナーに作成された LoadBalancer タイプの Services に設定されるファイナライザーのリストです。プラットフォームでサポートされている場合は、ファイナライザー service.kubernetes.io/load-balancer-cleanup を使用して、外部ロードバランサーがサービスと一緒に削除されるようにします。詳細は、https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/#garbage-collecting-load-balancers を参照してください。このフィールドは、loadbalancer タイプのリスナーでのみ使用できます。

maxConnectionCreationRate

integer

このリスナーでいつでも許可される最大接続作成率。制限に達すると、新しい接続はスロットリングされます。

maxConnections

integer

ブローカーのこのリスナーでいつでも許可される最大接続数。制限に達すると、新しい接続はブロックされます。

preferredNodePortAddressType

string ([ExternalDNS、ExternalIP、Hostname、InternalIP、InternalDNS] のいずれか)

ノードアドレスとして使用するアドレスタイプを定義します。使用できるタイプ: ExternalDNS、ExternalIP、InternalDNS、InternalIP、Hostnameデフォルトでは、アドレスは以下の順序で使用されます (最初に見つかったアドレスが使用されます):

このフィールドは、最初にチェックされる優先アドレスタイプの選択に使用されます。このアドレスタイプのアドレスが見つからない場合、他のタイプがデフォルトの順序でチェックされます。このフィールドは、nodeport タイプのリスナーでのみ使用できます。

useServiceDnsDomain

boolean

OpenShift サービス DNS ドメインを使用するべきかどうかを設定します。true に設定すると、生成されるアドレスにはサービスの DNS ドメインの接尾辞が含まれます (デフォルトでは .cluster.local、環境変数 KUBERNETES_SERVICE_DNS_DOMAIN で設定可能です)。デフォルトは false です。このフィールドは、internal および cluster-ip タイプのリスナーでのみ使用できます。