boomi/molecule

概述

Boomi Molecule Docker镜像包含：

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

该Docker镜像不包含Boomi运行时本身，仅包含安装程序。安装程序会在容器创建过程中下载并安装Boomi运行时。安装完成后，Boomi运行时通过Boomi平台进行自更新。无需更新Docker镜像即可获取最新的Boomi运行时版本。仅当容器在环境中的运行方式发生变更，或需要对Linux操作系统或Java应用安全补丁和更新时，才会更新Docker镜像。

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

注意

自2025年3月起，运行时相关术语已更新，以提高直观性并更好地与行业通用概念对齐。具体而言，“atom”现为“basic runtime”（基础运行时），“molecule”现为“runtime cluster”（运行时集群），“cloud molecule”现为“runtime cloud cluster”（运行时云集群）。在Boomi应用和产品文档中会使用这些新术语，但为保持向后兼容性，此镜像名称、环境变量及其他技术值将继续使用旧术语。

警告

自2025年2月8日起，版本3和版本4镜像已退役，不再提供支持或维护。仍使用这些版本的客户应升级至最新版本（版本5）。有关此退役及升级方法的详细信息，请参考此知识库文章。

版本控制

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版本，以便轻松获取最新发布的镜像。

注意：需要使用SAP或SAP JCo V2连接器连接SAP系统的客户应使用版本5的Red Hat镜像。连接器使用的SAP JCo库与Alpine不兼容。使用版本3的客户应升级至版本5，以利用多项增强功能和安全更新。详见下文升级说明。

版本支持

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

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

有关详细信息，请参考Boomi功能弃用流程。

当前版本

当前主版本为5。

自2025年2月8日起，版本3和版本4镜像已退役，不再提供支持或维护。仍使用这些版本的客户应升级至最新版本（版本5）。有关此退役及升级方法的详细信息，请参考此知识库文章。

变更日志

详见运行时Docker镜像变更日志。

安装容器

可通过Docker或Docker Compose安装容器。

使用Docker安装

安装初始节点

1. 通过Boomi平台UI或平台API生成新的安装令牌。

2. 运行以下Docker run命令，并带上适当的环境变量。此处包含的最小必填变量通常适用于大多数安装。完整变量列表见下文环境变量参考。

docker run -p 9090:9090 -h <nodeId> -e INSTALL_TOKEN=<installerToken> -e BOOMI_ATOMNAME=<runtimeName> -e ATOM_LOCALHOSTID=<nodeId> --name <runtimeName><nodeId> -v <hostDirectory>:/mnt/boomi:Z -d boomi/molecule:<version>

建议：

• <runtimeName>是运行时的用户定义名称。建议运行时名称与Docker容器名称的一部分保持一致，以确保一致性。

• <nodeId>是集群中此节点的用户定义名称。建议Boomi本地主机ID、Docker容器主机名（-h）和Docker容器名称的一部分使用相同值，以确保一致性。

• 建议将版本设置为release或release-rhel，以使用最新可用镜像版本。

• 建议使用INSTALL_TOKEN变量与Boomi平台进行身份验证，也可选择使用BOOMI_USERNAME、BOOMI_PASSWORD和BOOMI_ACCOUNTID变量。

如果本地尚无镜像副本，此命令会自动拉取镜像。

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

安装额外节点

通过运行以下命令安装额外的集群节点，为每个新节点更新<nodeId>值。

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

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

使用Docker Compose安装

1. 通过Boomi平台UI或平台API生成新的安装令牌。

2. 创建Docker Compose文件（见下文示例）并填充账户相关变量。环境变量详见下文参考。所有节点通用的环境变量可放在yaml锚点&env下。

3. 运行以下命令：

docker-compose -f compose.yml up

注意：如果初始节点安装耗时较长，其他节点因健康检查失败无法启动，可尝试增加重试次数或间隔时间，或手动重启受影响节点的Docker容器。

示例compose.yml文件

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

x-molecule: &molecule
  image: boomi/molecule:<version>
  volumes:
    - <hostDirectory>:/mnt/boomi:Z
  environment: &env
    BOOMI_ATOMNAME: <runtimeName>
  restart: unless-stopped
services:
  node-0:
    <<: *molecule
    container_name: <runtimeName><node0_Id>
    hostname: <node0_Id>
    environment:
      <<: *env
      ATOM_LOCALHOSTID: <node0_Id>
      INSTALL_TOKEN: <installerToken>
    ports: [9090:9090]
    healthcheck:
      test: ["CMD", "wget", "-S", "http://localhost:9090/_admin/readiness", "-O", "/dev/null"]
      interval: 5s
      retries: 5
  node-1:
    <<: *molecule
    container_name: <runtimeName><node1_Id>
    hostname: <node1_Id>
    environment:
      <<: *env
      ATOM_LOCALHOSTID: <node1_Id>
    depends_on:
      node-0:
        condition: service_healthy
  node-2:
    <<: *molecule
    container_name: <runtimeName><node2_Id>
    hostname: <node2_Id>
    environment:
      <<: *env
      ATOM_LOCALHOSTID: <node2_Id>
    depends_on:
      node-0:
        condition: service_healthy

