智能制造与工业软件 / 系统课时

用 Compose 启动消息代理和时序库

用 Compose 启动消息代理和时序库

本课用 Docker Compose 在开发机上启动 Mosquitto MQTT 代理和 InfluxDB 2 时序库,统一镜像版本、端口、网络和持久化目录。完成后可以重复启动环境,验证消息收发,并检查数据库和容器健康状态。

学习目标

  • 编写可复用的 compose.yaml、Mosquitto 配置和 InfluxDB 初始化参数。
  • 区分宿主机端口、容器服务名、内部网络与持久化数据卷。
  • 通过 Compose 状态、MQTT 收发和 InfluxDB 探活验证部署。

检查 Docker 并准备配置文件

以下命令适用于 Linux、macOS 或 Windows 的 WSL2 Bash,要求 Docker Engine 正在运行且安装 Docker Compose v2。先确认版本,再建立工作目录;Windows 使用 Docker Desktop 时需先启动应用。

bash
docker version --format '{{.Server.Version}}'
docker compose version
mkdir -p iiot-lab/mosquitto/config
cd iiot-lab

预期结果:前两条命令分别打印 Docker Engine 和 Compose 的实际版本号,后两条命令无报错,当前目录变为 iiot-lab。版本号因机器而异;如果提示无法连接 Docker daemon,先启动 Docker Engine。

新建 mosquitto/config/mosquitto.conf。Mosquitto 2.x 配置显式监听,否则容器外客户端可能无法连接。

conf
listener 1883
allow_anonymous true
persistence true
persistence_location /mosquitto/data/
log_dest stdout

这份配置让 MQTT 代理监听容器内 TCP 1883,将持久化会话与保留消息写到 /mosquitto/data/,日志输出给 docker compose logs。匿名连接只用于本地隔离实验,不能照搬到工厂网络。

定义数据库初始化和 Compose 服务

在 iiot-lab 下新建 .env。以下是教学用的示例凭据,实际运行前应自行替换,不要提交版本库。

dotenv
INFLUXDB_ADMIN_PASSWORD=DemoLocal_2026_ChangeMe!
INFLUXDB_ADMIN_TOKEN=demo-operator-token-change-me-2026

再新建 compose.yaml。明确固定 Mosquitto 2.0.22 和 InfluxDB 2.7.12,避免使用会改变主版本的 latest;初始化环境变量适用于 InfluxDB OSS 2.x,而非 InfluxDB 3。

yaml
name: iiot-lab

services:
  mqtt:
    image: eclipse-mosquitto:2.0.22
    ports:
      - "127.0.0.1:1883:1883"
    volumes:
      - ./mosquitto/config/mosquitto.conf:/mosquitto/config/mosquitto.conf:ro
      - mqtt_data:/mosquitto/data
    networks: [iiot]
    healthcheck:
      test: ["CMD", "mosquitto_pub", "-h", "127.0.0.1", "-t", "lab/health", "-m", "ok"]
      interval: 10s
      timeout: 3s
      retries: 5
      start_period: 5s

  influxdb:
    image: influxdb:2.7.12
    ports:
      - "127.0.0.1:8086:8086"
    environment:
      DOCKER_INFLUXDB_INIT_MODE: setup
      DOCKER_INFLUXDB_INIT_USERNAME: labadmin
      DOCKER_INFLUXDB_INIT_PASSWORD: ${INFLUXDB_ADMIN_PASSWORD}
      DOCKER_INFLUXDB_INIT_ORG: plant-lab
      DOCKER_INFLUXDB_INIT_BUCKET: telemetry
      DOCKER_INFLUXDB_INIT_ADMIN_TOKEN: ${INFLUXDB_ADMIN_TOKEN}
    volumes:
      - influxdb_data:/var/lib/influxdb2
      - influxdb_config:/etc/influxdb2
    networks: [iiot]
    healthcheck:
      test: ["CMD", "influx", "ping", "--host", "http://127.0.0.1:8086"]
      interval: 10s
      timeout: 3s
      retries: 10
      start_period: 20s

volumes:
  mqtt_data:
  influxdb_data:
  influxdb_config:

networks:
  iiot:
    driver: bridge

mqtt_data、influxdb_data 和 influxdb_config 是 Docker 管理的命名卷,分别挂载到容器内的数据或配置目录;容器重建不会自动清除它们。InfluxDB 的用户 labadmin、组织 plant-lab 和存储桶 telemetry 仅在空数据卷首次初始化时创建,修改 .env 不会重置已有账号。

识别端口、服务名和存储边界

宿主机只通过 127.0.0.1:1883 连接 MQTT,通过 http://127.0.0.1:8086 打开 InfluxDB;同一个 Compose 网络内的后续采集程序应使用 mqtt:1883 和 http://influxdb:8086。127.0.0.1 在容器内部指容器自己,不指另一服务。

Compose 本地工业接入环境的容器网络与数据卷

启动容器并执行双重验证

在包含 compose.yaml 的目录运行以下命令。先验证配置,再后台启动并等待服务健康,最后查看状态和端口映射。

bash
docker compose config --quiet
docker compose up -d --wait
docker compose ps

预期结果:配置校验无输出且退出码为 0;镜像拉取和初始化完成后,mqtt 与 influxdb 都显示 Up 和 healthy,端口分别映射到宿主机的 127.0.0.1:1883、127.0.0.1:8086。如果等待健康状态超时,通过服务日志进一步定位。

用镜像内自带的客户端发送一条保留消息,再订阅同一主题。-r 确保先发布后订阅也能收到,-C 1 表示收到一条后退出。

bash
docker compose exec -T mqtt mosquitto_pub -h 127.0.0.1 -t factory/line1/temp -m "23.5" -r
docker compose exec -T mqtt mosquitto_sub -h 127.0.0.1 -t factory/line1/temp -C 1 -W 5

预期输出:

text
23.5

检查 InfluxDB 健康接口:

bash
docker compose exec -T influxdb influx ping --host http://127.0.0.1:8086

预期输出:

text
OK

再用浏览器打开 http://127.0.0.1:8086,以 labadmin 和 .env 中的密码登录,核对组织 plant-lab 下存在 telemetry 存储桶。这比只看到容器运行更能确认首次初始化已完成。

检查持久化与排除启动失败

先重启服务并等待恢复健康,再重新订阅保留主题:

bash
docker compose restart
docker compose up -d --wait
docker compose exec -T mqtt mosquitto_sub -h 127.0.0.1 -t factory/line1/temp -C 1 -W 5

预期输出仍为:

text
23.5

若启动失败,先通过 docker compose logs --tail=50 mqtt influxdb 查看具体报错。端口占用时只改 ports 左侧宿主机端口,例如 127.0.0.1:1884:1883,容器内 MQTT 端口和服务名不必改;配置挂载失败则核对 mosquitto/config/mosquitto.conf 是否为真实文件。InfluxDB 登录凭据不符合新 .env 时,先检查是否复用了以前初始化的命名卷,不要直接删卷。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Compose 启动消息代理和时序库

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

登录哪都通