ZooKeeper单机部署及集群(单机伪集群)部署指南

一、引言

ZooKeeper是一个开源的分布式协调服务，广泛应用于分布式系统中，用于解决分布式环境下的数据一致性和同步问题。无论是单机部署用于开发测试，还是集群部署用于生产环境，ZooKeeper都提供了可靠的解决方案。本文将详细介绍ZooKeeper的单机部署和集群（单机伪集群）部署方法，帮助开发者快速上手。

二、环境准备

在开始部署之前，需要准备以下环境：

• 操作系统：推荐使用Linux系统（如CentOS 7/8或Ubuntu 20.04）。
• Java环境：ZooKeeper需要Java运行环境，建议安装OpenJDK 8或更高版本。
• 网络环境：确保服务器之间网络互通，防火墙允许ZooKeeper端口通信（默认2181）。
• 下载ZooKeeper：从Apache官网下载最新稳定版本的ZooKeeper（如3.7.0）。

三、ZooKeeper单机部署

1. 解压安装包

将下载的ZooKeeper安装包解压到指定目录，例如：

tar -zxvf apache-zookeeper-3.7.0-bin.tar.gz -C /opt/
cd /opt/apache-zookeeper-3.7.0-bin/

2. 配置zoo.cfg

ZooKeeper的配置文件为conf/zoo.cfg。默认情况下，该文件可能不存在，需要从conf/zoo_sample.cfg复制并修改：

cp conf/zoo_sample.cfg conf/zoo.cfg

编辑zoo.cfg，修改以下关键参数：

# 数据目录
dataDir=/var/lib/zookeeper
# 客户端连接端口
clientPort=2181
# 日志目录（可选）
dataLogDir=/var/log/zookeeper

3. 创建数据目录

根据配置文件中的dataDir，创建对应的目录并初始化myid文件（单机模式下myid为1）：

mkdir -p /var/lib/zookeeper
echo "1" > /var/lib/zookeeper/myid

4. 启动ZooKeeper

使用以下命令启动ZooKeeper：

bin/zkServer.sh start

验证启动是否成功：

bin/zkServer.sh status

输出Mode: standalone表示单机模式启动成功。

四、ZooKeeper集群（单机伪集群）部署

单机伪集群是指在同一台物理机上模拟多个ZooKeeper节点，适用于开发和测试环境。

1. 创建多个数据目录

为每个节点创建独立的数据目录和日志目录（例如3个节点）：

mkdir -p /var/lib/zookeeper/{1,2,3}
mkdir -p /var/log/zookeeper/{1,2,3}
echo "1" > /var/lib/zookeeper/1/myid
echo "2" > /var/lib/zookeeper/2/myid
echo "3" > /var/lib/zookeeper/3/myid

2. 配置zoo.cfg

编辑conf/zoo.cfg，添加以下内容：

# 通用配置
tickTime=2000
initLimit=10
syncLimit=5
dataDir=/var/lib/zookeeper/1
dataLogDir=/var/log/zookeeper/1
clientPort=2181
# 集群节点配置
server.1=localhost:2888:3888
server.2=localhost:2889:3889
server.3=localhost:2890:3890

复制zoo.cfg为zoo1.cfg、zoo2.cfg和zoo3.cfg，并分别修改dataDir、dataLogDir和clientPort：

• zoo1.cfg：dataDir=/var/lib/zookeeper/1，clientPort=2181
• zoo2.cfg：dataDir=/var/lib/zookeeper/2，clientPort=2182
• zoo3.cfg：dataDir=/var/lib/zookeeper/3，clientPort=2183

3. 启动多个节点

分别使用不同的配置文件启动三个节点：

bin/zkServer.sh start-foreground conf/zoo1.cfg
bin/zkServer.sh start-foreground conf/zoo2.cfg
bin/zkServer.sh start-foreground conf/zoo3.cfg

或后台启动：

bin/zkServer.sh start conf/zoo1.cfg
bin/zkServer.sh start conf/zoo2.cfg
bin/zkServer.sh start conf/zoo3.cfg

4. 验证集群状态

使用zkCli.sh连接任意一个节点，查看集群状态：

bin/zkCli.sh -server localhost:2181
# 在zkCli中执行
ls /

输出应包含ZooKeeper的根目录结构。

五、常见问题与解决

1. 端口冲突

确保每个节点的clientPort、server.x中的端口（2888/3888）未被占用。

2. 数据目录权限

确保ZooKeeper进程对数据目录和日志目录有读写权限：

chown -R zookeeper:zookeeper /var/lib/zookeeper /var/log/zookeeper

3. 防火墙设置

如果使用远程连接，确保防火墙允许ZooKeeper端口通信：

firewall-cmd --add-port={2181,2888,3888}/tcp --permanent
firewall-cmd --reload

六、总结

本文详细介绍了ZooKeeper的单机部署和集群（单机伪集群）部署方法。单机部署适用于开发和测试环境，而集群部署则适用于生产环境，提供高可用性和容错能力。通过本文的指导，开发者可以快速完成ZooKeeper的部署，并验证其正常运行。无论是单机还是集群模式，ZooKeeper都能为分布式系统提供可靠的协调服务。