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

プロパティー説明

brokerCertChainAndKey

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

CertAndKeySecretSource

externalTrafficPolicy

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

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

loadBalancerSourceRanges

クライアントがロードバランサータイプのリスナーに接続できる CIDR 形式による範囲 (例: 10.0.0.0/8130.211.204.1/32) の一覧。プラットフォームでサポートされる場合、ロードバランサー経由のトラフィックは指定された CIDR 範囲に制限されます。このフィールドは、ロードバランサータイプのサービスのみに適用され、クラウドプロバイダーがこの機能をサポートしない場合は無視されます。詳細は「https://v1-17.docs.kubernetes.io/docs/tasks/access-application-cluster/configure-cloud-provider-firewall/」を参照してください。このフィールドは、loadbalancerのリスナーでのみ使用できます。

文字列の配列

bootstrap

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

GenericKafkaListenerConfigurationBootstrap

brokers

ブローカーごとの設定。

GenericKafkaListenerConfigurationBroker アレイ

ipFamilyPolicy

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

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

ipFamilies

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

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

class

使用する Ingress コントローラーを定義する Ingress クラスを設定します。このフィールドは、ingress タイプのリスナーでのみ使用できます。指定されていない場合、デフォルトの Ingress コントローラーが使用されます。

string

finalizers

このリスナーに作成された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

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

integer

maxConnections

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

integer

preferredNodePortAddressType

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

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

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

useServiceDnsDomain

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

boolean