服务注册与分布式协调 / 系统课时

课程实验环境规划

课程实验环境规划

本课先把后续实验需要的单机、伪集群、三节点集群和 Java 客户端统一规划好,重点解决端口、目录、进程数量与机器边界冲突,完成后即可按同一套约定继续安装、配置和编程实验。

学习目标

  • 区分单机、伪集群和真实三节点集群各自适合验证的问题。
  • 规划客户端端口、选举端口、通信端口和数据目录,避免实验互相干扰。
  • 建立统一实验目录,并确认 Java 与 Maven 工具链可用。

固定实验基线

为了让后续命令和配置可以直接复用,本课程实验统一使用 JDK 17、ZooKeeper 3.9.5 和 Maven 3.9.x。操作系统以 Linux 或 WSL 的 Bash 环境为基线;如果使用 macOS,也应保持相同目录逻辑和端口规划。

建议至少预留 2 个 CPU 核心、4 GB 可用内存和 2 GB 磁盘空间。三节点真实集群更适合准备三台虚拟机或三台独立主机;资源有限时,可以先完成单机与伪集群,再切换到三节点环境。

四种环境分别解决什么问题

单机模式只有一个 ZooKeeper 进程,适合熟悉启动、CLI、znode 和 Watch 等基础操作。伪集群是在同一台机器上启动三个独立进程,用不同端口和数据目录模拟多数派、Leader 选举与节点上下线。

真实三节点集群把三个服务进程放到三台机器上,用来观察网络边界、主机故障和跨节点通信。Java 示例项目不是第四个 ZooKeeper 集群,而是独立客户端,它通过连接串访问前面任意一种环境。

单机、伪集群、三节点与 Java 客户端的实验关系

端口与目录不要混用

单机环境固定使用客户端端口 2181。伪集群的三个实例可分别使用 2181、2182、2183 作为客户端端口,同时为每个实例分配互不重复的 quorum 与 election 端口。真实三节点集群因为运行在不同主机上,可以在每台机器复用相同的 2181、2888、3888。

数据目录也必须独立。尤其是伪集群,每个实例都要有自己的 dataDir 和 myid;三个进程共用同一数据目录会直接破坏节点身份与持久化状态。

环境 ZooKeeper 进程 主机数量 客户端端口建议 主要用途
单机 1 1 2181 基础命令与数据模型
伪集群 3 1 2181、2182、2183 选举、多数派与故障实验
三节点集群 3 3 每台均 2181 网络与真实主机故障
Java 示例项目 0 1 不监听 ZooKeeper 端口 客户端 API 与业务示例

建立统一实验目录

先创建课程根目录,并检查 Java 与 Maven 是否已经在 PATH 中。下面命令只创建目录,不会启动任何 ZooKeeper 进程。

bash
java -version 2>&1 | head -n 1
mvn -version | head -n 1
mkdir -p "$HOME/zk-lab"/{packages,standalone,pseudo,ensemble,java-client}
printf '%s\n' "$HOME/zk-lab"

预期输出中版本号和用户目录会因机器不同而变化,重点是两个工具都能正常返回版本,最后一行能打印实验根目录。

text
openjdk version "<VERSION>" <TIME>
Apache Maven <VERSION>
<PATH>/zk-lab

如果 java 或 mvn 提示 command not found,应先补齐工具链再继续;如果端口已经被占用,则先停止旧实验进程或调整当前实验端口,不要让两套环境同时争用同一端口。

后续实验的切换原则

同一台机器上默认一次只启用一种 ZooKeeper 环境:做基础操作时启单机,验证选举时停掉单机再启伪集群,做真实故障演练时改用三台独立节点。Java 示例项目只作为客户端存在,可以通过修改连接串在不同环境之间切换。

只要目录互相隔离、端口不冲突、三节点身份独立,后续每个实验都能在可预测的起点上重复执行;遇到问题时也能快速判断是配置错误、端口冲突还是节点边界不符合预期。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

课程实验环境规划

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通