消息队列 / 系统课时

版本与环境准备

版本与环境准备

开始写生产者和消费者之前,先把 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:

bash
docker --version
docker info --format '{{.ServerVersion}}'

预期输出:

text
Docker version <VALUE>, build <ID>
<VALUE>

实际版本号和构建 ID 会不同;如果第二条命令失败,应先解决 Docker Engine 未启动、权限不足或远程上下文错误,再继续安装 RabbitMQ。

启动 RabbitMQ 4.3 并核验运行时

为避免默认 guest 用户的远程访问限制,实验环境显式创建课程账号,并映射 AMQP 与 Management 端口:

bash
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

预期输出:

text
<ID>

容器启动是异步的。等待节点真正就绪后,再读取 RabbitMQ 与 Erlang 版本:

bash
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

预期输出:

text
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 中激活对应虚拟环境。

bash
python3 -m venv .venv
. .venv/bin/activate
python -m pip install pika
python -c "import pika; print(pika.__version__)"

预期结果:

text
<VALUE>

只要安装命令无错误结束,最后一行会输出当前 Pika 版本。随后在同一虚拟环境中执行最小连接测试:

bash
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

预期输出:

text
True

如果连接被拒绝,先重新执行 rabbitmq-diagnostics -q ping,再检查 5672 端口是否被其他程序占用或 Docker 端口映射是否存在;如果 Broker 能启动但版本核验异常,则应回到 RabbitMQ 与 Erlang 的兼容关系处理,而不是先修改客户端代码。

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

目录与阅读设置

阅读设置

17

记录一个想法

版本与环境准备

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

登录哪都通