boomi/gateway

Boomi Gateway Docker镜像文档

概述

Boomi Gateway Docker镜像包含以下组件：

• 最小化的Alpine或Red Hat UBI基础镜像
• 最新Boomi支持版本的Java
• 用于检索、设置和调用Boomi Gateway运行时64位安装程序的代码

注意：使用此镜像必须拥有有效的Boomi账户。如需注册30天免费试用账户，请访问Boomi.com。

版本控制

Boomi Docker镜像遵循语义化版本控制，格式为MAJOR.MINOR.PATCH：

• MAJOR版本：表示镜像重大变更，如基础镜像变更，可能需要调整镜像运行方式
• MINOR版本：表示增强功能和主要缺陷修复，保持向后兼容
• PATCH版本：表示安全更新、嵌入式Java版本更新和次要缺陷修复

当前支持版本标记为"release"。镜像不使用"latest"标签，以强制更规范的版本管理方式。

可指定操作系统和版本：

• release -> 最新Alpine基础镜像（Alpine为默认操作系统）
• release-rhel -> 最新Red Hat UBI基础镜像
• 5.x.x -> 特定版本的Alpine基础镜像
• 5.x.x-alpine -> 特定版本的Alpine基础镜像
• 5.x.x-rhel -> 特定版本的Red Hat UBI基础镜像

版本支持

Boomi支持当前主要版本的最新release和release-rhel标签。如遇到任何问题，请先更新至最新版本以验证问题，再联系支持团队。

重要：当新主要版本发布后，前一主要版本将被弃用。弃用后，前一主要版本将继续获得支持和维护（例如季度Java更新、安全补丁、关键缺陷修复，但不包括次要缺陷修复或功能增强），直至其退役日期。至少6个月后，前一主要版本将退役，不再提供支持和维护。

有关更多信息，请参阅Boomi功能弃用流程。

当前版本

当前主要版本为5。

变更日志

请参阅运行时Docker镜像变更日志。

使用方法

安装初始节点

使用以下Docker run命令，替换适当的环境变量：

bash
docker run -p 8077:8077 -h <nodeId> -e BOOMI_USERNAME=<user> -e BOOMI_PASSWORD=<pwd> -e BOOMI_ACCOUNTID=<accountId> -e BOOMI_ATOMNAME=<runtimeName> -e ATOM_LOCALHOSTID=<nodeId> --name <runtimeName><nodeId> -v <hostDirectory>:/mnt/boomi:Z -d boomi/gateway:<version>

如果本地没有镜像副本，此命令将自动拉取镜像。

命令运行后，安装程序将连接Boomi平台验证凭据。验证成功后，将创建运行时并安装必要文件，运行时将作为守护线程启动。

安装额外节点

通过为每个新节点更新<nodeId>值，可安装额外集群节点：

bash
docker run -h <nodeId> -e BOOMI_ATOMNAME=<runtimeName> -e ATOM_LOCALHOSTID=<nodeId> --name <runtimeName><nodeId> -v <hostDirectory>:/mnt/boomi:Z -d boomi/gateway:<version>

BOOMI_ATOMNAME和<hostDirectory>值必须与初始集群节点指定的值匹配。

注意：如需使用Gateway安装程序镜像的本地副本，可从Bitbucket下载镜像源代码。

通过docker-compose运行镜像

多节点集群安装的compose.yml示例：

yaml
x-gateway: &gateway
  image: boomi/gateway:<version>
  volumes:
    - <hostDirectory>:/mnt/boomi:Z
  environment: &env
    BOOMI_ATOMNAME: <runtimeName>
  restart: unless-stopped
