news 2026/5/1 6:48:53

ZooKeeper Cluster 架构文档

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
ZooKeeper Cluster 架构文档

目录标题

  • ZooKeeper Cluster 架构文档
    • 集群标识
    • 1. 环境信息
      • 1.1 Kubernetes 集群
      • 1.2 工作节点分布
    • 2. 集群架构概览
      • 2.1 集群拓扑图
      • 2.2 集群规模统计
    • 3. Pod 详细信息
      • 3.1 Participant 节点
        • Replica 0
        • Replica 1
        • Replica 2
      • 3.2 Observer 节点
    • 4. 容器架构
      • 4.1 Pod 容器组成
      • 4.2 容器环境变量
        • zookeeper 容器环境变量
    • 5. 存储架构
      • 5.1 持久化卷声明 (PVC)
      • 5.2 存储目录结构
      • 5.3 存储策略
    • 6. 网络架构
      • 6.1 服务列表
      • 6.2 端口映射
      • 6.3 网络端点
        • 内部客户端端点
        • Headless 服务端点 (直接访问各节点)
      • 6.4 Endpoints 详情
        • Client Service Endpoints
        • Admin Server Endpoints
        • Headless Service Endpoints
    • 7. ZooKeeper 配置详解
      • 7.1 主配置文件 (zoo.cfg)
      • 7.2 环境配置 (env.sh)
      • 7.3 日志配置 (log4j.properties)
      • 7.4 SASL 认证配置 (jaas.config)
    • 8. 调度与亲和性
      • 8.1 Pod 反亲和性规则
      • 8.2 节点分布
    • 9. 安全与认证
      • 9.1 ServiceAccount
      • 9.2 Secret
      • 9.3 安全上下文
        • ssh 容器 (备份容器)
    • 10. 监控与健康检查
      • 10.1 健康检查配置
        • Liveness Probe (存活探针)
        • Readiness Probe (就绪探针)
      • 10.2 Prometheus 监控指标
      • 10.3 四字命令
    • 11. Operator 管理
      • 11.1 ZooKeeper Operator
      • 11.2 Operator 启动参数
      • 11.3 Web 管理界面
    • 12. 资源汇总
      • 12.1 单 Pod 资源
      • 12.2 集群总资源 (4 Pods)
      • 12.3 Operator 资源
    • 13. 自定义资源 (CRD)
      • 13.1 ZookeeperCluster CR
      • 13.2 集群状态
    • 14. 标签 (Labels)
      • 14.1 集群级别标签
      • 14.2 Pod 额外标签
    • 15. Finalizers
    • 16. 连接示例
      • 16.1 客户端连接字符串
      • 16.2 获取集群状态
    • 17. 运维参考
      • 17.1 常用命令
      • 17.2 日志查看
      • 17.3 故障排查
    • 18. 附录
      • 18.1 文档版本
      • 18.2 相关文档

ZooKeeper Cluster 架构文档

集群标识

属性值
集群名称zookeeper-e93aadcf
命名空间qfusion-admin

1. 环境信息

1.1 Kubernetes 集群

属性值
KUBECONFIG/bpx/.145-admin.conf
Kubernetes 版本v1.24.10
网络插件Cilium CNI
容器运行时containerd://1.7.3

1.2 工作节点分布

节点名称IP 地址操作系统角色ZooKeeper Pod
qfusion1x.x.x.145openEuler 22.03 (LTS-SP1)control-plane,masterzookeeper-e93aadcf-0-0
qfusion2x.x.x.148openEuler 22.03 (LTS-SP1)control-plane,masterzookeeper-e93aadcf-observer-0-0
qfusion3x.x.x.150openEuler 22.03 LTScontrol-plane,masterzookeeper-e93aadcf-2-0
qfusion4x.x.x.147Kylin Linux V10 (Halberd)workerzookeeper-e93aadcf-1-0

2. 集群架构概览

2.1 集群拓扑图

