boomi/atom

Boomi Atom Docker镜像文档

概述

Boomi Atom Docker镜像包含以下内容：

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

该Docker镜像不包含Boomi运行时本身，仅包含安装程序。安装程序会在容器创建过程中下载并安装Boomi运行时。安装完成后，Boomi运行时会通过Boomi平台进行自更新。无需更新Docker镜像即可获取最新的Boomi运行时版本。仅当容器在环境中的运行方式发生变化，或需要对Linux操作系统或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”标记，以强制采用更规范的版本控制方式。

可指定要使用的操作系统和版本：

• 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命令。此处包含最基本的必填变量，通常足以满足大多数安装需求。完整变量列表请参见下文环境变量参考。

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

建议：

• <runtimeName>是运行时的自定义名称。建议为运行时名称、本地主机ID、Docker容器名称（--name）和Docker容器主机名（-h）使用相同的值，以保持一致性。

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

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

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

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

使用Docker Compose安装

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

2. 创建Docker Compose文件（见下文示例）并填充账户变量。变量详情请参见下文环境变量参考。

3. 运行以下命令：

bash
docker-compose -f compose.yml up

示例compose.yml文件

运行时安装的示例compose.yml：

yaml
services:
  atom:
    image: boomi/atom:<version>
    container_name: <runtimeName>
    volumes:
      - <hostDirectory>:/mnt/boomi:Z
    environment:
      - BOOMI_ATOMNAME=<runtimeName>
      - INSTALL_TOKEN=<installerToken>
      - ATOM_LOCALHOSTID=<runtimeName>
    ports: [9090:9090]

注意：建议使用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 -（可选）新安装时要设置的容器属性的|（管道）分隔列表。
• 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 <runtimeName> -e BOOMI_ATOMNAME=<runtimeName> -e ATOM_LOCALHOSTID=<runtimeName> --name <runtimeName> -v <hostDirectory>:/mnt/boomi:Z -d boomi/atom:<version>

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

使用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。

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

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

• 自定义镜像：如果升级使用Boomi镜像源代码的自定义镜像，并希望从Red Hat切换到Alpine OS，需要对自定义镜像进行适当更改，以适应从Red Hat Enterprise Linux Universal Base Image（RHEL UBI）到Alpine的切换。

链接

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