ibmcom/ace

IBM App Connect Enterprise Docker 镜像文档

重要提示

已弃用 - 此镜像不再开发维护

替代方案请参考: [***]

镜像概述和主要用途

本仓库包含演示如何在Docker容器中运行IBM App Connect Enterprise的Dockerfile和脚本。

基础镜像包含完整安装的IBM App Connect Enterprise for Developers Version 11.0.0.9，以及一些系统配置和用户创建。

镜像源代码可在https://github.com/ot4i/ace-docker%E7%9A%84%E5%8F%91%E5%B8%83%E7%89%88%E6%9C%AC%E4%B8%AD%E6%89%BE%E5%88%B0%E3%80%82%E6%B3%A8%E6%84%8F%EF%BC%8C%E6%9C%80%E6%96%B0%E9%95%9C%E5%83%8F%E5%8F%AF%E8%83%BD%E4%B8%8EGitHub(master%E5%88%86%E6%94%AF)%E4%B8%AD%E7%9A%84%E6%9C%80%E6%96%B0%E4%BB%A3%E7%A0%81%E4%B8%8D%E4%B8%80%E8%87%B4%E3%80%82

Docker Hub 信息

预构建的App Connect Enterprise镜像可用以下标签:

• 11.0.0.0
• 11.0.0.2
• 11.0.0.3
• 11.0.0.4
• 11.0.0.5-amd64
• 11.0.0.5.1-amd64
• 11.0.0.6-amd64
• 11.0.0.6.1-amd64
• 11.0.0.7-r1-amd64
• 11.0.0.8-r1-amd64
• 11.0.0.9-r1-amd64, latest

https://github.com/ot4i/ace-docker/blob/master/ubi/Dockerfile.aceonly

核心功能和特性

• 完整的IBM App Connect Enterprise for Developers环境
• 支持动态配置集成服务器
• 多格式日志输出(basic/json)
• Prometheus指标监控
• 支持多种配置方式(策略文件、服务器配置、数据库连接等)
• 集成Web管理界面

使用场景和适用范围

本镜像适用于开发和测试环境中快速部署IBM App Connect Enterprise集成服务器，支持以下场景:

• 集成流程开发和测试
• 微服务架构中的集成层部署
• 自动化测试环境
• 演示和原型环境

使用方法和配置说明

接受许可协议

使用此镜像前必须接受IBM App Connect Enterprise许可条款。通过运行镜像时指定环境变量LICENSE=accept来表示接受。也可以将此变量设置为view以查看许可条款。未设置此变量将导致容器终止并显示使用说明。可通过设置LANG环境变量以不同语言查看许可。

运行镜像

使用默认配置运行容器，包含以下设置:

• ACE服务器名称 ACESERVER
• ACE Web UI监听器端口 7600
• ACE HTTP监听器端口 7600

运行以下命令:

bash
docker run --name aceserver -p 7600:7600 -p 7800:7800 -p 7843:7843 --env LICENSE=accept --env ACE_SERVER_NAME=ACESERVER ibmcom/ace:latest

当控制台显示集成服务器正在端口7600上监听时，可通过http://localhost:7600/访问App Connect Enterprise UI。要停止容器，运行docker stop aceserver，容器将干净地关闭，停止集成服务器。

支持的环境变量

• LICENSE - 设置为accept表示同意App Connect Enterprise许可。设置为view可查看许可。
• LANG - 设置查看许可的语言。
• LOG_FORMAT - 更改容器stdout日志格式。设置为"json"使用JSON格式(每行一个JSON对象)；设置为"basic"使用简单人类可读格式。默认为"basic"。
• USE_QMGR - 设置为true启动队列管理器并让集成服务器使用它。
• ACE_ENABLE_METRICS - 设置为true为集成服务器生成Prometheus指标。
• ACE_SERVER_NAME - 设置集成服务器名称。
• ACE_TRUSTSTORE_PASSWORD - 信任库密码(如果使用)。
• ACE_KEYSTORE_PASSWORD - 密钥库密码(如果使用)。
• ACE_ADMIN_SERVER_SECURITY - 设置为true以使用SSL保护集成服务器。
• ACE_ADMIN_SERVER_NAME - 用于SSL SAN检查的集成服务器DNS名称。
• ACE_ADMIN_SERVER_CA - 集成服务器SSL CA证书。
• ACE_ADMIN_SERVER_CERT - 集成服务器SSL证书。
• ACE_ADMIN_SERVER_KEY - 集成服务器SSL密钥。