┌─────────────────────────────────────────────────────────────────────────────────┐ │ ZooKeeper Cluster: zookeeper-e93aadcf │ │ 版本: 3.7.1 │ ├─────────────────────────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────────────────────────────────────────────────────────────┐ │ │ │ Quorum 集群 (3节点) │ │ │ ├─────────────────────────────────────────────────────────────────────────┤ │ │ │ │ │ │ │ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │ │ │ │ │ Replica 0 │ │ Replica 1 │ │ Replica 2 │ │ │ │ │ │ Participant │ │ Participant │ │ Participant │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ Node: qfusion1 │ │ Node: qfusion4 │ │ Node: qfusion3 │ │ │ │ │ │ IP: 245.0.0.94 │ │ IP: 245.0.3.243 │ │ IP: 245.0.2.35 │ │ │ │ │ │ myid: 0 │ │ myid: 1 │ │ myid: 2 │ │ │ │ │ └────────┬─────────┘ └────────┬─────────┘ └────────┬─────────┘ │ │ │ │ │ │ │ │ │ │ │ └───────────────────────┼───────────────────────┘ │ │ │ │ │ │ │ │ │ ┌───────────┴───────────┐ │ │ │ │ │ Leader Election │ │ │ │ │ │ (Port 3888) │ │ │ │ │ └───────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────────────────────────────────────────────────────────────┐ │ │ │ Observer 节点 (只读副本) │ │ │ ├─────────────────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────────────┐ │ │ │ │ │ Observer-0 │ │ │ │ │ │ │ │ │ │ │ │ Node: qfusion2 │ │ │ │ │ │ IP: 245.0.1.95 │ │ │ │ │ │ myid: 3 │ │ │ │ │ └──────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────────────────┘

2.2 集群规模统计

指标值
Participant 副本数3
Observer 副本数1
总 Pod 数4
总容器数8 (每Pod 2个容器)
存储总容量80Gi (4 × 20Gi)



Sources

3. Pod 详细信息

3.1 Participant 节点

Replica 0
属性值
Pod 名称zookeeper-e93aadcf-0-0
命名空间qfusion-admin
角色Participant (投票节点)
StatefulSetzookeeper-e93aadcf-0
节点qfusion1 (x.x.x.145)
Pod IP245.0.0.94
FQDNzookeeper-e93aadcf-0.zookeeper-e93aadcf-headless.qfusion-admin.svc.cluster.local
状态Running
Ready2/2
重启次数0
创建时间2025-12-24 22:07:29
myid0
Zonezone1
Replica 1
属性值
Pod 名称zookeeper-e93aadcf-1-0
命名空间qfusion-admin
角色Participant (投票节点)
StatefulSetzookeeper-e93aadcf-1
节点qfusion4 (x.x.x.147)
Pod IP245.0.3.243
FQDNzookeeper-e93aadcf-1.zookeeper-e93aadcf-headless.qfusion-admin.svc.cluster.local
状态Running
Ready2/2
重启次数2
创建时间2025-12-24 22:07:49
myid1
Replica 2
属性值
Pod 名称zookeeper-e93aadcf-2-0
命名空间qfusion-admin
角色Participant (投票节点)
StatefulSetzookeeper-e93aadcf-2
节点qfusion3 (x.x.x.150)
Pod IP245.0.2.35
FQDNzookeeper-e93aadcf-2.zookeeper-e93aadcf-headless.qfusion-admin.svc.cluster.local
状态Running
Ready2/2
重启次数0
创建时间2025-12-24 22:08:41
myid2

3.2 Observer 节点

属性值
Pod 名称zookeeper-e93aadcf-observer-0-0
命名空间qfusion-admin
角色Observer (只读节点，不参与投票)
StatefulSetzookeeper-e93aadcf-observer-0
节点qfusion2 (x.x.x.148)
Pod IP245.0.1.95
FQDNzookeeper-e93aadcf-observer-0.zookeeper-e93aadcf-headless.qfusion-admin.svc.cluster.local
状态Running
Ready2/2
重启次数0
创建时间2025-12-24 22:09:15
myid3

4. 容器架构

4.1 Pod 容器组成

每个 ZooKeeper Pod 包含 2 个容器：

