服务注册与分布式协调 / 系统课时

使用 Docker 运行

使用 Docker 运行

本节用官方 ZooKeeper 容器完成一个可复现的单节点实例:映射客户端端口、把快照与事务日志放进持久卷,并通过环境变量调整基础参数。完成后你可以确认服务模式和端口是否正常,而不是只看容器是否“在运行”。

学习目标

  • 用 Docker 启动一个可访问的 ZooKeeper 单节点实例。
  • 理解 2181 端口、/data、/datalog 与常用环境变量的职责。
  • 用容器内置脚本验证 ZooKeeper 已真正进入服务状态。

准备容器运行条件

先确认 Docker 可用,并避免宿主机的 2181 已被其他进程占用。下面的检查不会修改系统状态。

bash
docker version --format '{{.Server.Version}}'
docker ps --format '{{.Names}} {{.Ports}}'

预期输出

text
<VERSION>
<CONTAINER_NAME>    <PORT_MAPPING>

第一行应返回 Docker Server 版本;第二行可能为空。若已有容器映射 0.0.0.0:2181->2181/tcp,应先停止该容器,或在本课示例中改用其他宿主机端口,例如 -p 22181:2181。

启动单节点实例

下面创建两个命名卷,并启动名为 zk 的容器。/data 保存快照和运行数据,/datalog 保存事务日志;把它们独立挂载,删除并重建容器时仍可复用数据。

bash
docker volume create zk-data
docker volume create zk-datalog

docker run -d \
  --name zk \
  --restart unless-stopped \
  -p 2181:2181 \
  -e ZOO_TICK_TIME=2000 \
  -e ZOO_INIT_LIMIT=10 \
  -e ZOO_SYNC_LIMIT=5 \
  -v zk-data:/data \
  -v zk-datalog:/datalog \
  zookeeper:3.9

预期输出

text
zk-data
zk-datalog
<ID>

<ID> 是容器 ID,实际值每次不同。示例使用 zookeeper:3.9 便于快速练习;生产环境应固定到经过验证的补丁版本或镜像摘要,避免后续拉取到未评估的新镜像。

看懂端口、数据卷和环境变量

-p 2181:2181 把宿主机 2181 映射到容器的客户端端口,因此宿主机程序可连接 127.0.0.1:2181。若只允许同机访问,可改成 -p 127.0.0.1:2181:2181,减少不必要的网络暴露。

ZOO_TICK_TIME 是 ZooKeeper 的基础时间单位;ZOO_INIT_LIMIT 和 ZOO_SYNC_LIMIT 主要影响集群成员之间的初始化与同步容忍窗口。单节点实验中它们通常不是瓶颈,但通过环境变量显式给出,可以让容器配置更容易审阅和复现。

验证 ZooKeeper 而不是只看容器状态

容器处于 Up 只能说明主进程还没退出。继续调用 ZooKeeper 自带的状态脚本,确认服务真正启动并识别为单节点模式。

bash
docker exec zk sh -lc 'zkServer.sh status 2>&1 | grep "Mode:"'

预期输出

text
Mode: standalone

如果没有出现该行,先查看最近日志:

bash
docker logs --tail 50 zk

预期结果是能看到 ZooKeeper 完成配置加载并监听客户端端口的日志;时间戳、线程名和具体日志格式会随镜像版本变化。若日志出现端口绑定失败、数据目录不可写或配置解析错误,应先修复对应问题再重启容器。

重建容器时保留数据

命名卷的生命周期独立于容器。执行 docker rm -f zk 只会删除容器,不会自动删除 zk-data 和 zk-datalog;用相同挂载重新创建容器即可继续使用原数据。只有明确不再需要数据时,才执行 docker volume rm。

这种运行方式适合本地学习、接口联调和单节点验证。真正的多节点 ZooKeeper 还需要为每个成员设置唯一服务器 ID、成员地址和独立存储,不应把单节点容器配置直接当作生产集群方案。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Docker 运行

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通