注意：建议使用INSTALL_TOKEN变量与Boomi平台进行身份验证，也可选择使用BOOMI_USERNAME、BOOMI_PASSWORD和BOOMI_ACCOUNTID变量。

环境变量参考

可通过在docker run命令中传递一个或多个环境变量来调整本地运行时的配置。使用-e标志在Docker命令行中包含额外环境变量，或在Docker Compose文件的environment部分中包含。

• INSTALL_TOKEN -（推荐）指定唯一的安装令牌。令牌仅对生成它的账户有效，有效期为30分钟至24小时不等。
• BOOMI_USERNAME -（INSTALL_TOKEN的替代方案，需与BOOMI_PASSWORD一起使用）指定Boomi用户名。
• BOOMI_PASSWORD -（INSTALL_TOKEN的替代方案，需与BOOMI_USERNAME一起使用）指定Boomi用户名对应的密码。
• BOOMI_ACCOUNTID -（INSTALL_TOKEN的替代方案，需与BOOMI_USERNAME和BOOMI_PASSWORD一起使用）指定Boomi账户ID。
• BOOMI_ATOMNAME -（必填）指定要安装的运行时名称。
• ATOM_LOCALHOSTID -（必填）指定唯一且持久的本地主机ID，与分配的IP地址无关。
• BOOMI_ENVIRONMENTID -（可选）指定运行时附加到的环境。如未明确指定，运行时将显示在运行时管理的“未附加运行时”列表中。
• ATOM_VMOPTIONS_OVERRIDES -（可选）新安装时要设置的vm选项的|（竖线）分隔列表。
• CONTAINER_PROPERTIES_OVERRIDES -（可选）新安装时要设置的容器属性的|（竖线）分隔列表。
• LOCAL_PATH -（可选）指定本地文件路径（而非网络文件系统）。所有集群节点的本地路径必须一致。
• LOCAL_TEMP_PATH -（可选）指定Java用于临时存储的本地临时文件路径。所有Molecule节点的本地临时路径必须一致。
• 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读、写和执行权限。然后，再次使用docker run命令，并将环境变量VALIDATE_MOUNT_ACCESS设置为false。

• SAP连接器和SAP JCo V2连接器与版本4镜像不兼容。如需要连接SAP系统，请改用版本5的Red Hat镜像。

将Boomi镜像纳入自定义镜像

如要将Boomi安装程序纳入自己的自定义镜像，可从Bitbucket⁠下载镜像的源代码。例如，如需使用不同的Linux发行版、包含额外安全相关环境变量，或将Boomi与其他应用程序一起打包，可能需要这样做。请注意，您负责维护自定义镜像，并确保其与Boomi的最新源代码保持同步。

升级容器镜像

发布新镜像版本后，需升级容器以使用该版本。升级包括删除先前的容器镜像，并安装指向相同安装目录的新容器镜像。

使用Docker升级

1. 停止运行中的容器。对每个节点重复此步骤。

docker stop <container name>

2. 删除先前的容器。对每个节点重复此步骤。

docker rm <container name>

3. 安装初始节点。关键：确保使用与原始容器安装相同的环境变量值（BOOMI_ATOMNAME、ATOM_LOCALHOSTID、名称和hostDirectory）。如有必要，唯一的区别是版本。建议将版本设置为release或release-rhel，以获取最新可用镜像。

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

4. 安装每个额外节点。

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

使用Docker Compose升级

1. 使用以下命令停止并删除容器：

docker-compose down

2. 查看原始compose.yml文件，必要时调整版本和其他环境变量（见下文升级注意事项）。关键：确保使用与原始容器安装相同的环境变量值（BOOMI_ATOMNAME、ATOM_LOCALHOSTID、名称和hostDirectory）。

3. 使用compose.yml文件运行以下命令：

docker-compose -f compose.yml up

4. 新容器现在将使用最新镜像运行。

从版本4升级到版本5的注意事项

• Docker安装命令或环境变量无变化。

• 版本4仅提供Alpine镜像。如继续使用Alpine，将版本设置为release；如切换到Red Hat，将版本设置为release-rhel。

从版本3升级到版本5的注意事项

版本5镜像包含多项变更，以简化容器镜像的安装和配置。一个重要考虑因素是选择Alpine还是Red Hat镜像。请查看以下升级说明。

• 如果集成涉及使用SAP连接器或SAP JCo V2连接器连接SAP应用程序，必须使用Red Hat版本5镜像（version = release-rhel）。Alpine镜像不支持SAP连接器。

• 如果先前使用过DOCKERUID环境变量且设置为非1000的值（不常见），升级前需要手动干预。由于较新的镜像使用UID和GID为1000的非root用户运行，因此安装运行时文件所在的挂载路径必须递归更新为所有者UID 1000。

• 不再需要特权模式。--privileged和--tmpfs标志不再使用，应从Docker run命令或Docker Compose文件中删除。同时应删除/sys/fs/cgroup的挂载。

• 以下环境变量不再使用，应从Docker run命令或Docker Compose文件中删除：BOOMI_CONTAINERNAME、DOCKERUID、HOST_INSTALLATION_DIRECTORY、