Zookeeper基础教程(三):Zookeeper连接使用—zkCli

  上一篇介绍Zookeeper的安装,并介绍了使用ZooInspector连接Zookeeper,这里主要介绍以命令行的形式介绍Zookeeper

  假如我们已经安装了Zookeeper集群,集群中的安装目录都是/opt/zookeeper-3.4.14,集群地址:  

  # 192.168.209.133 test1
  # 192.168.209.134 test2   # 192.168.209.135 test3

  端口都是默认的,客户端连接使用2182端口,节点间通信端口是2888,选举端口是3888

  zkCli

  介绍Zookeeper安装的时候,使用zkServer去启动Zookeeper,而启动了,我们是采用zkCli去连接Zookeeper,我们进入Zookeeper安装的根目录,我这里是/opt/zookeeper-3.4.14,输入:  

   # zkCli.sh -server host:port # 指定连接节点,默认host=localhost,port=2181,如:zkCli.sh -server test2:2181,表示连接test2节点 
  ./bin/zkCli.sh  

   可以看到已连接Zookeeper,默认连接本地的(localhost:2181)

  

   直接输入help命令

  

  使用zkCli连接上Zookeeper后,就可以在zk的命令行进行操作了。整理一下,可分成4个部分来说明。

  znode节点操作

   znode是Zookeeper的数据节点,znode之间是类似于目录树的结构关系,对Zookeeper的操作一般都是对znode的操作,而对znode节点操作就是一般的crud操作  

    # znode节点操作部分
  create [-s] [-e] path data acl  # 创建一个znode节点,同时设置节点权限acl,-s表示创建有序节点,-e创建临时节点,如创建一个/mynode节点:create /mynode hello,另外znode需要按照层级去创建,如创建/node1/node2,需要县创建/node1再创建/node1/node2
  stat path [watch]  # 查看znode状态,如数据长度,时间戳等等,同时可以注册一个监听器
  get path [watch]  # 获取znode节点的数据,同时可以注册一个监听器,如:get /mynode
  set path data [version]  # 设置znode的数据,同时可以设置一个监听器,如:set /mynode "hello world"
  ls path [watch]  #列出znode的子节点,同时可以设置一个监听器,如:ls /
  ls2 path [watch]  #列出znode的子节点,同时可以设置一个监听器,如:ls2 /,与ls的区别是ls2还可以获取到子节点个数等等状态信息
  delete path [version]  #删除znode节点,注意路径为绝对路径,且不可删除拥有子节点的znode
  rmr path  #递归删除znode节点,与delete的区别是可以删除拥有子节点的znode

  quota配额操作

  quota配额机制就是对znode做一些限制,支持节点个数和空间大小(字节数)两种方式,不过貌似quota配额并不会阻止操作的进行,而只是抛出警告  

    # quota配额
  setquota -n|-b val path  #增加配额,-n是设置子节点的配额数量,-b是设置节点内容的长度
  listquota path    #列出节点配额信息
  delquota [-n|-b] path    #删除节点配额

  ACL权限控制

  当使用zkCli连接Zookeeper时,就是和Zookeeper集群开启了一次会话,而acl操作就是对会话权限进行控制的操作  

    #ACL权限控制
    setAcl path acl  #给已有节点赋予权限,其中acl是权限
   getAcl path  #查看节点的权限
   # 在上面的创建节点操作中,我们也可以给节点赋予权限,如:

  Zookeeper的acl权限由[scheme : id :permissions]三部分组成,其中scheme是认证类型,id一般指的是账号,也就是权限所针对的对象,permissions表示对节点的空权限类型,而scheme和permissions有以下可选项:  

    Permissions可选项,在使用时,可以使用首字母进行简写(crwda):
    CREATE:允许创建子节点;
    READ:允许从节点获取数据并列出其子节点;
    WRITE:允许为节点设置数据;
    DELETE:允许删除子节点;
    ADMIN:允许为节点设置权限。
  
   Scheme可选项:
   world:默认模式,所有客户端都拥有指定的权限。world下只有一个id选项,就是anyone,通常组合写法为world:anyone:[permissons];比如:setAcl /mynode world:anyone:crwda
   auth:只有经过认证的用户才拥有指定的权限。通常组合写法为auth:user:password:[permissons],使用这种模式时,你需要先进行登录,之后采用auth模式设置权限时,user和password都将使用登录的用户名和密码;比如:setAcl /mynode auth:feng:123456:crwda
   digest:只有经过认证的用户才拥有指定的权限。通常组合写法为digest:user:BASE64(SHA1(password)):[permissons],这种形式下的密码必须通过SHA1和BASE64进行双重加密;比如:setAcl /mynode digest:feng:xHBaNtDKjaz0G0F0dq11735c9r8=:crwda
   ip:限制只有特定IP的客户端才拥有指定的权限。通常组成写法为ip:182.168.0.168:[permissions];比如:setAcl /mynode ip:192.168.28.213:crwda
   super:代表超级管理员,拥有所有的权限,需要修改Zookeeper启动脚本进行配置。

   # auth模式和digest模式其实是一样的,区别可以理解为,auth模式使用的是明文密码,而digest使用的是密文密码(SHA1和BASE64),比如下面两种方式是等价的
   setAcl /mynode auth:feng:123456:crwda
   setAcl /mynode digest:feng:xHBaNtDKjaz0G0F0dq11735c9r8=:crwda
   #这里说的等级是在使用setAcl命令为znode添加权限控制时,并非在使用addauth添加认证时

  一般的,权限是给znode节点设置的,当使用zkCli连接到Zookeeper开启一个会话时,默认情况下是world认证模式,该模式下只能操作那些world认证模式权限的znode节点,要访问某个特定模式下的节点,就需要满足节点上设置的认证模式。

  super模式用的少,一般可以忽略,ip模式即指定客户端,比如:  

    setAcl /mynode ip:192.168.209.134:crwda

  这个表示当我们从192.168.209.134访问时才能访问到/mynode节点,否则会提示Authentication is not valid

  

   然后我们到192.168.209.134上使用zkCli连接Zookeeper,发现成功访问到/mynode节点

  

  对于auth模式和digest模式,就需要修改当前会话的认证模式,修改认证模式使用addauth命令:  

    addauth scheme auth        #scheme是认证模式(貌似只能是digest),auth是认证信息,格式:user:password

   例如: addauth digest feng:123456  #添加auth模式,后面携带的参数是user:password模式
   #如果要退出认证,只需要使用close关闭连接,再使用connect重新连接就好了  

  简单解释一下acl权限的auth模式(digest模式)设置过程,假如我们开启一个新的会话,我们有一个/mynode节点:

  

   可以看到,/mynode节点默认模式是world:anyone:cdrwa,然后我们修改它的权限:

  

   从上面可以看到,只有feng:123456这个用户可以读(r),还可以管理权限(a),其他认证都不能操作数据节点,

  注意,当我们需要修改znode节点的acl时,需要确认我们当前会话已使用addauth命令添加了认证信息,否则会提示设置acl权限失败(所以上图第一行命令addauth就是添加认证信息)

  

  接着,我们使用close命令关闭连接,使用connect命令重新连接,这时会话就变成了无认证状态,使用get获取/mynode节点数据时就会提示认证错误:

  

   接着我们添加认证信息,然后再使用get命令就可能获取到数据了

  

    总结:acl权限控制可以理解为,在创建znode节点时或者使用setAcl命令为已存在的znode添加Scheme模式(world,auth,digest,ip,super)和权限(crdwa),Scheme模式作为匹配条件,当客户端连接Zookeeper的会话满足Scheme模式的条件,就会具有此znode节点上设置的权限

  其他命令操作  

    history    #查看当前会话中使用过的命令,每个命令会携带一个编号
    redo cmdno    #重新执行命令,cmdno是命令编号,可以使用history查看
    printwatches [on|off]    #是否输出 watch 事件,如果使用on或者off则表示设置
   sync path  #会强制客户端所连接的服务器状态与leader的状态同步,这样在读取 path 的值就是最新的值了
   quit  #直接退出当前的zkCli命令行
   close   #关闭连接,但不会退出当前zkCli命令行
   connect host:port  #打开连接

猜你喜欢

转载自www.cnblogs.com/shanfeng1000/p/12700144.html