1、zookeeper 的名词

1.1 集群角色

zookeeper 配置白名单 zookeeper设置ip白名单_zookeeper 配置白名单

1.2 数据模型

zookeeper 的视图结构和标准的文件系统非常类似，每一个节点称之为 ZNode，是 zookeeper 的最小单元。每个 znode 上都可以保存数据以及挂载子节点。构成一个层次化的树形结构。

  • 持久节点(PERSISTENT)
    创建后会一直存在 zookeeper 服务器上，直到主动删除
  • 持久有序节点(PERSISTENT_SEQUENTIAL)
    每个节点都会为它的一级子节点维护一个顺序
  • 临时节点(EPHEMERAL)
    临时节点的生命周期和客户端的会话绑定在一起，当客户端会话失效该节点自动清理
  • 临时有序节点(EPHEMERAL)
    在临时节点的基础上多了一个顺序性
  • 容器节点（Container Nodes）：
    Zookeeper3.5.3 版本增加了容器节点，这种类型的数据节点是为特定场景服务的，比如选主、锁等。当容器节点的最后一个子节点被删除后，服务端会随后会在某个时间点将容器删除。
  • 限时节点（TTL Nodes）：
    Zookeeper3.5.3 版本增加了限时节点，当创建一个永久节点或者永久有序节点时，可以给这个节点增加一个时间属性（毫秒为单位），当指定时间内节点没有被修改，并且不存在子节点，那么服务端会在随后的某个时间点将此节点删除。注意：必须通过System属性启用 TTL 节点，因为默认情况下它们被禁用。如果你没有在系统层面启用TTL属性，那么在添加的时候会抛出KeeperException.UnimplementedException异常

1.3 会话

zookeeper 配置白名单 zookeeper设置ip白名单_分布式_02

  1. Client 初始化连接，状态转为 CONNECTING(1)
  2. Client 与 Server 成功建立连接，状态转为 CONNECTED(2)
  3. Client 丢失了与 Server 的连接或者没有接受到 Server 的响
    应，状态转为 CONNECTING(3)
  4. Client 连上另外的 Server 或连接上了之前的 Server，状态转为 CONNECTED(2)
  5. 若会话过期(是 Server 负责声明会话过期，而不是 Client)，状态转为 CLOSED(5)，状态转为 CLOSED
  6. Client 也可以主动关闭会话(4)，状态转为 CLOSED

1.4 Stat 状态信息

每个节点除了存储数据内容以外，还存储了数据节点本身的一些状态信息，通过 get 命令可以获得状态信息的详细内容。

zookeeper 配置白名单 zookeeper设置ip白名单_分布式_03

1.5 版本-保证分布式数据原子性

zookeeper 为数据节点引入了版本的概念，每个数据节点都有三类版本信息，对数据节点任何更新操作都会引起版本号的变化。

zookeeper 配置白名单 zookeeper设置ip白名单_应用实战_04

版本有点和我们经常使用的乐观锁类似。这里有两个概念说一下，一个是乐观锁，一个是悲观锁。

悲观锁：是数据库中一种非常典型且非常严格的并发控制策略。假如一个事务 A 正在对数据进行处理，那么在整个处理过程中，都会将数据处于锁定状态，在这期间其他事务无法对数据进行更新操作。

乐观锁：乐观锁和悲观锁正好想法，它假定多个事务在处理过程中不会彼此影响，因此在事务处理过程中不需要进行加锁处理，如果多个事务对同一数据做更改，那么在更新请求提交之前，每个事务都会首先检查当前事务读取数据后，是否有其他事务对数据进行了修改。如果有修改，则回滚事务。

再回到 zookeeper，version 属性就是用来实现乐观锁机制的 “写入校验”。

1.6 Watcher

zookeeper 提供了分布式数据的发布/订阅功能，zookeeper 允许客户端向服务端注册一个 watcher 监听，当服务端的一些指定事件触发了 watcher，那么服务端就会向客户端发送一个事件通知。

值得注意的是，Watcher 通知是一次性的，即一旦触发一次通知后，该 Watcher 就失效了，因此客户端需要反复注册 Watcher，即程序中在 process 里面又注册了 Watcher，否则，将无法获取 c3 节点的创建而导致子节点变化的事件。

2、Zookeeper 基于 Java 访问

针对 zookeeper，比较常用的 Java 客户端有 zkclient、curator。 由于 Curator 对于 zookeeper 的抽象层次比较高，简化了 zookeeper 客户端的开发量。使得 curator 逐步被广泛应用。

  1. 封装 zookeeper client 与 zookeeper server 之间的连接处理
  2. 提供了一套 fluent 风格的操作 api
  3. 提供 zookeeper 各种应用场景(共享锁、leader 选举)的抽象封装

2.1 依赖 jar 包

<dependency> 
    <groupId>org.apache.curator</groupId> 
    <artifactId>curator-framework</artifactId>
    <version>4.0.0</version> 
</dependency>

2.2 建立连接

CuratorFramework curatorFramework = CuratorFrameworkFactory.builder()
            .connectString(CONNECTION_STR)
            .sessionTimeoutMs(5000)
            .retryPolicy(new ExponentialBackoffRetry(1000,3))
            .namespace(“curator”).build();

重试策略：Curator 内部实现的几种重试策略:
• ExponentialBackoffRetry：重试指定的次数，且每一次重试之间停顿的时间逐渐增加.
• RetryNTimes：指定最大重试次数的重试策略
• RetryOneTime：仅重试一次
• RetryUntilElapsed：一直重试直到达到规定的时间