┌─────────────────────────────────────────────────────────────────────────┐ │ Pod │ ├─────────────────────────────────────────────────────────────────────────┤ │ │ │ ┌───────────────────────────────────────────────────────────────────┐ │ │ │ Container 1: zookeeper (主容器) │ │ │ ├───────────────────────────────────────────────────────────────────┤ │ │ │ Image: k8smaster.qfusion.irds/irds/zookeeper-3.7:v1.1.0 │ │ │ │ Image ID: sha256:15681693... │ │ │ │ Command: /usr/local/bin/zookeeperStart.sh │ │ │ │ Pull Policy: Always │ │ │ │ │ │ │ │ Resources: │ │ │ │ CPU Request: 500m │ │ │ │ CPU Limit: 1000m │ │ │ │ Memory Request: 2Gi │ │ │ │ Memory Limit: 2Gi │ │ │ │ │ │ │ │ Ports: │ │ │ │ 2181/tcp - client (客户端连接) │ │ │ │ 2888/tcp - quorum (集群通信) │ │ │ │ 3888/tcp - leader-election (领导者选举) │ │ │ │ 7000/tcp - metrics (Prometheus监控指标) │ │ │ │ 8080/tcp - admin-server (Jetty管理服务器) │ │ │ │ │ │ │ │ Health Checks: │ │ │ │ Liveness: exec [zookeeperLive.sh] │ │ │ │ delay=10s, timeout=10s, period=10s │ │ │ │ Readiness: exec [zookeeperReady.sh] │ │ │ │ delay=10s, timeout=10s, period=10s │ │ │ │ │ │ │ │ Lifecycle: │ │ │ │ PreStop: exec [zookeeperTeardown.sh] │ │ │ │ │ │ │ │ Volume Mounts: │ │ │ │ /conf - ConfigMap (zookeeper-e93aadcf-configmap) │ │ │ │ /data - PVC (持久化数据) │ │ │ │ /mnt/log - EmptyDir (日志) │ │ │ │ /etc/localtime - HostPath (时区) │ │ │ └───────────────────────────────────────────────────────────────────┘ │ │ │ │ ┌───────────────────────────────────────────────────────────────────┐ │ │ │ Container 2: ssh (备份/管理容器) │ │ │ ├───────────────────────────────────────────────────────────────────┤ │ │ │ Image: k8smaster.qfusion.irds/irds/zookeeper-backup:v3.14.4 │ │ │ │ Image ID: sha256:47b43198... │ │ │ │ Pull Policy: IfNotPresent │ │ │ │ │ │ │ │ Resources: │ │ │ │ CPU Request: 250m │ │ │ │ CPU Limit: 500m │ │ │ │ Memory Request: 1Gi │ │ │ │ Memory Limit: 1Gi │ │ │ │ │ │ │ │ Security Context: │ │ │ │ Privileged: true │ │ │ │ Capabilities: │ │ │ │ - SYS_ADMIN │ │ │ │ - DAC_READ_SEARCH │ │ │ │ │ │ │ │ Volume Mounts: │ │ │ │ /conf - ConfigMap │ │ │ │ /data - PVC (共享主容器数据，用于备份) │ │ │ │ /mnt/log - EmptyDir │ │ │ │ /etc/localtime - HostPath │ │ │ └───────────────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────────┘

4.2 容器环境变量

zookeeper 容器环境变量
变量名值说明
ZOO_ROLEparticipant节点角色
ZOO_LOG_DIR/mnt/log日志目录
ZOO_LOG4J_PROPLOG,CONSOLE,ROLLINGFILE日志输出格式
ZK_SERVER_HEAP1536服务端堆大小(MB)
SERVER_JVMFLAGS-Xms512m -XX:+AlwaysPreTouch -Djute.maxbuffer=8388608 -XX:MaxGCPauseMillis=50JVM参数
ENABLE_ACLfalse是否启用ACL
ZOO_SUPER_ID* (from secret)超级用户ID
ZOO_SUPER_DIGEST* (from secret)超级用户摘要
CLIENT_JVMFLAGS* (empty)客户端JVM参数
ZU_JVMFLAGS* (empty)额外JVM参数

5. 存储架构

5.1 持久化卷声明 (PVC)

PVC 名称容量访问模式存储类绑定 PV绑定节点
data-zookeeper-e93aadcf-0-020GiRWOcsi-localpvdata-zookeeper-e93aadcf-0-0-qfusion1-f7aa7c0fqfusion1
data-zookeeper-e93aadcf-1-020GiRWOcsi-localpvdata-zookeeper-e93aadcf-1-0-qfusion4-fc233897qfusion4
data-zookeeper-e93aadcf-2-020GiRWOcsi-localpvdata-zookeeper-e93aadcf-2-0-qfusion3-5ea93ba0qfusion3
data-zookeeper-e93aadcf-observer-0-020GiRWOcsi-localpvdata-zookeeper-e93aadcf-observer-0-0-qfusion2-3b05d9e5qfusion2

