Boomi Cloud Docker镜像文档

概述

Boomi Cloud Docker镜像包含：

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

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

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

[!NOTE]

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

[!WARNING]

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

版本控制

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

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

当前受支持的版本标记为“release”。镜像不使用“latest”标记，以强制更规范的版本控制方式。

您可以指定要使用的OS和版本：

• release -> 最新Alpine基础镜像（Alpine是默认OS）
• 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命令，并使用适当的环境变量。此处包含的最小必填变量通常足以满足大多数安装需求。完整变量列表请参见下文环境变量参考。

bash
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/cloud:<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>值必须与为初始集群节点指定的值匹配。

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

使用Docker Compose安装

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

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

3. 运行以下命令：

bash
docker-compose -f compose.yml up

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

compose.yml文件示例

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

yaml
x-cloud: &cloud
  image: boomi/cloud:<version>
  volumes:
    - <hostDirectory>:/mnt/boomi:Z
  environment: &env
    BOOMI_ATOMNAME: <runtimeName>
    BOOMI_CLOUDID: <cloudId>
  restart: unless-stopped
services:
  node-0:
    <<: *cloud
    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:
    <<: *cloud
    container_name: <runtimeName><node1_Id>
    hostname: <node1_Id>
    environment:
      <<: *env
      ATOM_LOCALHOSTID: <node1_Id>
    depends_on:
      node-0:
        condition: service_healthy
  node-2:
    <<: *cloud
    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用于临时存储的本地临时文件路径。所有运行时集群节点的本地临时路径必须一致。
• 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的RHEL镜像。

将Boomi镜像整合到自定义镜像中

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

升级容器镜像

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

使用Docker升级

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

bash
docker stop <container name>

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

bash
docker rm <container name>

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

bash
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/cloud:<version>

4. 安装每个额外节点。

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

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

使用Docker Compose升级

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

bash
docker-compose down

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

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

bash
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。