动态配置App Connect Enterprise集成服务器

为支持集成服务器的动态配置，本镜像支持通过文件注入配置。

在集成服务器启动前，容器会检查/home/aceuser/initial-config文件夹。对于该目录下的每个子文件夹，将运行名为ace_config_{folder-name}.sh的脚本处理其中的信息。

注意: 镜像中集成服务器的工作目录是/home/aceuser/ace-server。 注意: 示例initial-config目录及数据可在sample文件夹中找到，以及运行镜像时如何挂载它的命令。

可将以下文件结构挂载到/home/aceuser/initial-config:

/home/aceuser/initial-config/keystore

• PEM格式的证书文件，文件名为证书别名加.crt后缀。别名不能包含空格。
• PEM格式的私钥文件，文件名为证书别名加.key后缀。
• 如果私钥已加密，需提供密码文件，文件名为证书别名加.pass后缀。
• 必须通过环境变量ACE_KEYSTORE_PASSWORD设置密钥库密码。
• 可放置多组文件，每组使用不同的文件名/别名；每个.crt文件必须有对应的.key文件，加密私钥必须有对应的.pass文件。

/home/aceuser/initial-config/odbcini

• odbc.ini文本文件。这必须是适合集成服务器连接数据库使用的odbc.ini文件。将被复制到/home/aceuser/ace-server/odbc.ini。

/home/aceuser/initial-config/policy

• 一组.policyxml文件和一个policy.descriptor文件。将被复制到/home/aceuser/ace-server/overrides/DefaultPolicies/。需在server.conf.yaml部分中指定才能使用。

/home/aceuser/initial-config/serverconf

• server.conf.yaml文本文件，包含服务器配置覆盖内容。将被复制到/home/aceuser/ace-server/overrides/server.conf.yaml。

/home/aceuser/initial-config/setdbparms

• 需通过mqsisetdbparms设置的参数，包含名为setdbparms.txt的文本文件。支持两种格式:

# 以"#"开头的行被忽略
# 以mqsisetdbparms开头的行将按原样运行
# 或者每行应指定<resource> <userId> <password>，以单个空格分隔
# 每行将通过调用...处理
#   mqsisetdbparms ${ACE_SERVER_NAME} -n <resource> -u <userId> -p <password>
resource1 user1 password1
resource2 user2 password2
mqsisetdbparms -w /home/aceuser/ace-server -n salesforce::SecurityIdentity -u myUsername -p myPassword -c myClientID -s myClientSecret

/home/aceuser/initial-config/truststore

• PEM格式的CA证书文件，文件名为证书别名加.crt后缀。别名不能包含空格。
• 必须通过环境变量ACE_TRUSTSTORE_PASSWORD设置信任库密码。
• 可放置多个文件，每个使用不同的文件名/别名。

/home/aceuser/initial-config/webusers

• admin-users.txt: 创建admin用户，具有READ、WRITE和EXECUTE权限。
• operator-users.txt: 创建operator用户，具有READ和EXECUTE权限。
• editor-users.txt: 创建editor用户，具有READ和WRITE权限。
• audit-users.txt: 创建audit用户，具有READ权限。
• viewer-users.txt: 创建viewer用户，具有READ权限。

每个文件格式如下:

# 以"#"开头的行被忽略
# 每行应指定<user> <password>，以单个空格分隔
# 每个用户将拥有指定的访问权限
# 每行将通过调用...处理
#   mqsiwebuseradmin -w /home/aceuser/ace-server -c -u <user> -a <password> -r <role>
user1 password1
user2 password2

/home/aceuser/initial-config/mqsc

• config.mqsc文本文件，包含将由runmqsc命令处理的mqsc命令。详情可在MQ知识中心找到。

/home/aceuser/initial-config/agent

• switch.json: 包含交换机配置信息，将被复制到适当的iibswitch目录。
• agentx.json: 包含代理连接配置信息，将被复制到适当的iibswitch目录。
• agentc.json: 包含代理连接配置信息，将被复制到适当的iibswitch目录。
• agentp.json: 包含代理连接配置信息，将被复制到适当的iibswitch目录。

/home/aceuser/initial-config/extensions

• extensions.zip压缩文件，将被解压到/home/aceuser/ace-server/extensions目录。允许放置额外文件到可在例如server.conf.yaml中引用的目录。

/home/aceuser/initial-config/ssl

• ca.crt: PEM文件，将被复制到/home/aceuser/ace-server/ssl目录。
• tls.key: PEM文件，将被复制到/home/aceuser/ace-server/ssl目录。
• tls.cert: PEM文件，将被复制到/home/aceuser/ace-server/ssl目录。

日志

容器内运行的集成服务器日志将输出到标准输出。日志条目可采用两种格式:

• basic: 人类可读格式，适用于开发环境，可通过docker logs或kubectl logs查看
• json: 用于推送到ELK堆栈，以便在Kibana中搜索和可视化

输出格式由LOG_FORMAT环境变量控制。

Kibana仪表板示例可从https://github.com/ot4i/ace-docker/blob/master/sample/dashboards/ibm-ace-kibana5-dashboard.json%E8%8E%B7%E5%8F%96%E3%80%82

监控

IBM App Connect Enterprise中的统计功能提供组件级数据，深入了解正在运行的消息流，支持问题确定、性能分析、容量规划、情况警报监控和计费模型。

如果ACE_ENABLE_METRICS设置为true，Prometheus导出器将在端口9483上运行 - 导出器通过WebSocket从集成服务器监听统计数据，然后聚合这些数据，以便Prometheus请求时可用。

Grafana仪表板示例可从https://github.com/ot4i/ace-docker/blob/master/sample/dashboards/ibm-ace-grafana-dashboard.json%E8%8E%B7%E5%8F%96%E3%80%82

Docker Compose配置示例

yaml
version: '3'
services:
  ace-server:
    image: ibmcom/ace:latest
    container_name: aceserver
    ports:
      - "7600:7600"
      - "7800:7800"
      - "7843:7843"
      - "9483:9483"  # Prometheus metrics
    environment:
      - LICENSE=accept
      - ACE_SERVER_NAME=ACESERVER
      - LOG_FORMAT=json
      - ACE_ENABLE_METRICS=true
      - ACE_KEYSTORE_PASSWORD=password
      - ACE_TRUSTSTORE_PASSWORD=password
    volumes:
      - ./initial-config:/home/aceuser/initial-config
    restart: unless-stopped

许可

Dockerfile和相关脚本根据https://github.com/ot4i/ace-docker/blob/master/LICENSE%E8%AE%B8%E5%8F%AF%E3%80%82%E9%95%9C%E5%83%8F%E4%B8%AD%E5%AE%89%E8%A3%85%E7%9A%84%E4%BA%A7%E5%93%81%E8%AE%B8%E5%8F%AF%E5%A6%82%E4%B8%8B:

• IBM App Connect Enterprise for Developers根据IBM International License Agreement for Non-Warranted Programs许可。可使用上述LICENSE=view环境变量查看此许可。
• Ubuntu软件包的许可信息可在/usr/share/doc/${package}/copyright中找到。

请注意，IBM App Connect Enterprise for Developers许可不允许进一步分发。

版权

© Copyright IBM Corporation 2015, 2019