5.2 存储目录结构

/mnt/log/ # EmptyDir - 日志目录 ├── server.log # ZooKeeper 服务日志 /data/ # PVC - 数据目录 ├── version-2/ # 快照和事务日志目录 │ ├── snapshot.0 # 快照文件 │ └── log.0 # 事务日志 ├── zoo.cfg.dynamic # 动态配置文件 └── myid # 节点ID文件 /conf/ # ConfigMap - 配置目录 ├── zoo.cfg # 主配置文件 ├── log4j.properties # 日志配置 ├── jaas.config # SASL认证配置 └── env.sh # 环境变量脚本

5.3 存储策略

属性值
存储类型Persistence (持久化)
Reclaim PolicyDelete (删除PVC时自动删除PV)
Volume ModeFilesystem
IOPS 配额2000

6. 网络架构

6.1 服务列表

服务名称类型Cluster IP端口选择器
zookeeper-e93aadcf-clientClusterIP246.102.223.1222181/TCPapp=zookeeper-e93aadcf,kind=ZookeeperMember
zookeeper-e93aadcf-admin-serverClusterIP246.99.195.1248080/TCPapp=zookeeper-e93aadcf,kind=ZookeeperMember
zookeeper-e93aadcf-headlessClusterIP (None)None2181,2888,3888,7000,8080app=zookeeper-e93aadcf,kind=ZookeeperMember
zookeeper-e93aadcf-client-lbClusterIP246.104.64.16031144/TCPapp=zookeeper-e93aadcf,kind=ZookeeperMember

6.2 端口映射

内部端口名称协议用途
2181clientTCP客户端连接端口，处理客户端请求
2888quorumTCP集群成员间通信端口，用于数据同步
3888leader-electionTCP领导者选举端口
7000metricsTCPPrometheus 指标导出端口
8080admin-serverTCPJetty 管理服务器端口，暴露命令和监控信息

6.3 网络端点

内部客户端端点
zookeeper-e93aadcf-client.qfusion-admin.svc.cluster.local:2181 246.102.223.122:2181
Headless 服务端点 (直接访问各节点)
zookeeper-e93aadcf-0.zookeeper-e93aadcf-headless.qfusion-admin.svc.cluster.local:2181 zookeeper-e93aadcf-1.zookeeper-e93aadcf-headless.qfusion-admin.svc.cluster.local:2181 zookeeper-e93aadcf-2.zookeeper-e93aadcf-headless.qfusion-admin.svc.cluster.local:2181 zookeeper-e93aadcf-observer-0.zookeeper-e93aadcf-headless.qfusion-admin.svc.cluster.local:2181

6.4 Endpoints 详情

Client Service Endpoints
245.0.0.94:2181 (Replica-0) 245.0.3.243:2181 (Replica-1) 245.0.2.35:2181 (Replica-2) 245.0.1.95:2181 (Observer-0)
Admin Server Endpoints
245.0.0.94:8080 (Replica-0) 245.0.3.243:8080 (Replica-1) 245.0.2.35:8080 (Replica-2) 245.0.1.95:8080 (Observer-0)
Headless Service Endpoints
245.0.0.94:2181,2888,3888,7000,8080 (Replica-0) 245.0.3.243:2181,2888,3888,7000,8080 (Replica-1) 245.0.2.35:2181,2888,3888,7000,8080 (Replica-2) 245.0.1.95:2181,2888,3888,7000,8080 (Observer-0)

7. ZooKeeper 配置详解

7.1 主配置文件 (zoo.cfg)

