服务注册与分布式协调 / 系统课时
命令行客户端入门
命令行客户端入门
本节用 zkCli.sh 直接连接 ZooKeeper,完成一个持久节点从创建、读取、修改到删除的完整闭环。跟做结束后,你能独立验证服务是否可连接,并理解常用命令对 znode 数据与版本的影响。
学习目标
- 使用
zkCli.sh连接指定 ZooKeeper 服务并确认会话状态。 - 使用
create、get、set、delete完成节点基本 CRUD。 - 根据路径、子节点和版本信息判断常见操作失败原因。
连接 zkCli
进入 ZooKeeper 安装目录后,通过 -server 指定客户端地址。单机环境常用 127.0.0.1:2181;集群环境也可以提供逗号分隔的多个地址,让客户端在可用成员之间建立会话。
bin/zkCli.sh -server 127.0.0.1:2181预期输出
Welcome to ZooKeeper!
[zk: 127.0.0.1:2181(CONNECTED) 0]实际启动日志、会话 ID 和提示符编号可能不同;关键是提示符出现 CONNECTED。如果一直停在 CONNECTING,优先检查服务进程、客户端端口和网络可达性。
完成节点 CRUD
ZooKeeper 的数据存放在 znode 上,路径从 / 开始。下面使用 /demo 做一次完整操作;create 默认创建持久节点,节点数据以字节序列保存,CLI 示例中直接使用字符串最直观。
create /demo "v1"
get /demo
set /demo "v2"
get /demo
delete /demo
get /demo预期输出
Created /demo
v1
v2
Node does not exist: /demoset 和 delete 成功时通常不需要额外业务输出,因此用后续 get 验证结果。最后一次读取报 Node does not exist,正好证明删除已经生效。
读取状态与版本
排查更新冲突时,不要只看节点数据。get -s 会同时显示 stat 信息,其中 dataVersion 每次成功修改数据后递增,可用于带版本的条件更新。
create /versioned "a"
get -s /versioned
set -v 0 /versioned "b"
get -s /versioned预期输出
a
cZxid = <ID>
...
dataVersion = 0
...
b
cZxid = <ID>
...
dataVersion = 1
...ctime、mtime、zxid 等动态值会因环境不同而变化;这里用 <ID> 和省略号表示未固定的元数据。关键是第一次读取版本为 0,条件更新成功后数据变为 b 且版本递增到 1。
处理常见失败
创建子节点前,父路径必须已经存在;create /a/b 不会自动补建 /a。删除节点时也要求目标没有子节点,否则会收到 Node not empty。需要递归清理测试树时可使用 deleteall,但它会删除整棵子树,不应对不确定路径直接执行。
如果收到 Node already exists,先用 get 或 ls 确认现有节点是否就是你要操作的对象;如果收到 NoAuth,说明 ACL 不允许当前会话执行该操作。基础 CRUD 的正确习惯是每次写入后立即读取验证,再继续下一步,而不是只根据命令是否报错判断结果。