theanurin/edgebus

EdgeBus Docker镜像文档

镜像概述

EdgeBus是一个兼具库和独立服务器应用双重属性的工具，主要用于简化生产环境中的系统集成工作。通过Docker镜像形式提供，可快速部署和配置，支持灵活的服务器类型和端口设置，满足不同集成场景需求。

核心功能与特性

• 双重角色支持：既可作为开发库集成到应用中，也可作为独立服务器运行
• 灵活配置：支持通过环境变量自定义服务器类型和监听端口
• 可追溯构建：提供完整的构建元数据配置，便于版本追踪和管理
• 轻量级部署：基于Docker容器化部署，简化环境依赖和配置流程

使用场景

• 生产环境中的服务间集成
• 需要简化集成流程的微服务架构
• 快速搭建临时集成测试环境
• 开发与生产环境的一致性保障

使用方法

构建镜像

使用以下命令构建EdgeBus镜像，可通过构建参数自定义版本信息：

shell
docker build \
  --build-arg BUILD_CONFIGURATION=snapshot \  # 构建配置类型（如snapshot、release）
  --build-arg BUILD_COMMIT_REF=local \       # 提交引用（如Git commit hash）
  --build-arg BUILD_COMMIT_TIMESTAMP=$(date +"%Y-%m-%d") \  # 构建时间戳
  --build-arg BUILD_PIPELINE_URL=http://localhost \  # 构建流水线URL
  --build-arg BUILD_PROJECT_URL=http://localhost \   # 项目URL
  --build-arg BUILD_RC_VERSION=0 \             # 发布候选版本号
  --build-arg BUILD_TAG_VERSION=0.2.0 \        # 标签版本号
  --build-arg BUILD_VERSION_APPENDER=-local \  # 版本附加信息
  --tag edgebus \                              # 镜像标签
  --file docker/Dockerfile \                   # Dockerfile路径
  .                                            # 构建上下文路径

运行容器

构建完成后，使用以下命令运行EdgeBus容器：

shell
docker run --rm -it \
  --env "server.main.type=http" \    # 服务器类型（如http）
  --env "server.main.listenPort=8080" \  # 监听端口
  --publish 8080:8080 \              # 端口映射（主机端口:容器端口）
  edgebus                            # 镜像名称

配置说明

构建参数

运行环境变量