# 基础配置 skipACL=yes # 跳过ACL检查 standaloneEnabled=false # 禁用单机模式 dataDir=/data # 数据目录 admin.serverPort=8080 # 管理服务器端口 # 时间配置 (单位: 毫秒) tickTime=2000 # 心跳时间间隔 (2秒) initLimit=10 # 初始连接超时 (10*tickTime=20秒) syncLimit=2 # 同步超时 (2*tickTime=4秒) # 性能配置 globalOutstandingLimit=1000 # 全局未完成请求限制 preAllocSize=65536 # 预分配磁盘空间大小 (64KB) snapCount=10000 # 每N个事务写一次快照 commitLogCount=500 # 提交日志数量 snapSizeLimitInKb=4194304 # 快照大小限制 (4GB) # 连接配置 maxCnxns=0 # 最大连接数 (0=无限制) maxClientCnxns=60 # 每个客户端最大连接数 # 会话超时配置 minSessionTimeout=4000 # 最小会话超时 (4秒) maxSessionTimeout=40000 # 最大会话超时 (40秒) # 自动清理配置 autopurge.purgeInterval=1 # 自动清理间隔 (小时) autopurge.snapRetainCount=3 # 保留的快照数量 # 网络配置 quorumListenOnAllIPs=false # 不监听所有IP # 四字命令白名单 4lw.commands.whitelist=cons, envi, conf, crst, srvr, stat, mntr, ruok # Prometheus 监控配置 metricsProvider.exportJvmInfo=true # 导出JVM信息 metricsProvider.httpPort=7000 # 指标端口 metricsProvider.className=org.apache.zookeeper.metrics.prometheus.PrometheusMetricsProvider # 动态配置 reconfigEnabled=true # 启用动态重配置 dynamicConfigFile=/data/zoo.cfg.dynamic # 动态配置文件路径

7.2 环境配置 (env.sh)

#!/usr/bin/env bashDOMAIN=zookeeper-e93aadcf-headless.qfusion-admin.svc.cluster.localQUORUM_PORT=2888LEADER_PORT=3888CLIENT_HOST=zookeeper-e93aadcf-clientCLIENT_PORT=2181ADMIN_SERVER_HOST=zookeeper-e93aadcf-admin-serverADMIN_SERVER_PORT=8080CLUSTER_NAME=zookeeper-e93aadcfCLUSTER_SIZE=3

7.3 日志配置 (log4j.properties)

# 日志根配置 zookeeper.root.logger=CONSOLE,ROLLINGFILE zookeeper.console.threshold=INFO zookeeper.log.dir=/mnt/log zookeeper.log.file=server.log zookeeper.log.threshold=INFO # RollingFile 配置 log4j.appender.ROLLINGFILE.MaxFileSize=10MB # 单个日志文件最大10MB log4j.appender.ROLLINGFILE.MaxBackupIndex=10 # 保留10个历史文件

7.4 SASL 认证配置 (jaas.config)

Server { org.apache.zookeeper.server.auth.DigestLoginModule required user_qfusion="mcd@loHmiDdoI0E9"; }; Client { org.apache.zookeeper.server.auth.DigestLoginModule required username="qfusion" password="mcd@loHmiDdoI0E9"; };

8. 调度与亲和性

8.1 Pod 反亲和性规则

podAntiAffinity:preferredDuringSchedulingIgnoredDuringExecution:-weight:20podAffinityTerm:labelSelector:matchExpressions:-key:appoperator:Invalues:-zookeeper-e93aadcftopologyKey:kubernetes.io/hostname

说明: 尽量将 ZooKeeper Pod 调度到不同的节点上，权重为20（软约束）

8.2 节点分布

Pod节点Zone
zookeeper-e93aadcf-0-0qfusion1zone1
zookeeper-e93aadcf-1-0qfusion4-
zookeeper-e93aadcf-2-0qfusion3-
zookeeper-e93aadcf-observer-0-0qfusion2-

9. 安全与认证

9.1 ServiceAccount

属性值
名称dboperator
命名空间qfusion-admin
UIDaa4358dc-1705-4f1a-aec2-935076cb84a2

9.2 Secret

Secret 名称类型数据项
zookeeper-e93aadcf-aclOpaqueid, digest (超级用户认证信息)

9.3 安全上下文

ssh 容器 (备份容器)
privileged:truecapabilities:add:-SYS_ADMIN-DAC_READ_SEARCH

10. 监控与健康检查

10.1 健康检查配置

Liveness Probe (存活探针)
exec:command:[zookeeperLive.sh]initialDelaySeconds:10timeoutSeconds:10periodSeconds:10failureThreshold:3
Readiness Probe (就绪探针)
exec:command:[zookeeperReady.sh]initialDelaySeconds:10timeoutSeconds:10periodSeconds:10failureThreshold:3successThreshold:1

10.2 Prometheus 监控指标

指标类型端口路径
JVM Metrics7000/metrics
Admin Server8080/commands

10.3 四字命令

命令描述端口
ruok检查服务是否运行2181
srvr列出服务器详细信息2181
stat输出服务器统计信息2181
mntr输出监控指标2181
cons列出所有连接的客户端2181
envi打印服务环境信息2181
conf打印配置信息2181
crst重置连接统计信息2181

