ESB容器社区版 (Community Edition) 文档

1. 镜像概述

ESB容器社区版（Community Edition）是一款轻量级企业服务总线（Enterprise Service Bus）容器化解决方案，旨在为微服务架构和分布式系统提供高效的服务集成、消息路由与系统间通信能力。该镜像基于开源技术构建，提供开箱即用的服务总线功能，适合中小企业及开发测试环境使用。

2. 核心功能与特性

2.1 服务集成能力

• 多协议支持：兼容HTTP/HTTPS、JMS、MQTT、AMQP等主流通信协议，实现跨协议服务对接
• 数据格式转换：支持XML、JSON、CSV等多种数据格式的解析与转换
• 服务路由：基于规则（如请求头、消息内容、路由表）的动态服务路由与转发

2.2 消息处理能力

• 消息队列：内置轻量级消息队列，支持异步消息传递与缓冲
• 消息可靠性：提供消息持久化、重试机制，确保消息不丢失
• 流量控制：支持消息限流、熔断与降级，保护后端服务稳定性

2.3 监控与可观测性

• 基础监控：实时监控服务调用量、响应时间、错误率等关键指标
• 日志记录：支持标准输出日志与文件日志，便于问题排查
• 健康检查：内置健康检查接口，支持容器编排平台的状态监控

3. 使用场景

3.1 微服务架构集成

• 作为微服务间的通信中枢，实现服务注册、发现与调用
• 解决微服务架构下的跨服务数据一致性与事务协调问题

3.2 企业系统集成

• 连接企业内部ERP、CRM、OA等异构系统，实现数据互通与业务流程整合
• 替代传统点对点集成方式，降低系统耦合度

3.3 跨平台应用对接

• 实现云服务与本地系统的混合架构集成
• 对接第三方API服务（如支付、物流、社交平台）

3.4 开发测试环境

• 快速搭建服务总线原型，验证集成方案可行性
• 模拟生产环境流量，进行性能测试与压力测试

4. 使用方法

4.1 快速启动容器

使用以下命令从Docker Hub拉取并启动镜像：

docker run -d \
  --name esb-ce \
  -p 8080:8080 \  # 服务端口
  -p 8765:8765 \  # 管理界面端口
  esb/community-edition:latest

容器启动后，可通过 http://localhost:8765 访问管理界面（默认账号：admin，密码：admin123）。

4.2 自定义配置

通过环境变量或配置文件实现自定义配置：

4.2.1 环境变量配置

示例（使用MySQL数据库）：

docker run -d \
  --name esb-ce \
  -p 8080:8080 -p 8765:8765 \
  -e ESB_DB_TYPE=MySQL \
  -e ESB_DB_URL=jdbc:mysql://mysql-host:3306/esb_db \
  -e ESB_DB_USER=esb_user \
  -e ESB_DB_PASSWORD=esb_pass \
  esb/community-edition:latest

4.2.2 配置文件挂载

通过挂载本地配置文件覆盖默认配置：

docker run -d \
  --name esb-ce \
  -p 8080:8080 -p 8765:8765 \
  -v /local/path/config:/opt/esb/conf \  # 配置文件目录
  -v /local/path/logs:/opt/esb/logs \    # 日志目录
  esb/community-edition:latest

4.3 Docker Compose 部署示例

创建 docker-compose.yml 文件：

version: '3.8'
services:
  esb-ce:
    image: esb/community-edition:latest
    container_name: esb-ce
    ports:
      - "8080:8080"   # 服务端口
      - "8765:8765"   # 管理界面端口
    environment:
      - ESB_LOG_LEVEL=INFO
      - ESB_MAX_THREADS=300
    volumes:
      - ./esb/conf:/opt/esb/conf   # 持久化配置
      - ./esb/logs:/opt/esb/logs   # 持久化日志
    restart: unless-stopped
    networks:
      - esb-network

networks:
  esb-network:
    driver: bridge

启动命令：

docker-compose up -d

5. 注意事项

• 社区版不提供商业支持，生产环境使用前建议进行充分测试
• 高并发场景下建议通过水平扩展（多实例）提升性能
• 敏感配置（如数据库密码）建议通过容器编排平台的密钥管理功能注入，避免明文暴露