ibmcom/iib-mq-server

IBM Integration Bus与MQ Advanced开发者版Docker镜像文档

镜像概述和主要用途

本镜像包含IBM Integration Bus开发者版和IBM MQ Advanced开发者版的完整运行时环境。前者是企业级集成中间件，后者是允许定义和运行队列管理器的MQ服务器。适用于开发环境中快速部署集成解决方案，支持消息队列管理与集成流程开发测试。构建镜像的脚本可在GitHub上获取，使用前需遵守许可证条款。

核心功能和特性

• 完整集成IBM Integration Bus开发者版运行时，支持集成节点（Integration Node）和集成服务器（Integration Server）的创建与管理
• 内置IBM MQ Advanced开发者版，提供队列管理器（Queue Manager）功能，支持消息队列的定义与运行
• 支持Docker卷（Volume）挂载，实现配置数据和消息的持久化存储
• 可通过环境变量自定义集成节点、集成服务器及队列管理器名称
• 提供日志输出至syslog，便于问题诊断与监控
• 支持标准Docker命令进行镜像构建、容器运行及管理操作

使用场景和适用范围

• 开发环境中集成解决方案的快速部署与测试
• 学习和评估IBM Integration Bus与IBM MQ的功能特性
• 构建包含消息队列的集成流程原型
• 开发团队共享一致的集成开发与测试环境

详细使用方法和配置说明

构建镜像

可使用标准Docker命令基于提供的Dockerfile构建镜像。Dockerfile及相关脚本位于https://github.com/ot4i/iib-docker%E3%80%82

构建包含MQ安装的镜像示例命令：

bash
cd 10.0.0.11/iib-mq-server
docker build -t iib-mq-image .

运行容器

1. 默认配置运行

必须设置LICENSE=accept环境变量以接受许可证条款，可选设置集成节点、集成服务器及队列管理器名称。默认暴露端口：4414（集成节点管理）、7800（集成服务器HTTP）、1414（MQ监听器）。

基本运行命令：

bash
docker run --name myNode -e LICENSE=accept -e NODENAME=MYNODE -e SERVERNAME=MYSERVER -P docker.xuanyuan.run/iibv10image

部署BAR文件（通过卷挂载）：

bash
docker run --name myNode -v /local/path/to/BARs:/tmp/BARs/<yourbars> -e LICENSE=accept -e NODENAME=MYNODE -e SERVERNAME=MYSERVER -P docker.xuanyuan.run/iibv10image

查看端口映射：

bash
docker port <container name>

2. 带卷的持久化运行

创建卷以持久化MQ数据：

bash
docker volume create qm1data

使用卷运行容器（MQ数据存储于/mnt/mqm，运行时链接至/var/mqm）：

bash
docker run --name myNode -e LICENSE=accept -e NODENAME=MYNODE -e SERVERNAME=MYSERVER -e MQ_QMGR_NAME=QM1 -v qm1data:/mnt/mqm -P docker.xuanyuan.run/iibv10image

3. 自定义队列管理器配置

• 方法1：创建自定义镜像，将MQSC配置文件添加至镜像的/etc/mqm目录，队列管理器创建时会自动运行该文件
• 方法2：通过远程MQ管理（如MQ命令服务器、MQ HTTP API、MQ Web控制台或MQ Explorer）进行配置

注意：容器内始终在1414端口创建监听器，可映射至主机任意端口

4. 运行管理命令

直接在容器内运行

bash
docker exec -it <container name> /bin/bash
# 进入容器后执行
source mqsiprofile
# 运行集成总线命令，如
mqsilist

使用Docker exec运行

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

5. 运行MQ命令

bash
docker exec -it <container name> dspmq  # 显示队列管理器状态

6. 访问日志

容器内日志输出至/var/log/syslog，可通过以下命令访问：

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

验证容器运行状态

1. 运行容器并暴露4414端口，确认容器启动无错误
2. 使用docker exec <container name> /bin/bash -c mqsilist查看集成节点状态，应显示为运行中
3. 访问/var/log/syslog确认无错误日志
4. 通过浏览器访问主机映射的4414端口，应显示集成节点Web用户界面

支持的环境变量

• LICENSE：设置为accept表示同意MQ Advanced开发者版许可证；设置为view可查看许可证
• LANG：设置查看许可证的语言
• NODENAME：自定义集成节点名称
• SERVERNAME：自定义集成服务器名称
• MQ_QMGR_NAME：自定义队列管理器名称
• MQ_APP_PASSWORD：修改app用户密码，至少8个字符；设置后IIB.SVRCONN通道将要求有效的用户ID和密码进行连接

许可证信息

• Dockerfile及相关脚本采用Eclipse Public License 1.0
• 镜像中安装的产品许可证：
  • IBM Integration Bus for Developers：遵循IBM International License Agreement for Non-Warranted Programs，可通过LICENSE=view查看
  • IBM MQ Advanced for Developers：遵循IBM International License Agreement for Non-Warranted Programs，可通过LICENSE=view查看
  • Ubuntu包许可证：位于/usr/share/doc/${package}/copyright

注意：IBM Integration Bus开发者版许可证不允许进一步分发；IBM MQ Advanced开发者版许可证不允许进一步分发，且仅限开发机器使用。

用户反馈

• 有关本Docker镜像的问题：使用https://github.com/ot4i/iib-docker/issues
• 有关IBM Integration Bus的一般问题：通过https://developer.ibm.com/answers/smartspace/integration-bus/index.html%E8%8E%B7%E5%8F%96%E5%B8%AE%E5%8A%A9