ppc64le/zookeeper

注意：这是https://hub.docker.com/_/zookeeper的`ppc64le`架构专用仓库——更多信息，请参见官方镜像文档中的https://github.com/docker-library/official-images#architectures-other-than-amd64和官方镜像FAQ中的https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what。

快速参考

• 维护者：
  https://github.com/31z4/zookeeper-docker

• 获取帮助：
  https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic或https://stackoverflow.com/help/on-topic

支持的标签及对应的Dockerfile链接

• https://github.com/31z4/zookeeper-docker/blob/52a83649bc332b3324e0f0ecd96a1c88b2793022/3.8.6/Dockerfile

• https://github.com/31z4/zookeeper-docker/blob/3f6430f695fceae0858824d716654c7e2b38bad3/3.9.5/Dockerfile

快速参考（续）

• 提交issue：
  https://github.com/31z4/zookeeper-docker/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/zookeeper/、https://hub.docker.com/r/arm64v8/zookeeper/、https://hub.docker.com/r/ppc64le/zookeeper/、https://hub.docker.com/r/s390x/zookeeper/

• 已发布镜像制品详情：
  https://github.com/docker-library/repo-info/blob/master/repos/zookeeper（https://github.com/docker-library/repo-info/commits/master/repos/zookeeper）
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fzookeeper
  https://github.com/docker-library/official-images/blob/master/library/zookeeper（https://github.com/docker-library/official-images/commits/master/library/zookeeper）

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/zookeeper（https://github.com/docker-library/docs/commits/master/zookeeper）

什么是Apache ZooKeeper？

Apache ZooKeeper是Apache软件基金会的一个软件项目，为大型分布式系统提供开源的分布式配置服务、同步服务和命名注册。ZooKeeper曾是Hadoop的子项目，现在已成为独立的顶级项目。

***.org/wiki/Apache_ZooKeeper

如何使用本镜像

启动Zookeeper服务器实例

console
$ docker run --name some-zookeeper --restart always -d ppc64le/zookeeper

本镜像包含EXPOSE 2181 2888 3888 8080（分别对应Zookeeper客户端端口、跟随者端口、选举端口、AdminServer端口），因此标准容器链接会使其自动对链接的容器可用。由于Zookeeper采用"快速失败"机制，建议始终重启容器。

从另一个Docker容器中的应用连接到Zookeeper

console
$ docker run --name some-app --link some-zookeeper:zookeeper -d application-that-uses-zookeeper

从Zookeeper命令行客户端连接到Zookeeper

console
$ docker run -it --rm --link some-zookeeper:zookeeper ppc64le/zookeeper zkCli.sh -server zookeeper

... 通过https://github.com/docker/compose

zookeeper的compose.yaml示例：

yaml
services:
  zoo1:
    image: docker.xuanyuan.run/zookeeper
    restart: always
    hostname: zoo1
    ports:
      - 2181:2181
    environment:
      ZOO_MY_ID: 1
      ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181

  zoo2:
    image: docker.xuanyuan.run/zookeeper
    restart: always
    hostname: zoo2
    ports:
      - 2182:2181
    environment:
      ZOO_MY_ID: 2
      ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181

  zoo3:
    image: docker.xuanyuan.run/zookeeper
    restart: always
    hostname: zoo3
    ports:
      - 2183:2181
    environment:
      ZOO_MY_ID: 3
      ZOO_SERVERS: server.1=zoo1:2888:3888;2181 server.2=zoo2:2888:3888;2181 server.3=zoo3:2888:3888;2181

这将以https://zookeeper.apache.org/doc/current/zookeeperStarted.html#sc_RunningReplicatedZooKeeper启动Zookeeper。运行`docker compose up并等待其完全初始化。端口2181-2183`将被暴露。

请注意，在单台机器上设置多个服务器不会创建任何冗余。如果机器发生故障，所有Zookeeper服务器都将离线。完全冗余要求每个服务器拥有自己的机器，且必须是完全独立的物理服务器。同一物理主机上的多个虚拟机仍容易受到该主机完全故障的影响。

在复制模式下运行Zookeeper时，考虑使用https://www.docker.com/products/docker-swarm。

配置

Zookeeper配置位于/conf目录。修改配置的一种方式是将配置文件作为卷挂载：

console
$ docker run --name some-zookeeper --restart always -d -v $(pwd)/zoo.cfg:/conf/zoo.cfg ppc64le/zookeeper

环境变量

如果未提供zoo.cfg文件，将使用ZooKeeper推荐的默认值。可通过以下环境变量覆盖默认值：

console
$ docker run -e "ZOO_INIT_LIMIT=10" --name some-zookeeper --restart always -d ppc64le/zookeeper

ZOO_TICK_TIME

默认值为2000。ZooKeeper的tickTime

单个滴答的长度，以毫秒为单位，是ZooKeeper使用的基本时间单位，用于调节心跳和超时。例如，最小会话超时为两个滴答。

ZOO_INIT_LIMIT

默认值为5。ZooKeeper的initLimit

允许跟随者连接并同步到领导者的时间（以滴答为单位，参见tickTime）。如果ZooKeeper管理的数据量较大，需增加此值。

ZOO_SYNC_LIMIT

默认值为2。ZooKeeper的syncLimit

允许跟随者与ZooKeeper同步的时间（以滴答为单位，参见tickTime）。如果跟随者落后领导者太多，将被丢弃。

ZOO_MAX_CLIENT_CNXNS

默认值为60。ZooKeeper的maxClientCnxns

限制单个客户端（按IP地址标识）对ZooKeeper集群中单个成员的并发连接数（在套接字级别）。

ZOO_STANDALONE_ENABLED

默认值为true。Zookeeper的https://zookeeper.apache.org/doc/r3.5.7/zookeeperReconfig.html#sc_reconfig_standaloneEnabled

在3.5.0之前，ZooKeeper可运行在独立模式或分布式模式。这是两个独立的实现栈，运行时无法切换。默认情况下（为保持向后兼容性），standaloneEnabled设置为true。使用此默认值的后果是：如果以单个服务器启动，集群将不允许扩展；如果以多个服务器启动，将不允许缩减到少于两个参与者。

ZOO_ADMINSERVER_ENABLED

默认值为true。Zookeeper的http://zookeeper.apache.org/doc/r3.5.7/zookeeperAdmin.html#sc_adminserver_config

AdminServer是一个嵌入式Jetty服务器，提供HTTP接口以执行四字命令。默认情况下，服务器在端口8080上启动，可通过访问URL"/commands/[命令名称]"执行命令，例如http://localhost:8080/commands/stat。

ZOO_AUTOPURGE_PURGEINTERVAL

默认值为0。Zookeeper的https://zookeeper.apache.org/doc/current/zookeeperAdmin.html#sc_advancedConfiguration

触发清理任务的时间间隔（小时）。设置为正整数（1及以上）以启用自动清理。默认值为0。

ZOO_AUTOPURGE_SNAPRETAINCOUNT

默认值为3。Zookeeper的https://zookeeper.apache.org/doc/current/zookeeperAdmin.html#sc_advancedConfiguration

启用后，ZooKeeper自动清理功能将在dataDir和dataLogDir中分别保留autopurge.snapRetainCount个最新快照和相应的事务日志，并删除其余部分。默认值为3。最小值为3。

ZOO_4LW_COMMANDS_WHITELIST

默认值为srvr。Zookeeper的https://zookeeper.apache.org/doc/current/zookeeperAdmin.html#sc_clusterOptions

用户希望使用的四字命令列表，以逗号分隔。必须将有效的四字命令放入此列表，否则ZooKeeper服务器将不启用该命令。默认情况下，白名单仅包含zkServer.sh使用的"srvr"命令。其余四字命令默认禁用。

高级配置

ZOO_CFG_EXTRA

并非所有Zookeeper配置设置都通过上述环境变量公开。这些变量仅用于覆盖最小配置关键字和一些经常更改的选项。如果挂载自定义配置文件不适合您，可考虑使用ZOO_CFG_EXTRA环境变量。通过此变量可向Zookeeper配置文件添加任意配置参数。以下示例显示如何在端口7070上启用Prometheus指标导出器：

console
$ docker run --name some-zookeeper --restart always -e ZOO_CFG_EXTRA="metricsProvider.className=org.apache.zookeeper.metrics.prometheus.PrometheusMetricsProvider metricsProvider.httpPort=7070" ppc64le/zookeeper

JVMFLAGS

许多Zookeeper高级配置选项可通过Java系统属性（格式为-Dproperty=value）在此设置。例如，可使用Netty而非NIO（默认选项）作为服务器通信框架：

console
$ docker run --name some-zookeeper --restart always -e JVMFLAGS="-Dzookeeper.serverCnxnFactory=org.apache.zookeeper.server.NettyServerCnxnFactory" ppc64le/zookeeper

有关支持的Java系统属性完整列表，请参见https://zookeeper.apache.org/doc/current/zookeeperAdmin.html#sc_advancedConfiguration。

JVMFLAGS的另一个示例用例是设置最大JVM堆大小为1 GB：

console
$ docker run --name some-zookeeper --restart always -e JVMFLAGS="-Xmx1024m" ppc64le/zookeeper

复制模式

如果要以复制模式运行Zookeeper，以下环境变量是必需的。

ZOO_MY_ID

ID在集群中必须唯一，值应在1到255之间。请注意，如果启动容器时/data目录已包含myid文件，此变量将无效。

ZOO_SERVERS

此变量允许指定Zookeeper集群的机器列表。每个条目应指定为：server.id=<address1>:<port1>:<port2>[:role];[<client port address>:]<client port> https://zookeeper.apache.org/doc/r3.5.7/zookeeperReconfig.html。条目之间用空格分隔。请注意，如果启动容器时`/conf`目录已包含`zoo.cfg`文件，此变量将无效。

数据存储位置

本镜像配置了/data和/datalog卷，分别用于存储Zookeeper内存数据库快照和数据库更新事务日志。

注意事务日志的存储位置。专用的事务日志设备是保持良好性能的关键。将日志放在繁忙的设备上会对性能产生不利影响。

日志配置方法

默认情况下，ZooKeeper将标准输出/错误重定向到控制台。从3.8版本开始，ZooKeeper使用LOGBack作为日志后端。ZooKeeper默认的logback.xml文件位于/conf目录。要覆盖默认日志配置，可将自定义配置作为卷挂载：

console
$ docker run --name some-zookeeper --restart always -d -v $(pwd)/logback.xml:/conf/logback.xml ppc64le/zookeeper

有关更多详细信息，请参见https://zookeeper.apache.org/doc/current/zookeeperAdmin.html#sc_logging。

3.7版本中的日志记录

可通过传递环境变量ZOO_LOG4J_PROP将日志重定向到/logs目录中的文件，如下所示：

console
$ docker run --name some-zookeeper --restart always -e ZOO_LOG4J_PROP="INFO,ROLLINGFILE" ppc64le/zookeeper

这会将日志写入/logs/zookeeper.log。本镜像为方便起见配置了/logs卷。

许可证

查看本镜像中包含的软件的https://github.com/apache/zookeeper/blob/master/LICENSE.txt。

与所有Docker镜像一样，这些镜像可能还包含其他软件，这些软件可能受其他许可证约束（例如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的其他许可证信息可能位于https://github.com/docker-library/repo-info/tree/master/repos/zookeeper中。

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用都符合其中包含的所有软件的相关许可证。