services:
  node-0:
    <<: *gateway
    container_name: <runtimeName><node0_Id>
    hostname: <node0_Id>
    environment:
      <<: *env
      ATOM_LOCALHOSTID: <node0_Id>
      BOOMI_USERNAME: <user>
      BOOMI_PASSWORD: <pwd>
      BOOMI_ACCOUNTID: <accountId>
    ports: [8077:8077, 18077:18077]
    healthcheck:
      test: ["CMD", "wget", "-S", "http://localhost:8077/_admin/status", "-O", "/dev/null"]
      interval: 5s
      start_period: 120s
      retries: 5
  node-1:
    <<: *gateway
    container_name: <runtimeName><node1_Id>
    hostname: <node1_Id>
    environment:
      <<: *env
      ATOM_LOCALHOSTID: <node1_Id>
    depends_on:
      node-0:
        condition: service_healthy
  node-2:
    <<: *gateway
    container_name: <runtimeName><node2_Id>
    hostname: <node2_Id>
    environment:
      <<: *env
      ATOM_LOCALHOSTID: <node2_Id>
    depends_on:
      node-0:
        condition: service_healthy

创建docker compose文件并更新字段。所有节点的通用环境变量可放在yaml锚点&env下，然后运行命令：docker-compose -f compose.yml up。

注意：如果第一个节点（主节点）安装耗时较长，导致其他节点因健康检查失败无法启动，可尝试增加重试次数、延长间隔时间，或手动重启受影响节点的Docker容器。

环境变量

可通过在docker run命令行传递一个或多个环境变量调整本地运行时配置：

• BOOMI_USERNAME -（与BOOMI_PASSWORD一起必填；可替代INSTALL_TOKEN）指定Dell Boomi用户名。
• BOOMI_PASSWORD -（与BOOMI_USERNAME一起必填；可替代INSTALL_TOKEN）指定AtomSphere用户的密码。
• INSTALL_TOKEN -（替代BOOMI_USERNAME和BOOMI_PASSWORD）指定唯一的安装程序令牌。令牌仅在生成它的账户中有效，有效期为30分钟至24小时。
• BOOMI_ACCOUNTID -（与BOOMI_USERNAME和BOOMI_PASSWORD一起必填；与INSTALL_TOKEN不兼容）指定Boomi账户ID。
• BOOMI_ATOMNAME -（必填）指定要安装的运行时名称。
• ATOM_LOCALHOSTID -（必填）指定独立于任何分配IP地址的唯一且持久的本地主机ID。
• BOOMI_ENVIRONMENTID -（可选）指定运行时附加的环境。如未明确指定，运行时将出现在运行时管理的“未附加运行时”列表中。
• ATOM_VMOPTIONS_OVERRIDES -（可选）新安装时要设置的以|（管道）分隔的vm选项列表。
• CONTAINER_PROPERTIES_OVERRIDES -（可选）新安装时要设置的以|（管道）分隔的容器属性列表。
• LOCAL_PATH -（可选）指定本地文件路径（而非网络文件系统）。所有集群节点的本地路径必须一致。
• LOCAL_TEMP_PATH -（可选）指定Java用于临时存储的本地临时文件路径。所有Gateway节点的本地临时路径必须一致。
• PROXY_HOST -（可选）指定代理主机名。
• PROXY_USERNAME -（可选）指定代理的用户名。
• PROXY_PASSWORD -（可选）指定代理用户的密码。
• PROXY_PORT -（可选）指定代理的端口号。
• VALIDATE_MOUNT_ACCESS -（可选）指定是否验证挂载路径的权限。默认值为true。
• UPDATE_MOUNT_PERMISSIONS -（可选）指定是否在需要时更新挂载路径的权限（注意：非递归）。默认值为true，且需将VALIDATE_MOUNT_ACCESS设置为true才生效。
• INSTALLATION_DIRECTORY -（可选）指定安装文件路径（共享文件系统路径，即网络文件系统），用于安装运行时。

已知问题

• 如果使用docker run命令后收到挂载路径访问错误，请确保挂载的主机目录已授予UID 1000读、写和执行权限，然后使用设置环境变量VALIDATE_MOUNT_ACCESS=false的docker run命令重试。

链接

• 官方Boomi Docker仓库
• 官方Boomi运行时容器参考架构