架构与系统设计 / 系统课时

用 Docker 搭好消息实验环境

用 Docker 搭好消息实验环境

消息实验需要能重复启动、检查和清理的环境,而不是只成功运行一次容器。本篇先用一个 RabbitMQ 节点建立 Docker Compose 基线,验证端口、健康检查和数据卷;不同中间件可按相同原则建立独立实验项目。

学习目标

  • 用固定版本的 Compose 配置启动本地消息节点。
  • 分别验证容器健康状态和宿主机访问。
  • 完成保留数据的重建,并区分日常拆除与彻底重置。

前置检查先于启动

先安装并启动 Docker。Windows、macOS 可使用包含 Compose 的 Docker Desktop;Linux 也可使用 Docker Engine 加 Compose 插件。以下命令在 Bash 中执行,Windows 可使用已接入 Docker 的 WSL 终端,并准备好 curl。([Docker Documentation][4])

bash
# 先确认连接的是 Linux 容器引擎,再检查 Compose 是否可用
docker info --format '{{.OSType}}' &&
docker compose version

预期输出如下,<VERSION> 是实际安装版本,不要求与其他机器完全相同。

text
linux
Docker Compose version <VERSION>

若第一条无法连接引擎,先启动 Docker;若 Compose 子命令不存在,先补齐插件。另建空目录 eda-lab,后续文件和命令都放在该目录,避免误操作其他项目。

固定镜像、入口和数据卷

将下面内容保存为完整的 compose.yaml。本例使用已发布的 rabbitmq:4.3.6-management;管理插件随镜像启用。固定主机名是为了避免容器重建后节点名称变化,导致数据目录对应关系改变。([Docker Hub][5])

yaml
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])

启动后检查两个入口

先校验配置,再等待健康检查通过。命令用 && 连接,前一步失败就不会继续输出误导性的成功状态。

bash
# 不把“容器已启动”直接当成服务就绪
docker compose config --quiet &&
docker compose up -d --wait --wait-timeout 180 &&
docker compose ps --format '{{.Service}} {{.State}} {{.Health}}'

预期输出:前面可能出现拉取和创建进度,最后一条查询应输出以下状态。

text
rabbitmq running healthy

配置了健康检查后,--wait 会等待服务达到健康状态;--wait-timeout 限制等待时长。状态查询中的服务名、运行状态与健康状态分别对应模板中的三个字段。([Docker Documentation][8])

再从宿主机调用管理 API,检查端口映射、凭据和资源告警情况。

bash
# 同时显示响应体和状态码,不用网页是否打开代替验证
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])

text
{"status":"ok"}
HTTP 200

这两项检查分别覆盖容器内部状态和宿主机管理入口,尚未验证 AMQP 客户端认证、发布路由及消费确认,不能据此宣称整条业务链路已经跑通。

拆除与重建不能混同于删数据

普通 down 删除本项目容器和网络,但保留命名卷;随后以同一项目名启动,可以重新挂载该卷。带 --volumes 的 down 则会删除配置中声明的命名卷,两者不能混用。([Docker Documentation][10])

容器拆除、数据卷保留与重建的关系

执行一次保留数据的拆除和恢复,检查卷名与服务状态:

bash
# 中间检查卷仍存在;任何一步失败都停止后续操作
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])

text
eda-lab_rabbitmq-data
rabbitmq running healthy

这验证了卷保留和服务重建,不等于验证消息持久化。消息能否恢复,还取决于队列、消息及发布确认等配置。([RabbitMQ][3])

失败时先保留现场

现象 优先检查与修复
镜像拉取失败 查看拉取错误,检查 Docker 的网络、代理或仓库访问,不先修改业务配置。
端口被占用 修改 ports 中宿主机一侧的端口,并同步修改客户端与验证命令。
一直不健康 查看 RabbitMQ 日志和健康检查输出,先定位启动错误、监听异常或资源问题。
更改环境变量后仍认证失败 核对是否复用了旧数据卷;初始化凭据不会自动覆盖已有用户。

查看日志时可使用 docker compose logs --tail 80 rabbitmq;它读取最近日志,不会修复服务。初始化用户只在首次创建节点数据时生成,改默认密码变量不能当作现有账号的改密操作。([Docker Documentation][12])

验收时保留配置文件,并确认“健康启动、宿主机检查、保留卷重建”三项均通过;这样才有一份可以重复使用的实验基线。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Docker 搭好消息实验环境

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

登录哪都通