rayburn/zookeeper

Kubernetes-ZooKeeper镜像文档

镜像概述

本镜像为k8s.gcr.io/kubernetes-zookeeper:1.0-3.4.10的副本，基于ZooKeeper 3.4.10版本构建，专为Kubernetes环境设计，用于部署分布式协调服务ZooKeeper。ZooKeeper是一个高性能的分布式协调服务，常用于分布式系统中的配置管理、命名服务、分布式锁和集群协调等场景。

核心功能与特性

• 分布式协调服务：提供分布式系统所需的协调机制，包括统一命名服务、配置管理、分布式锁等核心功能
• Kubernetes集成：针对Kubernetes环境优化，支持在K8s集群中部署和运行
• 稳定版本：基于ZooKeeper 3.4.10，该版本经过生产环境验证，稳定性高
• 轻量级设计：优化的镜像大小，适合容器化部署

使用场景与适用范围

• 无法直接访问k8s.gcr.io镜像仓库的环境，需要使用镜像副本进行部署
• 在Kubernetes集群中搭建ZooKeeper集群，为分布式应用提供协调服务
• 开发、测试或生产环境中需要可靠分布式协调能力的场景
• 需要与Kubernetes生态系统集成的ZooKeeper部署需求

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name zookeeper \
  -p 2181:2181 \
  -e ZOO_SERVERS="server.1=localhost:2888:3888" \
  docker.xuanyuan.run/your-image-name:1.0-3.4.10

环境变量配置

Docker Compose示例

yaml
version: '3'
services:
  zookeeper:
    image: docker.xuanyuan.run/your-image-name:1.0-3.4.10
    ports:
      - "2181:2181"
      - "2888:2888"
      - "3888:3888"
    environment:
      ZOO_SERVERS: "server.1=zookeeper:2888:3888"
    volumes:
      - zookeeper-data:/data
      - zookeeper-datalog:/datalog
volumes:
  zookeeper-data:
  zookeeper-datalog:

Kubernetes部署示例（StatefulSet）

yaml
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: zookeeper
spec:
  serviceName: zookeeper
  replicas: 3
  selector:
    matchLabels:
      app: zookeeper
  template:
    metadata:
      labels:
        app: zookeeper
    spec:
      containers:
      - name: zookeeper
        image: docker.xuanyuan.run/your-image-name:1.0-3.4.10
        ports:
        - containerPort: 2181
          name: client
        - containerPort: 2888
          name: peer
        - containerPort: 3888
          name: leader-election
        env:
        - name: ZOO_SERVERS
          value: "server.1=zookeeper-0.zookeeper:2888:3888 server.2=zookeeper-1.zookeeper:2888:3888 server.3=zookeeper-2.zookeeper:2888:3888"
        volumeMounts:
        - name: data
          mountPath: /data
        - name: datalog
          mountPath: /datalog
  volumeClaimTemplates:
  - metadata:
      name: data
    spec:
      accessModes: [ "ReadWriteOnce" ]
      resources:
        requests:
          storage: 1Gi
  - metadata:
      name: datalog
    spec:
      accessModes: [ "ReadWriteOnce" ]
      resources:
        requests:
          storage: 1Gi

注意事项

• 部署集群时，需确保ZOO_SERVERS配置正确，包含所有节点信息
• 生产环境建议使用持久化存储（如Kubernetes PV/PVC）保存ZooKeeper数据
• 镜像版本与原k8s.gcr.io/kubernetes-zookeeper:1.0-3.4.10完全一致，功能和使用方法相同