kazhar/ace-sample

IBM App Connect Enterprise - 容器化集成应用

概述和主要用途

本仓库包含使用IBM App Connect Enterprise Toolkit构建的示例集成应用，以及用于在容器中运行该集成应用的Dockerfile。同时提供了将容器部署到OpenShift的示例。

此仓库、集成应用和Dockerfile的目的是提供示例，展示如何将单个集成应用作为容器镜像提供，以及如何使用环境变量配置容器。可将此仓库作为从您自己的ACE项目创建容器的参考示例。本仓库仅提供一种实现方式，实际应用中有多种方法可供选择。

核心功能和特性

应用功能

该应用是一个简单的集成应用，具有HTTP输入接口，可输出JSON消息或转换输入字段。应用基于https://github.com/ot4i/http-input-tutorial%E6%9E%84%E5%BB%BA%E3%80%82

示例命令和输出：

>curl http://localhost:7800
{"message":"Hello world!"}

>curl -d '{"input1":"hello","input2":"world"}' http://localhost:7800/
{"output1":"hello","output2":"world","message":"Hello world!"}

开发假设

本仓库中的应用和容器开发基于以下假设：

• IBM App Connect Enterprise 版本为12.x
• 使用IBM App Connect Enterprise开发者版（注意：开发者版限制为每秒一条消息）
• 集成应用开发在开发者工作站上使用ACE工具包完成
• 所有开发工作在开发者工作站上进行（测试用集成服务器在工具包内运行）
• 所有集成应用工件位于单个项目中（示例项目位于ace-sample-app/目录）
• 开发者不构建bar文件，也不将应用部署到外部服务器
• 开发者负责编写Dockerfile
• 开发者负责应用和ACE的生命周期管理，必要时进行更新

容器结构

仓库中包含两个Dockerfile：

1. ace-base-image/Dockerfile（基础镜像）

   • 从[***]
   • 更新Red Hat UBI基础镜像

2. Dockerfile（主镜像，基于基础镜像构建）

   • 配置ACE环境，添加应用源代码和其他文件
   • 基于https://github.com/ot4i/ace-docker%E6%9E%84%E5%BB%BA

Dockerfile的最终指令是CMD，调用start.sh脚本。该脚本在容器启动时执行以下操作：

• 初始化ACE环境
• 若设置了ACE_ENABLE_ADMIN_AUTHENTICATION环境变量，则配置管理员认证
• 创建bar文件
• 若ACE_PROPERTY_OVERRIDES环境变量提供了属性，则覆盖bar文件中的属性
• 将bar文件安装到容器内的集成服务器
• 启动集成服务器

注意：ace-base-image/Dockerfile和Dockerfile可合并为单个Dockerfile。

使用方法和配置说明

基本使用步骤

1. 下载/克隆本仓库
2. 构建容器：

   bash
   docker build -t acesample .
   

3. 前台运行容器：

   bash
   docker run -it --rm -p 7800:7800 -p 7600:7600 acesample
   

   管理员仪表板运行在7600端口，若不需要访问仪表板，可不暴露此端口。

4. 访问容器中的集成应用：
   • 使用浏览器或curl：

     bash
     curl http://localhost:7800
     

环境变量配置示例

启动容器时可设置环境变量，例如：

bash
# 覆盖输出消息
docker run -it --rm -p 7800:7800 -p 7600:7600 -e ACE_PROPERTY_OVERRIDES=SampleFlow#message="Hello there!" acesample

# 启用管理员认证
docker run -it --rm -p 7800:7800 -p 7600:7600 -e ACE_ENABLE_ADMIN_AUTHENTICATION=true -e ACE_ADMIN_USER_PASSWORD=passw0rd acesample

ACE_PROPERTY_OVERRIDES变量包含逗号分隔的可配置属性列表。

访问管理员仪表板

• 访问地址：http://localhost:7600

示例容器获取

Dockerhub上提供示例容器：https://hub.docker.com/repository/docker/kazhar/ace-sample

环境变量说明

OpenShift部署

示例ACE容器可轻松安装到OpenShift集群：OpenShift部署示例

应用截图

• 使用IBM App Connect Enterprise Toolkit开发的示例应用
• 管理员仪表板中的流统计页面