Docker部署单机Pulsar：从零开始的完整指南

一、为什么选择Docker部署单机Pulsar？

Apache Pulsar作为新一代云原生分布式消息系统，以其分层存储、多租户和强一致性等特性在消息中间件领域占据重要地位。对于开发测试环境或小型项目，单机部署能够快速验证功能，而Docker的轻量化特性使其成为理想选择：

• 环境隔离：避免与宿主系统冲突，确保服务纯净运行
• 快速启停：分钟级完成部署，支持随时销毁重建
• 版本可控：通过镜像版本锁定Pulsar运行环境
• 资源优化：相比虚拟机方案，Docker占用资源更少

典型应用场景包括本地开发环境搭建、CI/CD流水线集成测试、以及边缘计算节点的轻量级部署。

二、部署前环境准备

1. 硬件配置要求

• CPU：建议4核以上（生产环境需更高配置）
• 内存：至少8GB（单机测试4GB可运行但性能受限）
• 磁盘：20GB以上可用空间（存储消息数据）
• 网络：确保端口可访问（默认6650/8080）

2. 软件依赖检查

• Docker版本：建议19.03+（支持BuildKit等新特性）

  docker --version
  # 应输出类似：Docker version 20.10.17, build 100c701

• 系统限制调整：

  # Linux系统需调整内存和文件描述符限制
  sudo sysctl -w vm.max_map_count=262144
  sudo sysctl -w fs.file-max=65536

3. 网络端口规划

Pulsar默认使用以下端口，需确保未被占用：

• 6650：Pulsar协议端口（二进制协议）
• 8080：HTTP服务端口（REST API）
• 6651：WebSocket端口（可选）
• 8081：Prometheus监控端口（如启用）

三、Docker部署实战步骤

1. 选择官方镜像

Apache Pulsar官方提供Docker Hub镜像：

docker pull apachepulsar/pulsar:2.11.0

版本选择建议：

• 开发环境：最新稳定版（如2.11.0）
• 生产环境：指定具体版本号确保可复现性

2. 基础单机模式部署

最简部署命令：

docker run -it \
  --name pulsar-standalone \
  -p 6650:6650 \
  -p 8080:8080 \
  apachepulsar/pulsar:2.11.0 \
  bin/pulsar standalone

关键参数说明：

• -it：交互式终端（便于查看日志）
• -p：端口映射（宿主机:容器）
• --name：容器命名便于管理

3. 持久化存储配置

为防止容器重启数据丢失，需挂载卷：

docker run -d \
  --name pulsar-standalone \
  -p 6650:6650 \
  -p 8080:8080 \
  -v $PWD/data:/pulsar/data \
  -v $PWD/conf:/pulsar/conf \
  apachepulsar/pulsar:2.11.0 \
  bin/pulsar standalone

目录说明：

• /pulsar/data：存储消息数据
• /pulsar/conf：自定义配置文件

4. 配置文件优化

创建custom.conf文件（示例）：

# 调整内存分配
bookkeeperClientTimeoutInSeconds=30
brokerDeleteInactiveTopicsEnabled=true
# 启用WebSocket
websocket.enabled=true

通过卷挂载覆盖默认配置：

-v $PWD/custom.conf:/pulsar/conf/standalone.conf

四、服务验证与基础操作

1. 验证服务状态

# 查看容器日志
docker logs -f pulsar-standalone
# 检查端口监听
netstat -tulnp | grep 6650
# 应显示：tcp 0 0 0.0.0.0:6650 0.0.0.0:* LISTEN

2. 使用Pulsar CLI

进入容器执行命令：

docker exec -it pulsar-standalone bash
bin/pulsar-admin topics list public/default
# 应列出默认主题

3. 基础API测试

使用curl测试REST接口：

curl http://localhost:8080/admin/v2/brokers/health
# 应返回：{"healthy":true}

五、生产环境优化建议

1. 资源限制配置

docker run -d \
  --name pulsar-standalone \
  --memory="4g" \
  --cpus="2" \
  ...其他参数...

2. 日志管理方案

建议配置日志轮转：

# 在宿主机创建logrotate配置
/path/to/pulsar/logs/*.log {
    daily
    rotate 7
    compress
    missingok
    notifempty
}

3. 监控集成

通过Prometheus收集指标：

docker run -d \
  --name pulsar-exporter \
  -p 9090:9090 \
  apachepulsar/pulsar-exporter:latest

六、常见问题解决方案

1. 端口冲突处理

错误现象：Bind for 0.0.0.0:6650 failed
解决方案：

# 查找占用端口的进程
sudo lsof -i :6650
# 终止冲突进程或修改Pulsar端口映射

2. 数据目录权限问题

错误现象：Permission denied
解决方案：

# 修改数据目录权限
sudo chown -R 1000:1000 $PWD/data

3. 内存不足优化

现象：容器频繁重启
调整方案：

# 修改JVM参数（通过环境变量）
-e PULSAR_MEM=" -Xms2g -Xmx2g -XX:MaxDirectMemorySize=1g"

七、进阶部署方案

1. 多容器分离部署

# 启动Zookeeper
docker run -d --name zookeeper -p 2181:2181 zookeeper:3.7
# 启动BookKeeper
docker run -d --name bookie \
  -e ZK_SERVERS=zookeeper:2181 \
  apachepulsar/pulsar:2.11.0 \
  bin/bookkeeper bookie
# 启动Broker
docker run -d --name broker \
  -e ZK_SERVERS=zookeeper:2181 \
  -p 6650:6650 \
  apachepulsar/pulsar:2.11.0 \
  bin/pulsar broker

2. Docker Compose编排

创建docker-compose.yml：

version: '3'
services:
  zookeeper:
    image: zookeeper:3.7
    ports:
      - "2181:2181"
  pulsar:
    image: apachepulsar/pulsar:2.11.0
    command: bin/pulsar standalone
    ports:
      - "6650:6650"
      - "8080:8080"
    volumes:
      - ./data:/pulsar/data

八、最佳实践总结

1. 版本锁定：始终指定具体镜像版本
2. 资源监控：设置合理的内存限制
3. 数据备份：定期备份/pulsar/data目录
4. 配置管理：使用配置文件覆盖默认参数
5. 日志收集：集成ELK等日志系统

通过Docker部署单机Pulsar，开发者可以在10分钟内完成环境搭建，为后续的集群部署和性能调优奠定基础。建议从单机模式开始熟悉Pulsar的核心机制，再逐步扩展到生产级集群部署。