frankframework/frankframework

Frank Framework Docker镜像文档

1. 镜像概述与主要用途

Frank Framework是一个易于使用的无状态集成框架，主要用于实现消息的修改与交换。其Docker镜像专为本地开发与服务器部署设计，提供一致的运行环境，简化集成场景中的消息处理流程。

2. 核心功能与特性

• 无状态架构：运行过程中不依赖本地持久化状态，便于水平扩展与集群部署
• 易用性：简化集成配置，降低消息处理流程的搭建复杂度
• 消息处理：支持消息的修改、转换与交换，满足基础集成需求

3. 使用场景与适用范围

适用场景

• 企业系统间的消息集成与数据交换
• 微服务架构下的跨服务通信处理
• 消息路由、格式转换等集成场景

适用范围

• 本地环境：开发与测试阶段的集成流程验证
• 服务器环境：生产或预生产环境的集成服务部署

4. 镜像获取

4.1 稳定版镜像（推荐）

稳定版镜像存储于官方Nexus仓库，长期保留：

bash
docker pull nexus.frankframework.org/frankframework/frankframework:<tag>

注：<tag>需替换为具体版本号，版本信息可参考项目文档。

4.2 夜间构建版镜像

夜间构建版（开发快照）托管于DockerHub，仅保留6个月：

bash
docker pull frankframework/frankframework:nightly

5. 使用方法与配置说明

5.1 前提条件

• 已安装Docker Engine（20.10+推荐）
• 网络环境可访问镜像仓库（Nexus或DockerHub）

5.2 基本运行命令

bash
# 从Nexus运行稳定版
docker run -d -p 8080:8080 --name frankframework \
  nexus.frankframework.org/frankframework/frankframework:<tag>

# 运行DockerHub夜间构建版
docker run -d -p 8080:8080 --name frankframework-nightly \
  frankframework/frankframework:nightly

说明：-p 8080:8080映射容器内默认HTTP端口（具体端口可能因版本调整，需参考实际配置）。

5.3 配置说明

5.3.1 环境变量

可通过环境变量调整框架行为，常用配置（具体变量需参考官方文档）：

• LOG_LEVEL：日志级别（如INFO、DEBUG）
• MAX_THREADS：处理线程数

示例：

bash
docker run -d -p 8080:8080 \
  -e LOG_LEVEL=DEBUG \
  -e MAX_THREADS=20 \
  nexus.frankframework.org/frankframework/frankframework:<tag>

5.3.2 配置文件挂载

如需自定义集成流程配置，可通过挂载配置文件实现（配置文件结构参考项目源码）：

bash
docker run -d -p 8080:8080 \
  -v /local/config:/opt/frankframework/conf \
  nexus.frankframework.org/frankframework/frankframework:<tag>

注：配置文件路径可能因镜像版本不同而变化，具体以GitHub源码中docker/Tomcat目录下的配置为准。

5.4 docker-compose示例

yaml
version: '3'
services:
  frankframework:
    image: nexus.frankframework.org/frankframework/frankframework:<tag>
    ports:
      - "8080:8080"
    environment:
      - LOG_LEVEL=INFO
      - MAX_THREADS=10
    restart: unless-stopped
    # 如需持久化配置，添加volumes
    # volumes:
    #   - ./local-config:/opt/frankframework/conf

6. 注意事项

• 夜间构建版保留期：DockerHub上的nightly标签镜像仅保留6个月，生产环境建议使用Nexus仓库的稳定版。
• 无状态特性：框架本身无状态，如需持久化配置或日志，需通过外部挂载卷实现。
• 详细文档：Docker镜像的完整配置说明可参考项目GitHub文档：https://github.com/frankframework/frankframework/blob/master/Docker.md%E3%80%82

7. 源码参考

Docker镜像构建相关源码位于项目GitHub仓库的docker/Tomcat目录：https://github.com/frankframework/frankframework/blob/master/docker/Tomcat%E3%80%82