消息队列 / 系统课时
版本与环境准备
版本与环境准备
开始写生产者和消费者之前,先把 RabbitMQ 4.3、Erlang/OTP、Docker 与客户端运行时的版本关系理顺。本节使用官方 Docker 镜像隔离 Erlang 依赖,并通过命令验证 Broker、Erlang 和 Python 客户端都能正常工作。
学习目标
- 理解 RabbitMQ 与 Erlang/OTP 不是可以任意组合的两个独立版本。
- 用 Docker 启动 RabbitMQ 4.3 并核验服务与运行时版本。
- 准备可复现的 Python 客户端环境并完成一次连接测试。
先锁定版本关系
RabbitMQ Server 运行在 Erlang/OTP 之上,因此原生安装时必须先确认目标 RabbitMQ 补丁版本支持的 Erlang/OTP 范围,再决定运行时版本。不要把“系统里能装到的最新 Erlang”直接当作兼容版本;集群节点还应尽量保持相同的 Erlang 主版本和一致的 RabbitMQ 补丁版本。
本教程优先使用 rabbitmq:4.3-management 容器镜像。镜像把 RabbitMQ 与匹配的 Erlang 运行时封装在一起,适合学习和本地实验;团队项目需要更强可重复性时,应进一步固定到明确的 4.3 补丁标签或镜像摘要。
准备命令行与 Docker
以下命令以 Bash 为例。先确认 Docker CLI 能连接到 Docker Engine:
docker --version
docker info --format '{{.ServerVersion}}'预期输出:
Docker version <VALUE>, build <ID>
<VALUE>实际版本号和构建 ID 会不同;如果第二条命令失败,应先解决 Docker Engine 未启动、权限不足或远程上下文错误,再继续安装 RabbitMQ。
启动 RabbitMQ 4.3 并核验运行时
为避免默认 guest 用户的远程访问限制,实验环境显式创建课程账号,并映射 AMQP 与 Management 端口:
docker run -d --name rabbitmq43 --hostname rabbitmq43 \
-e RABBITMQ_DEFAULT_USER=course \
-e RABBITMQ_DEFAULT_PASS=coursepass \
-p 5672:5672 \
-p 15672:15672 \
rabbitmq:4.3-management预期输出:
<ID>容器启动是异步的。等待节点真正就绪后,再读取 RabbitMQ 与 Erlang 版本:
until docker exec rabbitmq43 rabbitmq-diagnostics -q ping; do sleep 2; done
docker exec rabbitmq43 rabbitmq-diagnostics server_version -q
docker exec rabbitmq43 rabbitmq-diagnostics erlang_version -q预期输出:
Ping succeeded
4.3.<VALUE>
<ERLANG_VERSION>server_version 必须保持在 4.3 系列;erlang_version 用来确认容器中实际运行的 Erlang/OTP。以后排查“文档说支持、机器却启动失败”时,这两个值比只看安装包文件名更可靠。
准备 Python 客户端环境
以下示例使用 Pika 作为 AMQP 0-9-1 客户端。Linux、macOS 或 WSL 可直接执行;Windows 可用 py 替换 python3,并在 PowerShell 中激活对应虚拟环境。
python3 -m venv .venv
. .venv/bin/activate
python -m pip install pika
python -c "import pika; print(pika.__version__)"预期结果:
<VALUE>只要安装命令无错误结束,最后一行会输出当前 Pika 版本。随后在同一虚拟环境中执行最小连接测试:
python - <<'PY'
import pika
credentials = pika.PlainCredentials("course", "coursepass")
parameters = pika.ConnectionParameters(
host="127.0.0.1",
port=5672,
credentials=credentials,
)
connection = pika.BlockingConnection(parameters)
print(connection.is_open)
connection.close()
PY预期输出:
True如果连接被拒绝,先重新执行 rabbitmq-diagnostics -q ping,再检查 5672 端口是否被其他程序占用或 Docker 端口映射是否存在;如果 Broker 能启动但版本核验异常,则应回到 RabbitMQ 与 Erlang 的兼容关系处理,而不是先修改客户端代码。