ibmcom/iib

注意事项

请注意，我们现已发布IBM App Connect Enterprise v11，您可在https://github.com/ot4i/ace-docker%E8%8E%B7%E5%8F%96%E3%80%82

概述

本仓库中的镜像包含IBM Integration Bus for Developers。用于构建该镜像的脚本可在GitHub上找到。有关此镜像使用的限制，请参见下文的许可证部分。

核心功能与特性

• 包含IBM Integration Bus for Developers的完整运行时安装
• 支持创建和启动集成节点（Integration Node）
• 支持部署集成解决方案（通过BAR文件）
• 暴露集成节点管理端口（4414）和集成服务器HTTP流量端口（7800）
• 配置syslog用于日志输出

使用场景与适用范围

适用于开发人员在本地环境中开发、测试集成解决方案，不包含IBM MQ（MQ服务器和MQ客户端），因此依赖队列管理器的IIB功能不可用。

使用方法与配置说明

基本要求

运行此镜像的容器时，必须接受IBM Integration Bus for Developers的许可条款。通过在运行镜像时指定环境变量LICENSE=accept来实现。设置为view可查看许可条款，未设置该变量将导致容器终止并显示使用说明。还可通过设置LANG环境变量以其他语言查看许可证。

运行容器

基本运行命令

可基于此Docker镜像运行容器，创建并启动集成节点，然后部署集成解决方案。除接受许可证外，还可通过NODENAME环境变量指定集成节点名称，通过SERVERNAME环境变量指定集成服务器名称。

镜像默认暴露端口4414（集成节点管理）和7800（集成服务器HTTP流量）。可使用-P标志自动映射这些端口到主机，或使用-p手动映射端口。

示例：

bash
docker run --name myNode -e LICENSE=accept -e NODENAME=MYNODE -e SERVERNAME=MYSERVER -P iib

部署BAR文件

可通过指定Docker卷使BAR文件在容器启动时可用，从而部署IBM Integration Bus BAR文件：

bash
docker run --name myNode -v /local/path/to/BARs:/tmp/BARs -e LICENSE=accept -e NODENAME=MYNODE -e SERVERNAME=MYSERVER -P iib

上述命令将运行一个容器，创建并启动名为MYNODE的集成节点，并在主机上随机端口暴露4414和7800。可使用以下命令查看映射的端口：

bash
docker port <container name>

运行管理命令

可通过以下两种方法运行任何Integration Bus命令：

直接在容器内执行

附加bash会话到容器，像往常一样执行命令：

bash
docker exec -it <container name> /bin/bash

进入容器shell后，可通过mqsiprofile命令加载环境并运行相关命令。

使用Docker exec

使用Docker exec运行非交互式Bash会话以执行Integration Bus命令。例如：

bash
docker exec <container name> /bin/bash -c mqsilist

访问日志

此镜像配置了syslog，容器运行时节点会将消息输出到容器内的/var/log/syslog。可通过上述方法附加bash会话或使用docker exec访问，例如：

bash
docker exec <container id> tail -f /var/log/syslog

验证容器运行状态

无论使用提供的镜像还是自定义镜像，可通过以下步骤验证运行状态：

1. 运行容器并确保将4414端口暴露到主机，容器应无错误启动
2. 按上述方法运行mqsilist查看节点状态，节点应显示为运行中
3. 按上述方法访问syslog，应无错误信息
4. 在浏览器中访问主机上暴露的4414端口，应显示Integration Bus Web用户界面

此时容器已正常运行，可通过任何支持的方法部署集成解决方案。

许可证

镜像中安装的产品许可证如下：

• IBM Integration Bus for Developers（非担保程序国际许可协议）

请注意，此许可证不允许进一步分发，且仅限开发机使用。

用户反馈

有关此Docker镜像的特定问题，请使用https://github.com/ot4i/iib-docker/issues%E3%80%82%E6%9C%89%E5%85%B3IBM Integration Bus的一般问题，可通过IBM dWAnswers IBM Integration Bus论坛获取帮助。