Pulsar 管理
目录
1. Pulsar 管理客户端
在 Pulsar 管理方面,Spring Boot 自动配置提供了一个 PulsarAdministration 来管理 Pulsar 集群。该管理组件实现了名为 PulsarAdminOperations 的接口,并提供 createOrModify 方法以通过其契约处理 topic 管理。
当你使用 Pulsar Spring Boot starter 时,会得到自动配置的 PulsarAdministration。
默认情况下,应用程序尝试连接位于 http://localhost:8080 的本地 Pulsar 实例。可以通过将 spring.pulsar.admin.service-url 属性设置为 (http|https)://<host>:<port> 形式的其他值来调整。
有许多应用属性可用于配置客户端。请参阅 spring.pulsar.admin.* 应用属性。
1.1. 认证
访问需要认证的 Pulsar 集群时,admin 客户端需要与常规 Pulsar 客户端相同的安全配置。你可以使用前述安全配置,只需将 spring.pulsar.client 替换为 spring.pulsar.admin。
2. 自动创建 topic
在初始化时,PulsarAdministration 会检查应用程序上下文中是否存在任何 PulsarTopic bean。对于所有此类 bean,PulsarAdministration 会创建相应的 topic,或在必要时修改分区数。
以下示例展示了如何添加 PulsarTopic bean,以让 PulsarAdministration 为你自动创建 topic:
@Bean
PulsarTopic simpleTopic(PulsarTopicBuilder topicBuilder) {
// This will create a non-partitioned persistent topic in the 'public/default' tenant/namespace
return topicBuilder.name("my-topic").build();
}
@Bean
PulsarTopic partitionedTopic(PulsarTopicBuilder topicBuilder) {
// This will create a persistent topic with 3 partitions in the provided tenant and namespace
return topicBuilder
.name("persistent://my-tenant/my-namespace/partitioned-topic")
.numberOfPartitions(3)
.build();
}
使用 Spring Boot 时,PulsarTopicBuilder 是一个已注册的 bean,并以 domain、tenant 和 namespace 的默认值进行配置。你只需在需要处注入该 builder 即可。否则,直接使用 PulsarTopicBuilder 的某个构造函数。