Apache Pulsar 项目教程

1. 项目的目录结构及介绍

Apache Pulsar 是一个开源的分布式消息和流处理平台。项目的目录结构如下：

pulsar/
├── bin/                # 包含启动和管理 Pulsar 的脚本
├── conf/               # 配置文件目录
├── lib/                # 项目依赖的库文件
├── pulsar-broker/      # Pulsar 核心模块
├── pulsar-client/      # 客户端相关模块
├── pulsar-common/      # 通用工具和库
├── pulsar-discovery/   # 服务发现模块
├── pulsar-proxy/       # 代理模块
├── pulsar-websocket/   # WebSocket 支持模块
├── site2/              # 文档和网站相关内容
├── tests/              # 测试代码
└── tools/              # 工具和实用程序

主要目录介绍

• bin/: 包含启动和管理 Pulsar 的脚本，如 pulsar-daemon.sh 和 pulsar-admin.sh。
• conf/: 包含 Pulsar 的配置文件，如 broker.conf 和 standalone.conf。
• lib/: 包含项目依赖的库文件。
• pulsar-broker/: Pulsar 核心模块，负责消息的存储和分发。
• pulsar-client/: 客户端相关模块，提供各种语言的客户端库。
• pulsar-common/: 通用工具和库，包含一些共享的代码和工具类。
• pulsar-discovery/: 服务发现模块，用于发现和管理 Pulsar 集群中的节点。
• pulsar-proxy/: 代理模块，提供一个透明的代理层，用于跨数据中心的消息传递。
• pulsar-websocket/: WebSocket 支持模块，提供基于 WebSocket 的消息传递接口。
• site2/: 文档和网站相关内容，包含项目的文档和网站源码。
• tests/: 测试代码，包含单元测试和集成测试。
• tools/: 工具和实用程序，包含一些管理和监控工具。

2. 项目的启动文件介绍

Pulsar 的启动文件主要位于 bin/ 目录下，以下是一些常用的启动脚本：

• pulsar-daemon.sh: 用于启动和管理 Pulsar 的各种服务，如 Broker、BookKeeper 等。
• pulsar-admin.sh: 用于管理 Pulsar 集群的命令行工具。
• pulsar-client.sh: 用于发送和接收消息的命令行工具。
• pulsar-perf.sh: 用于性能测试的命令行工具。

启动示例

启动 Pulsar Broker：

bin/pulsar-daemon.sh start broker

启动 Pulsar Standalone 模式：

bin/pulsar-daemon.sh start standalone

3. 项目的配置文件介绍

Pulsar 的配置文件位于 conf/ 目录下，以下是一些主要的配置文件：

• broker.conf: Broker 的配置文件，包含 Broker 的各种配置选项，如端口、存储路径等。
• standalone.conf: Standalone 模式的配置文件，用于单机模式的配置。
• bookkeeper.conf: BookKeeper 的配置文件，用于配置 BookKeeper 服务。
• zookeeper.conf: ZooKeeper 的配置文件，用于配置 ZooKeeper 服务。

配置文件示例

以下是 broker.conf 文件的部分配置示例：

# Broker 服务端口
brokerServicePort=6650
# Web 服务端口
webServicePort=8080
# 存储路径
managedLedgerDefaultAckQuorum=2
managedLedgerDefaultEnsembleSize=3
managedLedgerDefaultWriteQuorum=2
# ZooKeeper 地址
zookeeperServers=localhost:2181
# BookKeeper 地址
bookkeeperMetadataServiceUri=zk+hierarchical://localhost:2181/ledgers

通过修改这些配置文件，可以调整 Pulsar 的行为和性能。

---

以上是 Apache Pulsar 项目的目录结构、启动文件和配置文件的介绍。希望这份教程能帮助你更好地理解和使用 Apache Pulsar。