11. Operator 管理

11.1 ZooKeeper Operator

属性值
Pod 名称zookeeper-operator-bcc44b994-wmqq6
命名空间qfusion
镜像k8smaster.qfusion.irds/irds/zookeeper-operator:b4f4c95e…
节点qfusion3
ServiceAccountzookeeper-operator
CPU Request10m
CPU Limit500m
Memory Request10Ki
Memory Limit500Mi

11.2 Operator 启动参数

zookeeper-operator\-metrics-bind-address=127.0.0.1:6000

11.3 Web 管理界面

属性值
服务名称zookeeper-webserver
命名空间qfusion
类型Deployment
副本数2
Cluster IP246.98.8.26
端口9090

12. 资源汇总

12.1 单 Pod 资源

资源类型RequestLimit
CPU750m1.5 cores
Memory3Gi3Gi
Storage20Gi20Gi

12.2 集群总资源 (4 Pods)

资源类型RequestLimit
CPU3 cores6 cores
Memory12Gi12Gi
Storage80Gi80Gi

12.3 Operator 资源

资源类型RequestLimit
CPU10m500m
Memory10Ki500Mi

13. 自定义资源 (CRD)

13.1 ZookeeperCluster CR

apiVersion:zookeeper.pravega.io/v1beta1kind:ZookeeperClustermetadata:name:zookeeper-e93aadcfnamespace:qfusion-adminspec:replicas:3# Participant 副本数observerReplicas:1# Observer 副本数maxUnavailableReplicas:1# 最大不可用副本数image:repository:k8smaster.qfusion.irds/irds/zookeeper-3.7tag:v1.1.0pullPolicy:AlwaysstorageType:Persistence# 存储类型iopsQuota:2000# IOPS 配额persistence:reclaimPolicy:Deletespec:storageClassName:csi-localpvaccessModes:[ReadWriteOnce]resources:requests:storage:20Gi

13.2 集群状态

status:replicas:4# 总副本数readyReplicas:4# 就绪副本数internalClientEndpoint:246.102.223.122:2181externalClientEndpoint:N/Amembers:ready:-zookeeper-e93aadcf-0-0-zookeeper-e93aadcf-1-0-zookeeper-e93aadcf-2-0-zookeeper-e93aadcf-observer-0-0conditions:-type:PodsReadystatus:"True"-type:Errorstatus:"False"-type:Upgradingstatus:"False"

14. 标签 (Labels)

14.1 集群级别标签

KeyValue
AppNamezookeeper-e93aadcf
CreatedBywoqutech.com
DBBranchzookeeperv3.7.1
DBTypezookeeper
ResourceUseTypeDatabase
TenantId847798ee3db44716b6357b04e5a55c16
appzookeeper-e93aadcf
releasezookeeper-e93aadcf

14.2 Pod 额外标签

KeyValue范围
TypeDatabase所有 Pod
kindZookeeperMember所有 Pod
replica0/1/2Participant Pod
zk_roleParticipant/Observer所有 Pod
qfusion/zonezone1Replica-0

15. Finalizers

Finalizer说明
cleanUpZookeeperPVC删除集群时自动清理PVC资源

16. 连接示例

16.1 客户端连接字符串

# 集群连接字符串 (推荐)zookeeper-e93aadcf-client.qfusion-admin.svc.cluster.local:2181# 直连所有节点 (高可用)zookeeper-e93aadcf-0.zookeeper-e93aadcf-headless.qfusion-admin.svc.cluster.local:2181,\zookeeper-e93aadcf-1.zookeeper-e93aadcf-headless.qfusion-admin.svc.cluster.local:2181,\zookeeper-e93aadcf-2.zookeeper-e93aadcf-headless.qfusion-admin.svc.cluster.local:2181

16.2 获取集群状态

# 设置 KUBECONFIGexportKUBECONFIG=/bpx/.145-admin.conf# 查看 ZooKeeper 集群状态kubectl get ZookeeperCluster zookeeper-e93aadcf-nqfusion-admin# 查看 Pods 状态kubectl get pods-nqfusion-admin-lapp=zookeeper-e93aadcf# 查看服务kubectl get svc-nqfusion-admin-lapp=zookeeper-e93aadcf# 查看 PVCkubectl get pvc-nqfusion-admin-lapp=zookeeper-e93aadcf# 连接到 ZooKeeper (需要先 exec 进入 Pod)kubectlexec-it-nqfusion-admin zookeeper-e93aadcf-0-0-czookeeper -- /bin/bash

