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


Expand
プロパティープロパティータイプ説明

brokerCertChainAndKey

CertAndKeySecretSource

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

class

string

使用するコントローラーを定義する Ingress および LoadBalancer の特定のクラスを設定します。指定しない場合、デフォルトのコントローラーが使用されます。

  • ingress リスナーの場合、Operator がこのプロパティーを使用して、ingress リソースの ingressClassName プロパティーを設定します。
  • loadbalancer リスナーの場合、Operator がこのプロパティーを使用して、Service リソースの loadBalancerClass プロパティーを設定します。

ingress および loadbalancer リスナーでのみ使用されます。

externalTrafficPolicy

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

サービスで外部トラフィックをクラスター全体のエンドポイントにルーティングするか、ノードのローカルのエンドポイントにルーティングするかを指定します。

  • Cluster を指定すると、別のノードへの 2 回目のホップが発生し、クライアントソースの IP が特定しにくくなる可能性があります。
  • Local を指定すると、LoadBalancer および Nodeport タイプのサービスに対して 2 回目のホップが発生しないようにし、クライアントソースの IP を維持します (インフラストラクチャーでサポートされる場合)。

指定されていない場合、OpenShift では Cluster がデフォルトとして使用されます。loadbalancer または nodeport リスナーでのみ使用されます。

loadBalancerSourceRanges

string 配列

クライアントがロードバランサーリスナーに接続する際に使用できる接続元の 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 を指定します。利用可能なオプションは、SingleStackPreferDualStackRequireDualStack です。

  • SingleStack は単一の IP ファミリー用です。
  • PreferDualStack は、デュアルスタック設定のクラスターでは 2 つの IP ファミリーを、シングルスタック設定のクラスターでは 1 つの IP ファミリーを対象としています。
  • RequireDualStack は、デュアルスタック設定のクラスターに 2 つの IP ファミリーがないと失敗します。

指定されていない場合、OpenShift はサービスタイプに基づいてデフォルト値を選択します。

ipFamilies

string ([IPv6、IPv4] のうち 1 つ以上) 配列

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

createBootstrapService

boolean

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

finalizers

string 配列

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

useServiceDnsDomain

boolean

生成されるアドレスに OpenShift サービス DNS ドメインを含めるかどうかを設定します。

  • false に設定すると、生成されるアドレスにはサービス DNS ドメイン接尾辞が含まれません。たとえば、my-cluster-kafka-0.my-cluster-kafka-brokers.myproject.svc です。
  • true に設定すると、生成されるアドレスにサービス DNS ドメイン接尾辞が含まれます。たとえば、my-cluster-kafka-0.my-cluster-kafka-brokers.myproject.svc.cluster.local です。

デフォルトは .cluster.local です。ただし、環境変数 KUBERNETES_SERVICE_DNS_DOMAIN を使用してカスタマイズできます。internal および cluster-ip リスナーでのみ使用されます。

maxConnections

integer

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

maxConnectionCreationRate

integer

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

preferredNodePortAddressType

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

ノードアドレスとして使用するアドレスタイプを定義します。使用可能なタイプは、ExternalDNSExternalIPInternalDNSInternalIP、および Hostname です。デフォルトでは、アドレスは次の順序で使用されます (最初に検出されたアドレスが使用されます)。

  • ExternalDNS
  • ExternalIP
  • InternalDNS
  • InternalIP
  • Hostname

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

publishNotReadyAddresses

boolean

Pod 自体が準備完了でなくても、サービスエンドポイントが "準備完了" であるとみなすかどうかを設定します。デフォルトは false です。このフィールドは internal リスナーでは使用できません。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat