amanzh/emqx

EMQX AWS ECS 适配镜像

镜像概述

本镜像基于emqx/emqx:v3.2-rc.2修改，专门优化以在AWS ECS（Amazon Elastic Container Service）环境中运行，支持host或awsvpc网络模式，确保EMQX消息代理在ECS集群中稳定部署和运行。

核心功能与特性

• 基础版本：基于EMQX v3.2-rc.2，保留原版EMQX的消息代理核心功能
• ECS适配：针对AWS ECS环境优化，支持ECS两种主要网络模式：
  • host网络模式：直接使用主机网络栈，适用于需要直接绑定主机端口的场景
  • awsvpc网络模式：为每个任务分配弹性网络接口，支持精细网络控制
• 兼容性：与AWS ECS服务发现、负载均衡等生态组件兼容

使用场景

• 在AWS ECS集群中部署EMQX消息代理服务
• 需要使用host或awsvpc网络模式的EMQX部署场景
• 构建基于AWS云环境的MQTT消息通信系统

使用方法

基本运行命令（host网络模式）

bash
docker run -d \
  --name emqx-ecs \
  --net=host \
  your-registry/emqx-ecs:latest

基本运行命令（awsvpc网络模式）

在ECS任务定义中指定网络模式为awsvpc，并映射所需端口：

bash
docker run -d \
  --name emqx-ecs \
  -p 1883:1883 \  # MQTT端口
  -p 8083:8083 \  # WebSocket端口
  -p 8883:8883 \  # MQTTs端口
  -p 8080:8080 \  # Dashboard端口
  your-registry/emqx-ecs:latest

Docker Compose配置示例（适用于本地测试ECS网络模式）

yaml
version: '3'
services:
  emqx:
    image: your-registry/emqx-ecs:latest
    network_mode: host  # 或使用默认bridge模式模拟awsvpc环境
    ports:
      - "1883:1883"
      - "8083:8083"
      - "8883:8883"
      - "8080:8080"
    environment:
      - EMQX_NAME=emqx-ecs-node
      - EMQX_HOST=ecs-task-ip  # 在awsvpc模式下自动分配

ECS任务定义关键配置

在AWS ECS任务定义中需指定：

• 网络模式：选择host或awsvpc
• 端口映射：根据EMQX服务需求映射端口（1883、8083、8883、8080等）
• 环境变量：可根据需要配置EMQX运行参数，如节点名称、集群配置等

注意事项

• 使用host网络模式时，需确保ECS主机端口未被其他服务占用
• awsvpc网络模式下，任务将获得独立网络接口，需配置相应安全组允许MQTT相关端口通信
• 镜像基于EMQX v3.2-rc.2，建议根据实际需求评估是否需要升级EMQX版本