17. 运维参考

17.1 常用命令

# 四字命令检查echoruok|nc245.0.0.942181# 检查节点是否正常echosrvr|nc245.0.0.942181# 获取服务器详情echomntr|nc245.0.0.942181# 获取监控指标echocons|nc245.0.0.942181# 列出客户端连接# Prometheus 指标curlhttp://245.0.0.94:7000/metrics# Admin Servercurlhttp://245.0.0.94:8080/commands

17.2 日志查看

# ZooKeeper 主容器日志kubectl logs-nqfusion-admin zookeeper-e93aadcf-0-0-czookeeper# 实时跟踪日志kubectl logs-f-nqfusion-admin zookeeper-e93aadcf-0-0-czookeeper# 查看备份容器日志kubectl logs-nqfusion-admin zookeeper-e93aadcf-0-0-cssh

17.3 故障排查

症状可能原因排查方法
Pod 无法启动资源不足、镜像拉取失败kubectl describe pod
连接超时网络问题、防火墙kubectl get svc, endpoints
数据丢失PVC 问题kubectl get pvc, pv
领导者选举失败网络分区、节点故障检查节点状态和日志

18. 附录

18.1 文档版本

版本日期说明
1.02025-12-24初始版本

18.2 相关文档

  • ZooKeeper 官方文档
  • QFusion 平台文档
  • Kubernetes StatefulSet 文档

本文档由 AI 自动生成，基于 Kubernetes 集群 145 的实时配置

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/4/16 23:06:53

我发现动态因果图补全EHR缺失项慢病管理预警准度飙升

📝 博客主页：Jax的CSDN主页 目录当AI变成我的私人医生：那些年我们一起追过的健康革命 我和AI医生的第一次约会 医疗AI的"中年危机" 当AI遇上中医：玄学还是科学？ 医疗AI的"社交尴尬" 给AI医生的忠告…

作者头像 李华
网站建设 2026/4/19 0:09:38

【毕业设计】基于SpringBoot+Vue的高校志愿活动管理系统的设计与实现(源码+文档+远程调试，全bao定制等)

博主介绍：✌️码农一枚 ，专注于大学生项目实战开发、讲解和毕业🚢文撰写修改等。全栈领域优质创作者，博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战 ✌️技术范围：&am…

作者头像 李华
网站建设 2026/5/1 5:00:56

基于SpringBoot的高校党员信息管理系统（毕业设计项目源码+文档）

课题摘要在高校党员管理精细化、党务工作数字化需求下，传统党员信息管理存在 “档案更新不及时、信息查询低效、统计分析困难” 的痛点，基于 SpringBoot 构建的高校党员信息管理系统，适配学生党员、教工党员、党务管理员、学院党委、校组织部…

作者头像 李华
网站建设 2026/4/30 17:48:12

基于SpringBoot的高校社团管理系统（毕业设计项目源码+文档）

课题摘要在高校社团规范化运营、活动管理精细化需求下，传统社团管理存在 “成员管理混乱、活动审批繁琐、经费监管低效” 的痛点，基于 SpringBoot 构建的高校社团管理系统，适配社团成员、社团负责人、社联管理员、学校团委等角色，…

作者头像 李华
网站建设 2026/4/21 19:59:55

基于Android的体育运动赛事竞赛报名成绩APP设计_tv700 小程序

文章目录具体实现截图主要技术与实现手段系统设计与实现的思路系统设计方法java类核心代码部分展示结论源码lw获取/同行可拿货,招校园代理 ：文章底部获取博主联系方式！具体实现截图 本系统（程序源码数据库调试部署讲解）带文档1万…

作者头像 李华
网站建设 2026/4/25 4:55:48

Linux嵌入式系统在智能家居中的具体应用案例有哪些？能否详细介绍其技术实现？

Linux嵌入式系统在智能家居中的应用案例主要包括智能门禁系统、智能猫眼系统、智能家居控制平台等核心场景，这些系统通过Linux的稳定性和开源特性实现了家庭安防、环境监测和设备控制的智能化管理。一、智能门禁系统系统架构与硬件设计智能门禁系统采用基于ARM的嵌入…

作者头像 李华