zkCli 是 zookeeper 原生的与 zk服务群连接的客户端的程序。
1.如何使用zkCli,sh 连接server 与参数
2.zkCli 下的增删查改指令 与 配额 quota
1.如何使用zkCli,sh 连接server 与参数
可选的参数:
./zkCli.sh
-timeout 以ms作为统计单位
-r 只读模式, 当半数zk节点down,此时对zk集群不能操作。如果加上这个参数,能连接上集群,对zk集群进行操作(只读)读取数据。
经测试:集群工作状态正常的时候,也可以加上这个参数连接zookeeper集群。此时可以对zk集群进行操作。
-server ip:port 连接zookeeper, 用于连接远程的zookeeper.
一个连接示例:
zkCli.sh -r -timeout 2000 -server 10.202.4.22:2181
一些基础指令:
退出 zkCli 客户端
quit
帮助指令
h
2.zkCli 下的增删查改指令 与 配额 quota
查询 节点与数据
ls path [watch]
get path [watch]
stat path [watch]
ls2 path [watch]
ls path [watch] :查询指定路径下的子节点
示例:
ls /
get path [watch] : 查询指定节点中的数据,如果节点中有数据
示例:
get /test/username
stat path [watch] : 查询指定节点的一些描述信息
示例:
stat /test
cZxid = 0x20f //创建的事务id
ctime = Sat Nov 05 14:46:03 CST 2016 //创建的时间
mZxid = 0x20f //最后一次修改的事务id
mtime = Sat Nov 05 14:46:03 CST 2016 //最后一次修改的时间
pZxid = 0x22e
cversion = 9
dataVersion = 0 //数据的版本,每当数据被修改一次,版本号就会被加1
aclVersion = 0
ephemeralOwner = 0x0 //
dataLength = 6 //该节点存储的数据 的数据长度
numChildren = 3 //该节点下面有几个子节点
ls2 path [watch] : 相当于 ls 与 stat 指令的合成的效果
==============================
增加 节点与数据
创建有根路径的节点的时候,要确保上一层的节点要存在,否则会报错
create [-s] [-e] path data acl
create [-s] [-e] path data acl
-s: sequence 模式, 创建后会生成原节点+序列号的节点,再次执行相同命令会产生序列号加1的节点。
-e: 临时节点与数据, 关闭连接后数据就会被删除。
data 节点中存放的数据
acl 控制权限, 具体请参看其他文章
示例:
先创建节点,在查询节点中的内容。
create /test2 111
get /test2
-s , 创建序列节点
create -s /test2/seq 000 执行多次,注意 value 值一定要提供
===================
修改 节点与数据
set path data [version]
version : 可选, 默认设置为 stat 该节点的版本, 若强制加上则应设置为stat 该节点查询到的版本,
否则会报错
设置数据,注意其中的版本号 与数据变化
get /test2/node
set /test2/node 13
get /test2/node
=====================================
删除 节点与数据
rmr path
delete path [version]
delete path [version] :删除节点,确保该节点下面没有节点否则会报错。
示例:
节点下面有节点,不能删除
delete /test2
节点下面不存在子节点, 可以删除
ls /test2
delete /test2/node
ls /test2
rmr path :递归删除该节点 与 该节点的子节点。
示例:
rmr /test2
==========================
配额 quota
配额机制
zookeeper 的配额机制可以设置两种配额。
-n 设置子节点的数量,包括其自身。
-b 节点中数据的长度。
对于超出配额,系统不会导致插入或者修改不成功,但是会在 zookeeper.out 中生成错误日志。
增加配额
setquota -n|-b val path
-n 设置子节点的配额数量
-b 设置节点内容的长度
查询配额
listquota path
-1 表示无限, 即没有限制
删除配额
delquota [-n|-b] path
注意配额一旦设置完成,只能删除了重新设置,setquota 不能重置配额
示例:
0.tail -f zookeeper.out 跟踪日志
1.设置配额
2.查询配额
3.设置超过配额的数量
4.查看日志的报错
指令:
日志
==============================
其他指令
历史指令
history //显示历史的执行指令
redo cmdno //重新执行某条指令
示例:
连接指令
connect host:port //连接到一台远程的zk上
close
示例:
ZK的节点有5种操作权限:
CREATE、READ、WRITE、DELETE、ADMIN 也就是 增、删、改、查、管理权限,这5种权限简写为crwda(即:每个单词的首字符缩写)
注:这5种权限中,delete是指对子节点的删除权限,其它4种权限指对自身节点的操作权限
身份的认证有4种方式:
world:默认方式,相当于全世界都能访问
auth:代表已经认证通过的用户(cli中可以通过addauth digest user:pwd 来添加当前上下文中的授权用户)
digest:即用户名:密码这种方式认证,这也是业务系统中最常用的
ip:使用Ip地址认证
设置访问控制:
方式一:(推荐)
1)增加一个认证用户
addauth digest 用户名:密码明文
eg. addauth digest user1:password1
2)设置权限
setAcl /path auth:用户名:密码明文:权限
eg. setAcl /test auth:user1:password1:cdrwa
3)查看Acl设置
getAcl /path
方式二:
setAcl /path digest:用户名:密码密文:权限
注:这里的加密规则是SHA1加密,然后base64编码。
参考:
2、http://zookeeper.apache.org/doc/r3.1.2/zookeeperProgrammers.html
作者:sunsky303