apache/camel-jbang Docker Image

Apache Camel 便捷二进制文件 Docker 镜像

概述

本镜像打包了 Apache Camel 集成框架的预编译二进制文件，提供开箱即用的运行环境。无需手动安装和配置依赖，可快速部署企业集成路由，简化集成开发与测试流程。适用于需要快速验证集成逻辑、构建轻量级集成服务的场景。

核心功能

• 预配置环境：包含 Apache Camel 运行所需的全部依赖（JRE、核心组件等），无需手动安装系统依赖
• 多版本支持：通过镜像标签指定不同 Apache Camel 版本（如 latest、3.20.0、4.0.0 等）
• 轻量级设计：基于 Alpine Linux 基础镜像，镜像体积小，启动速度快
• 灵活路由加载：支持从本地文件、URL 或环境变量加载自定义路由配置
• 标准化日志：默认输出结构化日志至标准输出，便于容器平台日志收集

使用场景

• 集成开发与测试：快速搭建本地开发环境，验证路由逻辑和消息处理流程
• 微服务集成层：作为独立服务部署，处理微服务间的数据转换、路由和协议适配
• 数据处理管道：构建文件传输、API 聚合、消息转发等数据处理流程
• CI/CD 集成测试：在持续集成流程中作为测试环境，验证集成组件兼容性

使用方法

快速启动

运行默认示例路由（验证环境可用性）：

bash
docker run --rm docker.xuanyuan.run/apache-camel-binaries

运行自定义路由

挂载本地路由文件目录并指定路由文件路径：

bash
# 将本地 ./routes 目录挂载到容器 /routes，运行 my-route.xml 路由
docker run --rm -v $(pwd)/routes:/routes docker.xuanyuan.run/apache-camel-binaries camel run /routes/my-route.xml

配置参数

环境变量

示例：自定义配置

bash
docker run --rm \
  -e LOG_LEVEL=DEBUG \
  -e JAVA_OPTS="-Xmx1g -XX:+UseContainerSupport" \
  -v $(pwd)/routes:/routes \
  docker.xuanyuan.run/apache-camel-binaries \
  camel run /routes/debug-route.xml

持久化配置

挂载本地目录持久化路由配置和日志：

bash
docker run --rm \
  -v $(pwd)/routes:/routes \  # 持久化路由配置
  -v $(pwd)/logs:/var/log/camel \  # 持久化日志
  apache-camel-binaries \
  camel run /routes/persistent-route.xml

Docker Compose 示例

创建 docker-compose.yml 配置集成服务：

yaml
version: '3.8'
services:
  camel-integration:
    image: docker.xuanyuan.run/apache-camel-binaries:4.1.0
    volumes:
      - ./routes:/routes
      - ./logs:/var/log/camel
    environment:
      - LOG_LEVEL=INFO
      - JAVA_OPTS=-Xmx512m
    command: camel run /routes/main-route.xml
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

版本管理

通过镜像标签指定具体版本（推荐生产环境使用固定版本）：

bash
# 使用 Apache Camel 4.1.0 版本
docker run --rm docker.xuanyuan.run/apache-camel-binaries:4.1.0

注意事项

• 路由文件需符合 Apache Camel DSL 格式（支持 XML/Java/JSON/YAML 格式），语法参考 https://camel.apache.org/manual/
• 生产环境建议使用具体版本标签（如 4.1.0），避免 latest 标签自动更新导致版本变更
• 如需扩展功能（如添加自定义组件），可基于此镜像构建自定义镜像，通过 RUN 指令安装额外依赖