13.10. GenericKafkaListenerConfiguration 模式属性


Expand
属性属性类型描述

brokerCertChainAndKey

CertAndKeySecretSource

引用保存用于此监听器的证书和私钥对的 Secret。证书可以选择包含整个链。此字段只能与启用了 TLS 加密的监听程序一起使用。

class

string

IngressLoadBalancer 配置特定的类,用于定义使用哪个控制器。如果没有指定,则使用默认控制器。

  • 对于 ingress 侦听器,Operator 使用此属性在 Ingress 资源中设置 ingressClassName 属性。
  • 对于 loadbalancer 侦听器,Operator 使用此属性来设置 Service 资源中的 loadBalancerClass 属性。

仅限 ingressloadbalancer 侦听程序。

externalTrafficPolicy

字符串([本地、集群] 之一)

指定服务是否将外部流量路由到集群范围或节点本地端点:

  • 集群 可能会导致第二个跃点切换到另一节点,并模糊处理客户端源 IP。
  • Local 避免了 LoadBalancerNodeport 类型服务的第二个跃点,并保留客户端源 IP (当基础架构支持时)。

如果未指定,OpenShift 将使用 Cluster 作为默认值。仅限 loadbalancernodeport 侦听程序。

loadBalancerSourceRanges

字符串数组

CIDR 范围列表(如 10.0.0.0/8130.211.204.1/32),客户端可以从中连接到 loadbalancer 侦听程序。如果平台支持,则通过 loadbalancer 的流量将被限制为指定的 CIDR 范围。此字段仅适用于 loadbalancer 类型服务,如果云供应商不支持该功能,则忽略此字段。仅限 loadbalancer 侦听程序。

bootstrap

GenericKafkaListenerConfigurationBootstrap

Bootstrap 配置。

代理(Broker)

GenericKafkaListenerConfigurationBroker 数组

每个代理配置。

ipFamilyPolicy

字符串(一个 [RequireDualStack, SingleStack, PreferDualStack])

指定服务使用的 IP 系列策略。可用选项包括 SingleStackPreferDualStackRequireDualStack

  • SingleStack 用于单个 IP 系列。
  • PreferDualStack 是在双栈配置的集群或单堆栈集群上的单个 IP 系列上的两个 IP 系列。
  • RequireDualStack 失败,除非在配置了双栈的集群中有两个 IP 系列。

如果未指定,OpenShift 将根据服务类型选择默认值。

ipFamilies

字符串(一个或多个 [IPv6, IPv4])数组

指定服务使用的 IP Families。可用选项包括 IPv4IPv6。如果未指定,OpenShift 将根据 ipFamilyPolicy 设置选择默认值。

createBootstrapService

布尔值

是否创建 bootstrap 服务。默认情况下创建 bootstrap 服务(如果未指定),则默认创建。此字段可与 loadbalancer 侦听器一起使用。

finalizers

字符串数组

为此监听程序创建的 LoadBalancer 类型服务配置的终结器列表。如果平台支持,finalizer service.kubernetes.io/load-balancer-cleanup 以确保外部负载均衡器与 service.For more 一起删除,请参阅 https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/#garbage-collecting-load-balancers。仅限 loadbalancer 侦听程序。

useServiceDnsDomain

布尔值

配置 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 自定义。只适用于 internalcluster-ip 侦听程序。

maxConnections

整数

在代理中,我们允许这个监听程序的最大连接数。如果达到限制,则阻止新的连接。

maxConnectionCreationRate

整数

我们随时允许该监听器的最大连接创建率。如果达到限制,则将节流新的连接。

preferredNodePortAddressType

字符串( [ExternalDNS, ExternalIP, Hostname, InternalIP, InternalDNS] 之一)

定义应将哪些地址类型用作节点地址。可用的类型是:ExternalDNS, ExternalIP, InternalDNS, InternalIPHostname。默认情况下,地址按以下顺序使用(使用第一个找到的地址):

  • ExternalDNS
  • ExternalIP
  • InternalDNS
  • InternalIP
  • Hostname

此属性用于选择首选地址类型,首先检查该类型。如果没有为这个地址类型找到地址,则会在默认顺序检查其他类型的。对于 nodeport 侦听程序。

publishNotReadyAddresses

布尔值

配置服务端点是否被视为"就绪",即使 Pod 本身没有。默认值为 false。此字段不能用于 内部监听程序

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat