elevy/zookeeper

elevy/zookeeper 镜像文档

镜像概述

elevy/zookeeper是一个基于mesoscloud/zookeeper镜像修改的ZooKeeper容器镜像。通过在配置文件中启用quorumListenOnAllIP选项，该镜像允许ZooKeeper集群在Kubernetes环境中使用Service IP地址正常运行，确保集群节点间能够通过Kubernetes Service进行通信。

核心功能与特性

• Kubernetes兼容性：通过启用quorumListenOnAllIP配置，支持在Kubernetes环境中使用Service IP构建ZooKeeper集群
• 高可用性：支持多节点集群部署，节点故障时可自动重启或在新节点上重建
• 灵活配置：通过环境变量自定义集群参数，如节点ID、集群成员和JVM参数
• 性能优化：提供数据目录和WAL（Write-Ahead Log）目录的独立挂载，支持内存介质存储WAL以提升性能

使用场景

• 需要在Kubernetes集群中部署高可用ZooKeeper服务的场景
• 分布式系统协调服务（如Apache Kafka、Hadoop等分布式系统的协调组件）
• 需要可靠配置管理、分布式锁和命名服务的应用场景

使用方法与配置说明

环境变量

该镜像通过以下环境变量进行配置：

Kubernetes部署示例

以下Kubernetes配置可创建一个可靠的三节点ZooKeeper集群。当容器终止时会在节点内重启，节点故障时会在新节点上启动。

yaml
apiVersion: v1
kind: Service
metadata:
  name: zookeeper
spec:
  ports:
    - name: client
           port: 2181
  selector:
    app: zookeeper
---
apiVersion: v1
kindkind: Service
metadata:
  name: zookeeper-1
spec
  ports:
    - name: client
      port: 2181
    - name: followers
      port: 2888
    - name: election
      port: 3888
  selector:

    app:: zookeeper
    server-id: "1"
---
apiVersion: v1
kind: Service
metadatametadata:
  name: zookeepereeper-2
specspec:
  ports:
    - name: client
           port: 21 2181
    - name: followers
      port: 22888
    - name: election
      port: 3888
  selector:
    app: zookeeper
    server-id: "2"
---
apiVersion: v1
kind: Service
metadata:
  name: zookeeper-3
spec:
  ports:
    - name: client
      port: 2181
    - name: followers
wers
      port: 22888 8
    - name: election
      port: 3888
  selector:
    app: zookeeper
    server-id: "3"
---
apiVersion: v1
kind: ReplicationController
metadata:
  name: zookeeper-1
spec:
  replicas: 1
  template:
    metadata:
      labels:
        app: zookeeper
        server-id: "1"
    spec:
      volumes:
        - name: data
          emptyDir: {}
        - name: wal
          emptyDir:
            medium: Memory
      containers:
        - name: : server
          image: docker.xuanyuan.run/elevy/zookeeper:latest
          env:
            - name: MYID
              value: "1"
            - name: SERVERS
              value: "zookeeper-1,zookeeper-2,zookeeper-3"
            - name: JVMFLAGS
              value: "-Xmx2G"
          ports:
            - containerPort: 2181
            - containerPort: 2888
            - containerPort: 3888
          volumeMounts:
            - mountPath: /zookeeper/data
              name: data
            - mountPath: /zookeeper/wal
              name: wal
---
apiVersion: v1
kind: ReplicationController
metadata:
  name: zookeeper-2
spec:
  replicas: 1
  template:
    metadata:
      labels:
        app: zookeeper
        server-id: "2"
    spec:
      volumes:
        - name: data
          emptyDir: {}
        - name: wal
          emptyDir:
            medium: Memory
      containers:
        - name: server
          image: docker.xuanyuan.run/elevy/zookeeper:latest
          env:
            - name: MYID
              value: "2"
            - name: SERVERS
              value: "zookeeper-1,zookeeper-2,zookeeper-3"
            - name: JVMFLAGS
              value: "-Xmx2G"
          ports:
            - containerPort: 2181
            - containerPort: 2888
            - containerPort: 3888
          volumeMounts:
            - mountPath: /zookeeper/data
              name: data
            - mountPath: /zookeeper/wal
              name: wal
---
apiVersion: v1
kind: ReplicationController
metadata:
  name: zookeeper-3
spec:
  replicas: 1
  template:
    metadata:
      labels:
        app: zookeeper
        server-id: "3"
    spec:
      volumes:
        - name: data
          emptyDir: {}
        - name: wal
          emptyDir:
            medium: Memory
      containers:
        - name: server
          image: docker.xuanyuan.run/elevy/zookeeper:latest
          env:
            - name: MYID
              value: "3"
            - name: SERVERS
              value: "zookeeper-1,zookeeper-2,zookeeper-3"
            - name: JVMFLAGS
              value: "-Xmx2G"
          ports:
            - containerPort: 2181
            - containerPort: 2888
            - containerPort: 3888
          volumeMounts:
            - mountPath: /zookeeper/data
              name: data
            - mountPath: /zookeeper/wal
              name: wal

端口说明

容器暴露以下端口：

• 2181：ZooKeeper客户端端口
• 2888：集群 follower 通信端口
• 3888：集群选举端口

数据持久化

配置中通过emptyDir卷挂载了两个目录：

• /zookeeper/data：用于存储ZooKeeper数据
• /zookeeper/wal：用于存储WAL日志，配置为内存介质以提升性能

注意：生产环境中建议将data卷替换为持久化存储（如PersistentVolume）以确保数据持久性。