2.47. Kubernetes


对 Kubernetes API 执行操作

2.47.1. Maven 协调

在 code.quarkus.redhat.com 上使用此扩展创建一个新项目

或者将协调添加到现有项目中:

<dependency>
    <groupId>org.apache.camel.quarkus</groupId>
    <artifactId>camel-quarkus-kubernetes</artifactId>
</dependency>

2.47.2. 其他 Camel Quarkus 配置

重要

在这个 Camel Extensions for Quarkus 发行版本中,只有将 camel-quarkus-master 扩展用作集群服务时,才支持 camel-quarkus-kubernetes 扩展。另外,为了支持 camel-quarkus-kubernetes 扩展,您必须在应用程序中明确添加对 quarkus-openshift-client 扩展的依赖项。

2.47.2.1. 自动注册 Kubernetes 客户端实例

扩展会自动注册名为 kubernetesClient 的 Kubernetes 客户端 Bean。您可以在路由中引用 bean,如下所示:

from("direct:pods")
    .to("kubernetes-pods:///?kubernetesClient=#kubernetesClient&operation=listPods")

默认情况下,客户端从本地 kubeconfig 文件中配置。您可以通过 application.properties 中的属性自定义客户端配置:

quarkus.kubernetes-client.master-url=https://my.k8s.host
quarkus.kubernetes-client.namespace=my-namespace

完整的配置选项包括在 Quarkus Kubernetes 客户端指南 中。

2.47.2.2. 在从给定端点消耗的集群中只有一个使用者

当将同一路由部署到多个 pod 时,最好将这个扩展与 Master 结合使用。在这种情况下,单个消费者将在整个 camel master 命名空间间处于活跃状态。

例如,在多个 pod 上部署了以下路由:

from("master:ns:timer:test?period=100").log("Timer invoked on a single pod at a time");

可使用类似如下的属性启用 kubernetes 集群服务:

quarkus.camel.cluster.kubernetes.enabled = true

因此,单个消费者将在 ns camel master 命名空间中激活。这意味着,在一个给定时间,只有一个计时器将在整个集群中生成交换。换句话说,在某个时间点上,消息将在单个 pod 上每 100ms 进行一次日志记录。

kubernetes 集群服务可以通过调整 quarkus.camel.cluster.kubernetes the 属性来 进一步调整。

配置属性类型默认

lock quarkus.camel.cluster.kubernetes.enabled

Kubernetes 集群服务是否应根据 'quarkus.camel.cluster.kubernetes.*' 配置自动配置。

布尔值

false

lock quarkus.camel.cluster.kubernetes-id

集群服务 ID (默认为 null)。

字符串

 

lock quarkus.camel.cluster.kubernetes.master-url

Kubernetes master 的 URL (默认为 Kubernetes 客户端属性读取)。

字符串

 

lock quarkus.camel.cluster.kubernetes.connection-timeout-millis

向 Kubernetes API 服务器发出请求时使用的连接超时(毫秒)。

java.lang.Integer

 

lock quarkus.camel.cluster.kubernetes.namespace

包含 pod 和 configmap 的 Kubernetes 命名空间的名称(默认自动检测到)。

字符串

 

lock quarkus.camel.cluster.kubernetes.pod-name

当前 pod 的名称(默认为从容器主机名中检测)。

字符串

 

lock quarkus.camel.cluster.kubernetes.jitter-factor

要应用 jitter 因素,以防止所有 pod 在同一即时调用 Kubernetes API (默认为 1.2)。

java.lang.Double

 

lock quarkus.camel.cluster.kubernetes.lease-duration-millis

当前领导领导租期的默认持续时间(默认为 15000)。

java.lang.Long

 

lock quarkus.camel.cluster.kubernetes.renew-deadline-millis

领导必须停止其服务的截止时间,因为它可能会丢失领导权(默认为 10000)。

java.lang.Long

 

lock quarkus.camel.cluster.kubernetes.retry-period-millis

连续两次尝试检查并获取领导权利之间的时间。它利用 jitter 因子(默认为 2000)进行自定义。

java.lang.Long

 

lock quarkus.camel.cluster.kubernetes-order

服务查找顺序/优先级(默认为 2147482647)。

java.lang.Integer

 

lock quarkus.camel.cluster.kubernetes.resource-name

用于进行优化锁定的租期资源的名称(默认为"leaders")。当底层 Kubernetes 资源可以管理单个锁定时,资源名称用作前缀。

字符串

 

lock quarkus.camel.cluster.kubernetes.lease-resource-type

Kubernetes 中使用的租期资源类型,可以是 'config-map' 或 'lease'(默认为 'lease')。

org.apache.camel.component.kubernetes.cluster.LeaseResourceType

 

lock quarkus.camel.cluster.kubernetes.rebalancing

camel master 命名空间领导是否应在集群中的所有 camel 上下文中平均分配。

布尔值

true

lock quarkus.camel.cluster.kubernetes-labels

用于识别组成集群的 pod 的键/值,默认为空映射。

Map<String,String>

 

lock 构建时修复的配置属性。所有其他配置属性可在运行时覆盖。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.