分布式服务框架 Zookeeper（三）官方入门指南

入门指南：使用ZooKeeper来协调分布式应用

这篇文档包含了让你快速上手ZooKeeper的信息。主要是针对那些想要试一把ZooKeeper的开发人员，包含了安装一个单一ZooKeeper服务器的简单指令，一些验证ZooKeeper是否运行的简单命令以及一个简单的编程例子。最后，为了方便，还写了一些关于更复杂的安装知识，比如运行一个备份的部署，以及优化事务记录。但是完整的商业部署过程需要参考ZooKeeper管理员指南。

前期条件

系统要求请参考管理手册。

下载

为了获取ZooKeeper的发型版本，请从Apache下载镜像下载一个最新的稳定发型版本。

单机操作

安装一个单机版的ZooKeeper服务器还是挺简单的。服务器包含一个JAR文件，因此安装过程就只包括了创建一个配置。

一旦你下载了一个稳定版的ZooKeeper发行版，将它解压到root下。

为了启动ZooKe，你需要一个配置文件。这里有一个样本，创建一个文件conf/zoo.cfg：


这个文件可以叫任何名字，但是为了方便起见，我们还是命名为conf/zoo.cfg。改变dataDir的值来指定一个已经存在的（开始是空的）目录。下面解释一下这几个属性：

ticktime：ZooKeeper使用的以milliseconds为单位的基本时间单位。它用于心跳检测，并且最小的会话超时时间是它的两倍。

dataDir：存储内存数据库快照的地方，除非指定，不然事务日志会更新到数据库中。

clientPort：监听客户端连接的接口。

现在你已经创建了一个配置文件了，你可开始启动ZooKeeper了：


这会让你执行一个简单的类似文件的操作。

一旦你连接上了，你会看到如下信息：



在这个shell中，敲help命令可以获取从客户端执行的命令列表，比如：


在这里，你可以尝试一些简单的命令从命令行感受一下。首先可以敲ls命令：


接下来，使用create /zk_test my_data命令创建一个新的znode。这会创建一个新的znode，并且与之相关的一个字符串"my_data"。


执行ls /命令来看一下目录是什么样的：


注意到现在已经创建了zk_test目录了。

接下来，验证使用get命令来验证一下和znode相关的数据：


（注意到我们在做了一个get命令之后确实发现应设置了数据了）

最后我们通过delete来删除这个znode


要探索更多请看Programmer's Guide。

ZooKeeper编程

ZooKeeper提供了Java和C语言接口。它们在功能上是一样的。C接口存在两个变种：单线程和多线程的。它们的差别仅仅在于消息循环是如何完成的。更多信息参见Programming Examples in the ZooKeeper Programmer's Guide。

运行备份（Replicated）的ZooKeeper

运行单机版本的ZooKeeper在评估、开发以及测试的时候尚可。但是在生产环境中，你应该以集群的方式运行ZooKeeper。运行相同应用的一组服务器称之为quorum，在集群模式下，在quorum中的所有服务器都有相同的配置文件。


集群模式的conf/zoo.cfg和单一版本的类似，但是还有有一些不同。下面是一个示例：


新项，initLimit是用来限制quorum中的服务器连接到一个leader的超时时间。配置项syncLimit限制了一个服务器可以和leader断开多久。

有了这些超时限制，你用tickTime这个时间单位来指定超时时间。在本例中，initLimit的超时时间是5个tick，也就是10s。

server.X的配置项列出了组成ZooKeeper服务的服务器。当一个服务开启的时候，它知道从那台服务器中的data directory中寻找myid文件。这个文件以ASCII码包含了服务器号码。

最后，注意到每个服务器名后面有两个端口号"2888"和"3888"。同类使用前一个端口号和其他同类相连。这种连接在同类之间进行交互是十分必要的，例如，同意更新的顺序。更多的，一个ZooKeeper服务器使用这个端口号来连接follows和leader。当一个新的leader选出来了后，一个follower会使用这个端口号开启对leader的TCP连接。，我们现在还需要另一个端口进行leader选举。即server项中的第二个端口号。

其他优化措施

这里有一些其他的可极大提高性能的配置参数：

为了是更新的延迟降低，必须要有一个目标事务日志目录。默认的事务日志是放在和数据快照和myid文件相同的目录中。dataLogDir参数指定用一个不同的目录来用于事务日志。