Docker部署Zookeeper官方镜像 - 保姆级教程

1. 准备工作

在开始之前，请确保： - 已安装Docker（建议使用最新稳定版） - 系统内存至少2GB（Zookeeper运行需要一定内存） - 熟悉基本的Docker命令

2. 拉取官方镜像

docker pull zookeeper:latest

建议使用特定版本而非latest标签以获得更稳定的体验：

docker pull zookeeper:3.8.0

3. 单机模式部署

3.1 快速启动

docker run --name my-zookeeper -p 2181:2181 -d zookeeper

3.2 带持久化存储的启动

docker run --name my-zookeeper \
  -p 2181:2181 \
  -v /my/own/data:/data \
  -v /my/own/datalog:/datalog \
  -e ZOO_DATA_DIR=/data \
  -e ZOO_DATA_LOG_DIR=/datalog \
  -d zookeeper

4. 集群模式部署

4.1 使用Docker Compose部署集群

创建docker-compose.yml文件：

version: '3.1'

services:
  zoo1:
    image: zookeeper
    restart: always
    hostname: zoo1
    ports:
      - 2181:2181
    environment:
      ZOO_MY_ID: 1
      ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181

  zoo2:
    image: zookeeper
    restart: always
    hostname: zoo2
    ports:
      - 2182:2181
    environment:
      ZOO_MY_ID: 2
      ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181

  zoo3:
    image: zookeeper
    restart: always
    hostname: zoo3
    ports:
      - 2183:2181
    environment:
      ZOO_MY_ID: 3
      ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181

启动集群：

docker-compose up -d

4.2 验证集群状态

# 进入任意一个节点
docker exec -it zoo1 bash

# 在容器内执行
zkServer.sh status

5. 常用配置选项

通过环境变量可以配置Zookeeper：

示例配置：

docker run --name my-zookeeper \
  -p 2181:2181 \
  -e ZOO_TICK_TIME=2000 \
  -e ZOO_INIT_LIMIT=10 \
  -e ZOO_MAX_CLIENT_CNXNS=100 \
  -d zookeeper

6. 数据持久化

强烈建议将数据目录挂载到宿主机：

docker run --name my-zookeeper \
  -p 2181:2181 \
  -v /path/to/data:/data \
  -v /path/to/datalog:/datalog \
  -d zookeeper

7. 常用操作命令

7.1 进入Zookeeper CLI

docker exec -it my-zookeeper zkCli.sh

7.2 查看日志

docker logs my-zookeeper

7.3 重启容器

docker restart my-zookeeper

8. 安全配置

8.1 添加认证

docker run --name my-zookeeper \
  -p 2181:2181 \
  -e ZOO_4LW_COMMANDS_WHITELIST="srvr, mntr, stat, ruok, conf" \
  -e ZOO_CFG_EXTRA="authProvider.1=org.apache.zookeeper.server.auth.SASLAuthenticationProvider" \
  -d zookeeper

8.2 限制网络访问

docker run --name my-zookeeper \
  -p 127.0.0.1:2181:2181 \
  -d zookeeper

9. 监控与管理

9.1 使用四字命令

echo stat | nc localhost 2181

常用四字命令： - stat - 显示服务器状态 - srvr - 服务器详细信息 - cons - 客户端连接信息 - mntr - 监控统计信息

9.2 使用AdminServer

Zookeeper默认启用AdminServer（端口8080），可以通过以下方式访问：

curl http://localhost:8080/commands/stat

10. 常见问题解决

10.1 连接被拒绝

检查： - 容器是否正常运行：docker ps - 端口是否正确映射 - 防火墙设置

10.2 集群无法形成

检查： - 所有节点的ZOO_MY_ID是否唯一 - ZOO_SERVERS配置是否正确 - 网络是否互通

10.3 数据损坏

恢复步骤： 1. 停止Zookeeper 2. 从备份恢复数据 3. 启动Zookeeper

11. 备份与恢复

11.1 备份数据

# 停止容器
docker stop my-zookeeper

# 备份数据目录
tar -czvf zk-backup.tar.gz /path/to/data /path/to/datalog

# 启动容器
docker start my-zookeeper

11.2 恢复数据

# 停止容器
docker stop my-zookeeper

# 恢复数据
tar -xzvf zk-backup.tar.gz -C /

# 启动容器
docker start my-zookeeper

12. 最佳实践

1. 生产环境使用集群模式：至少3个节点
2. 监控Zookeeper：使用Prometheus + Grafana
3. 定期备份：特别是重要数据
4. 资源限制：为容器设置内存限制 bash docker run --name my-zookeeper -p 2181:2181 --memory 1g -d zookeeper
5. 日志轮转：配置日志大小限制

通过以上步骤，您应该能够成功在Docker中部署和管理Zookeeper服务。根据实际需求调整配置参数，以获得最佳性能和稳定性。