namespace: 值得注意的是 session2 会话含有隔离命名空间，即客户端对 Zookeeper 上数据节点的任何操作都是相对/curator 目录进行的，这有利于实现不同的 Zookeeper 的业务之间的隔离。

2.3 节点的增删改查

根据 API 进行操作。

2.4 节点权限设置

Zookeeper 作为一个分布式协调框架，内部存储了一些分布式系统运行时的状态的数据，比如 master 选举、比如分布式锁。对这些数据的操作会直接影响到分布式系统的运行状态。

因此，为了保证 zookeeper 中的数据的安全性，避免误操作 带来的影响。Zookeeper 提供了一套 ACL 权限控制机制来保证数据的安全。

ZooKeeper节点的数据结构非常类似于Linux文件系统的结构。在Linux文件系统中，每个文件或目录针对不同的用户和用户组都具有相应的rwx权限。同样的，在ZooKeeper中，每个节点针对不同的用户或主机也具有相应的权限。下面我们来看下ZooKeeper中节点权限的基本概念。

（1）权限模式schema
在ZooKeeper中，权限模式schema有两种类型，分别是 ip 和 digest。
ip模式是基于ip白名单的方式指定某个服务器具有哪些权限。
digest模式是基于用户名和密码的方式指定哪个人具有什么样的权限。

（2）授权对象ID
在ip权限模式下，ID就是具体的ip地址字符串。
在digest权限模式下，ID是username:Base64(Sha1(username:password))字符串。

（3）权限permission
在ZooKeeper中，有create©、delete(d)、read®、write(w)和admin(a)这五种权限类型。

在ZooKeeper中，就是通过 schema、ID 和 permission 指定一个节点的权限信息。

2.4.1 权限控制的案例演示

  • 给节点授权
List<ACL> acls = new ArrayList<>();

Id id1 = new Id("digest", DigestAuthenticationProvider.generateDigest("u1:us"));

Id id2 = new Id("digest",
DigestAuthenticationProvider.generateDigest("u2:us"));

acls.add(new ACL(ZooDefs.Perms.ALL, id1));
acls.add(new ACL(ZooDefs.Perms.DELETE | ZooDefs.Perms.READ,id2));

curatorFramework.create().creatingParentsIfNeeded().withMode(CreateMode.PERSISTENT).

withACL(acls, false).forPath("/auth", "sc".getBytes());
  • 访问授权的节点
AuthInfo authInfo = new AuthInfo("digest", "u1:us".getBytes());
List<AuthInfo> authInfos=new ArrayList<>();
authInfos.add(authInfo);

CuratorFramework curatorFramework = CuratorFrameworkFactory.builder()
    .connectString("192.168.13.102:2181")
    .sessionTimeoutMs(5000)
    .retryPolicy(new ExponentialBackoffRetry(1000,3))
    .authorization(authInfos)
    .namespace("curator")
    .build();
  • 修改已经存在节点的权限
curatorFramework.setACL().withACL().forPath()

2.4.2 权限模式

IP：通过ip地址粒度来进行权限控制，例如配置 [ip:192.168.0.1], 或者按照网段ip:192.168.0.1/24;

Digest：最常用的控制模式，类似于username:password；
设置的时候需要DigestAuthenticationProvider.generateDigest()SHA-加密
和base64编码；

World：最开放的控制模式，这种权限控制几乎没有任何作用，数据的访问权限对所有用户开放。world:anyone

Super：超级用户，可以对节点做任何操作。

2.4.3 授权对象

指权限赋予的用户或一个指定的实体，不同的权限模式下，授权对象不同。

zookeeper 配置白名单 zookeeper设置ip白名单_zookeeper 配置白名单_05

2.4.4 权限

指通过权限检查后可以被允许的操作，create /delete/read/write/admin

Create 允许对子节点 Create 操作
Read 允许对本节点 GetChildren 和 GetData 操作
Write 允许对本节点 SetData 操作
Delete 允许对子节点 Delete 操作
Admin 允许对本节点 setAcl 操作

2.5 节点事件监听

Watcher 监听机制是 Zookeeper 中非常重要的特性，我们基于 zookeeper 上创建的节点，可以对这些节点绑定监听事件，比如可以监听节点数据变更、节点删除、子节点状态变更等事件，通过这个事件机制，可以基于 zookeeper 实现分布式锁、集群管理等功能。

zookeeper 事件及其事件含义：
EventType.NodeCreated：当 node-x 这个节点被创建时，该事件被触发；
EventType.NodeChildrenChanged：当 node-x 这个节点的直接子节点被创建、被删除、子节点数据发生变更时，该事件被触发。
EventType.NodeDataChanged：当 node-x 这个节点的数据发生变更时，该事件被触发
EventType.NodeDeleted：当 node-x 这个节点被删除时，该事件被触发。
EventType.None：当 zookeeper 客户端的连接状态发生变更时，即KeeperState.Expired、KeeperState.Disconnected、KeeperState.SyncConnected、KeeperState.Auth。

watcher 机制有一个特性：当数据发生改变的时候，那么 zookeeper 会产生一个 watch 事件并发送到客户端，但是客户端只会收到一次这样的通知，如果以后这个数据再发生变化，那么之前设置 watch 的客户端不会再次收到消息。因为他是一次性的；如果要实现永久监听，可以通过循环注册来实现。

Curator 提供了三种 Watcher 来监听节点的变化：

• PathChildCache：监视一个路径下孩子结点的创建、删除、更新。
• NodeCache：监视当前结点的创建、更新、删除，并将节点的数据缓存在本地。
• TreeCache：PathChildCache 和 NodeCache 的“合体”，监视路径下的创建、更新、删除事件，并缓存路径下所有孩子结点的数据。