服务注册与分布式协调 / 系统课时
运行环境与安装包
运行环境与安装包
这一课完成 ZooKeeper 安装前的最小准备:确认 Java 可执行,下载课程固定版本的二进制发行包,完成 SHA-512 完整性校验并解压验证目录结构,确保后续配置不是建立在损坏或错误的安装包上。
学习目标
- 确认 JDK 17 已安装,并能在当前 Shell 中直接调用。
- 下载 ZooKeeper 3.9.5 的二进制发行包,而不是源码包。
- 使用官方 SHA-512 文件校验下载结果,并验证解压后的关键文件。
先确认 Java
ZooKeeper 服务端运行在 JVM 上。本课程统一使用 JDK 17,因此在下载 ZooKeeper 前先确认 java 和 javac 都能执行。若只安装了 JRE 或 PATH 指向错误版本,后续排查会混入不必要的环境变量问题。
java -version 2>&1 | head -n 1
javac -version预期输出中的具体补丁版本和构建信息可能不同,但两个命令都应成功,并且主版本为 17。
openjdk version "17.<VERSION>" <TIME>
javac 17.<VERSION>如果系统存在多个 JDK,应先修正 JAVA_HOME 和 PATH,再重新执行检查。不要等到 ZooKeeper 启动失败后才处理 Java 版本混乱。
下载二进制发行包
以下命令以 Linux Bash 为例,把 ZooKeeper 3.9.5 下载到当前目录,同时取得对应的 SHA-512 校验文件。文件名中的 -bin 表示已经构建好的二进制发行包;不带 -bin 的压缩包是源码,不适合作为本课程的直接运行包。
VERSION=3.9.5
FILE="apache-zookeeper-${VERSION}-bin.tar.gz"
BASE_URL="https://downloads.apache.org/zookeeper/zookeeper-${VERSION}"
curl -fLO "${BASE_URL}/${FILE}"
curl -fLO "${BASE_URL}/${FILE}.sha512"
printf '%s\n' "$FILE" "$FILE.sha512"忽略 curl 的下载进度信息,命令最后应打印这两个文件名。
apache-zookeeper-3.9.5-bin.tar.gz
apache-zookeeper-3.9.5-bin.tar.gz.sha512校验 SHA-512
下载完成后先校验完整性,再解压。sha512sum -c 会读取校验文件中的期望摘要,并重新计算本地压缩包摘要;只有两者一致时才返回 OK。
VERSION=3.9.5
FILE="apache-zookeeper-${VERSION}-bin.tar.gz"
sha512sum -c "$FILE.sha512"预期输出:
apache-zookeeper-3.9.5-bin.tar.gz: OK解压并检查关键文件
校验成功后再解压,并确认启动脚本与示例配置都存在。这里只验证发行包结构,不启动服务,因此不会占用 2181 端口。
VERSION=3.9.5
FILE="apache-zookeeper-${VERSION}-bin.tar.gz"
tar -xzf "$FILE"
ZK_HOME="$PWD/apache-zookeeper-${VERSION}-bin"
test -x "$ZK_HOME/bin/zkServer.sh"
test -f "$ZK_HOME/conf/zoo_sample.cfg"
printf 'ZK_HOME=%s\npackage-ready\n' "$ZK_HOME"预期输出中的路径取决于当前工作目录。
ZK_HOME=<PATH>/apache-zookeeper-3.9.5-bin
package-ready如果 test 失败而没有打印 package-ready,应先确认下载的是 -bin.tar.gz,再检查解压目录是否完整。不要手工补造缺失脚本,因为这会掩盖下载错误。
保留一个干净的安装基线
建议把经过校验的原始压缩包保留在实验目录的 packages 子目录中,并把解压目录视为只读安装基线。后续真正需要变化的是 conf、dataDir、日志目录和各节点身份文件,而不是反复修改发行包本身。
完成这一课后,安装环境应满足三个条件:JDK 17 可直接调用、二进制压缩包 SHA-512 校验通过、解压目录中的 zkServer.sh 与 zoo_sample.cfg 都存在。满足这三个条件后,再进入单机配置与启动,问题边界会清晰得多。