架构与系统设计 / 系统课时
用 Docker 搭好消息实验环境
用 Docker 搭好消息实验环境
消息实验需要能重复启动、检查和清理的环境,而不是只成功运行一次容器。本篇先用一个 RabbitMQ 节点建立 Docker Compose 基线,验证端口、健康检查和数据卷;不同中间件可按相同原则建立独立实验项目。
学习目标
- 用固定版本的 Compose 配置启动本地消息节点。
- 分别验证容器健康状态和宿主机访问。
- 完成保留数据的重建,并区分日常拆除与彻底重置。
前置检查先于启动
先安装并启动 Docker。Windows、macOS 可使用包含 Compose 的 Docker Desktop;Linux 也可使用 Docker Engine 加 Compose 插件。以下命令在 Bash 中执行,Windows 可使用已接入 Docker 的 WSL 终端,并准备好 curl。([Docker Documentation][4])
# 先确认连接的是 Linux 容器引擎,再检查 Compose 是否可用
docker info --format '{{.OSType}}' &&
docker compose version预期输出如下,<VERSION> 是实际安装版本,不要求与其他机器完全相同。
linux
Docker Compose version <VERSION>若第一条无法连接引擎,先启动 Docker;若 Compose 子命令不存在,先补齐插件。另建空目录 eda-lab,后续文件和命令都放在该目录,避免误操作其他项目。
固定镜像、入口和数据卷
将下面内容保存为完整的 compose.yaml。本例使用已发布的 rabbitmq:4.3.6-management;管理插件随镜像启用。固定主机名是为了避免容器重建后节点名称变化,导致数据目录对应关系改变。([Docker Hub][5])
name: eda-lab
services:
rabbitmq:
image: rabbitmq:4.3.6-management
# 固定节点身份,配合命名卷复用数据
hostname: rabbitmq-lab
environment:
RABBITMQ_DEFAULT_USER: lab
RABBITMQ_DEFAULT_PASS: lab-local-only
ports:
# 仅绑定宿主机回环地址,不向所有网卡发布
- "127.0.0.1:5672:5672"
- "127.0.0.1:15672:15672"
volumes:
- rabbitmq-data:/var/lib/rabbitmq
healthcheck:
test: ["CMD-SHELL", "rabbitmq-diagnostics -q check_running && rabbitmq-diagnostics -q check_port_connectivity"]
interval: 15s
timeout: 10s
retries: 8
start_period: 20s
volumes:
rabbitmq-data:预期结果:应用配置后创建一个服务、默认网络和命名卷。健康检查验证 RabbitMQ 应用运行及监听端口连通;它不是消息投递与消费成功的证明。下一节用命令检查实际状态。([RabbitMQ][6])
本例的端口和目录是固定配置值,不是需要替换的占位符。宿主机客户端连接 127.0.0.1:5672;同一 Compose 网络内的应用应连接 rabbitmq:5672,不能把容器内的 localhost 当成宿主机。([Docker Documentation][7])
启动后检查两个入口
先校验配置,再等待健康检查通过。命令用 && 连接,前一步失败就不会继续输出误导性的成功状态。
# 不把“容器已启动”直接当成服务就绪
docker compose config --quiet &&
docker compose up -d --wait --wait-timeout 180 &&
docker compose ps --format '{{.Service}} {{.State}} {{.Health}}'预期输出:前面可能出现拉取和创建进度,最后一条查询应输出以下状态。
rabbitmq running healthy配置了健康检查后,--wait 会等待服务达到健康状态;--wait-timeout 限制等待时长。状态查询中的服务名、运行状态与健康状态分别对应模板中的三个字段。([Docker Documentation][8])
再从宿主机调用管理 API,检查端口映射、凭据和资源告警情况。
# 同时显示响应体和状态码,不用网页是否打开代替验证
curl -fsS --max-time 10 -u lab:lab-local-only -w '\nHTTP %{http_code}\n' http://127.0.0.1:15672/api/health/checks/alarms预期输出:没有资源告警时,HTTP 状态码为 200,响应体中的 status 为 ok;JSON 空白格式可能不同。([RabbitMQ][9])
{"status":"ok"}
HTTP 200这两项检查分别覆盖容器内部状态和宿主机管理入口,尚未验证 AMQP 客户端认证、发布路由及消费确认,不能据此宣称整条业务链路已经跑通。
拆除与重建不能混同于删数据
普通 down 删除本项目容器和网络,但保留命名卷;随后以同一项目名启动,可以重新挂载该卷。带 --volumes 的 down 则会删除配置中声明的命名卷,两者不能混用。([Docker Documentation][10])

执行一次保留数据的拆除和恢复,检查卷名与服务状态:
# 中间检查卷仍存在;任何一步失败都停止后续操作
docker compose down &&
docker volume inspect eda-lab_rabbitmq-data --format '{{.Name}}' &&
docker compose up -d --wait --wait-timeout 180 &&
docker compose ps --format '{{.Service}} {{.State}} {{.Health}}'预期输出中的两条查询结果如下,中间还会穿插容器和网络创建进度。卷检查失败时,不应继续把恢复视为成功。([Docker Documentation][11])
eda-lab_rabbitmq-data
rabbitmq running healthy这验证了卷保留和服务重建,不等于验证消息持久化。消息能否恢复,还取决于队列、消息及发布确认等配置。([RabbitMQ][3])
失败时先保留现场
| 现象 | 优先检查与修复 |
|---|---|
| 镜像拉取失败 | 查看拉取错误,检查 Docker 的网络、代理或仓库访问,不先修改业务配置。 |
| 端口被占用 | 修改 ports 中宿主机一侧的端口,并同步修改客户端与验证命令。 |
| 一直不健康 | 查看 RabbitMQ 日志和健康检查输出,先定位启动错误、监听异常或资源问题。 |
| 更改环境变量后仍认证失败 | 核对是否复用了旧数据卷;初始化凭据不会自动覆盖已有用户。 |
查看日志时可使用 docker compose logs --tail 80 rabbitmq;它读取最近日志,不会修复服务。初始化用户只在首次创建节点数据时生成,改默认密码变量不能当作现有账号的改密操作。([Docker Documentation][12])
验收时保留配置文件,并确认“健康启动、宿主机检查、保留卷重建”三项均通过;这样才有一份可以重复使用的实验基线。