文档Commerce云上 Commerce 指南

[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

ECE-Tools发行说明

Last update: Wed Oct 08 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：
  • 云

创建对象：

  • 管理员
  • 开发人员

ece-tools包是一组用于管理和部署云项目的脚本和工具。 这些发行说明介绍了此包的最新改进，此包是适用于Commerce的Cloud Tools Suite的一部分。

NOTE
有关更新到包的最新版本的信息，请参阅升级ECE工具ece-tools。

ece-tools包使用以下版本控制序列： 200<major>.<minor>.<patch>

发行说明包括：

  • 新图标 新功能
  • 修复图标 修复和改进

v2002.2.8 latest

发行日期： 2025年10月8日

  • 新图标 ActiveMQ — 已添加对ActiveMQ的支持。
  • 新图标 ActiveMQ​已添加功能测试。

v2002.2.7

发行日期： 2025年8月7日

  • 修复图标 PHP 8.4修复 — 添加了类型兼容性。
  • 修复图标 EOL验证器 — 已更新生命周期结束(EOL)服务日期。
  • 新图标 Valkey — 添加了PHP 8.2和PHP 8.3功能测试。
  • 修复图标 Valkey验证器 — 修复了ECE工具警告消息。
  • 修复图标 ECE工具​已添加单元测试改进。
  • 新图标 服务验证器 — 添加了Opensearch、MariaDB和PHP的新版本支持。
  • 新图标 Opensearch3 — 已添加对Opensearch3的支持。
  • 修复图标 对2.4.4-p7/p12​的Opensearch支持 — 已更新验证器脚本。
  • 新图标 Opensearch3测试 — 已添加功能测试。

v2002.2.6

发布日期： 2025年6月3日

  • 修复图标 改进与2.4.8的兼容性 — 更新了第三方库以更好地与2.4.8 兼容

v2002.2.5

发行日期： 2025年5月27日

  • 新图标 Extended Valkey兼容性-Adobe Commerce中的Extended Valkey兼容性。
  • 修复图标 已更新RabbitMQ验证器 — 已更新RabbitMQ的验证器。
  • 修复图标 已更新MariaDB验证器 — 已更新MariaDB 10.11的ece-tools验证器。
  • 修复图标 扩展Opensearch2兼容性 — 使Opensearch2与最新的2.4.4版本兼容。

v2002.2.4

发行日期： 2025年4月24日

  • 修复图标 适用于2.4.4/2.4.5​的Opensearch2 — 修复了与Adobe Commerce版本2.4.4/2.4.5.opensearch2中支持 相关的问题

v2002.2.3

发行日期： 2025年4月9日

  • 修复图标 修复Valkey​修复了Valkey自定义配置的问题。
  • 修复图标 修复验证器 — 适用于RabbitMQ 4.0的修复验证器。

v2002.2.2

发行日期： 2025年4月7日

v2002.2.2

发行日期： 2025年4月7日

  • new icon Valkey — 添加了对新服务(Valkey)的支持，该服务是Redis的替代服务。
  • 修复图标 适用于2.4.4/2.4.5​的Opensearch2 — 在Adobe Commerce版本2.4.4/2.4.5.opensearch2中添加了对 的支持

v2002.2.1

发行日期： 2024年2月6日

  • 新图标 PHP 8.4 — 添加了对PHP 8.4. 的支持
  • 修复图标 Opensearch的验证器 — 修复了生成有关错误服务版本的误导性消息的验证器。

v2002.2.0

发行日期： 2024年10月7日

  • 新图标 MariaDB 11.4 — 已添加MariaDB 11.4的支持。
  • 修复图标 重构的代码 — 已删除对旧PHP版本7.4、7.3、7.2和相关库的支持。
  • 修复图标 升级了单色版本 — 添加了对单色版本3.6的支持。
  • 修复图标 RabbitMQ、MariaDB和PHP的验证器 — 修复了生成有关错误服务版本的误导性消息的验证器。

v2002.1.19

发行日期： 2024年5月21日

  • 新图标 Lua — 已为CACHE_CONFIGURATION添加选项useLua。
  • 修复图标 验证器 — 已更新Redis和RabbitMQ新版本的验证器。

v2002.1.18

发行日期： 2024年4月8日

  • 新图标 PHP — 添加了对PHP 8.3的支持。
  • 修复图标 验证器 — 已更新EOL验证器。

v2002.1.17

发行日期： 2024年1月16日

  • 修复图标 Elasticsearch和OpenSearch的验证器 — 修复了在启用LiveSearch时生成误导性消息以安装搜索服务的验证器。
  • 修复图标 部署警告 — 修复了导致出现非空文件夹部署警告的问题。

v2002.1.16

发行日期： 2023年10月16日

  • 新图标 ENABLE_WEBHOOKS全局环境变量 — 添加了ENABLE_WEBHOOKS全局变量，以便与Commerce Webhooks一起使用来连接到外部端点，如App Builder运行时操作或第三方清单管理系统。

v2002.1.15

发行日期： 2023年7月31日

  • 修复图标 错误代码 — 已更新错误代码架构和错误代码文档生成器。
  • 修复图标 自定义Redis模型的验证器 — 已更新自定义Redis后端模型的验证器。 查看缓存配置的示例。
  • 修复图标 RabbitMQ的验证器 — 已添加对RabbitMQ 3.11的支持
  • 修复图标 修复了错误的链接 — 修复了欢迎电子邮件模板中指向载入文档的错误链接。

v2002.1.14

发行日期： 2023年3月10日

  • 新图标 PHP — 添加了对PHP 8.2的支持。
  • 新图标 服务验证器 — 更新了Commerce 2.4.6所需服务的验证器：MariaDB 10.6、Redis 7.0、PHP 8.2、OpenSearch 2.x和RabbitMQ 3.9。
  • 修复图标 ece-tools db-dump — 修复了导致db-dump操作过早停止的问题。

v2002.1.13

发行日期： 2022年10月27日

  • 新图标 已添加对Adobe Commerce的Adobe I/O Events的支持。 扩展开发人员现在可以使用Adobe I/O Events框架将云实例中的Commerce事件信息发送到其为Adobe App Builder编写的应用程序。 适用于Adobe Commerce的Adobe I/O Events在“合作伙伴预览”中。
  • 新图标 OPcache配置的验证器 — 已添加验证器以检查排除路径的OPcache配置。
  • 修复图标 修复了GraphQL缓存配置的问题 — 现在，ECE-Tools在id_salt文件中保留cache配置中的GraphQL app/etc/env.php值。

v2002.1.12

发行日期： 2022年9月13日

  • 新图标 启用synchronous_replication — 启用synchronous_replication=>true时，ECE-Tools在app/etc/env.php文件中设置MYSQL_USE_SLAVE_CONNECTION。 此配置仅影响Commerce 2.4.6+。 在MYSQL_USE_SLAVE_CONNECTION部署变量.中查看 变量说明
  • 新图标 OpenSearch — 添加了配置和设置下一个Adobe Commerce版本2.4.6的opensearch引擎的功能。请参阅设置OpenSearch服务。

v2002.1.11

发行日期： 2022年8月4日

  • 修复图标 ElasticSuite Validator和OpenSearch — 修复了在安装OpenSearch时的ElasticSuite完整性检查验证器问题。
  • 修复图标 部署命令的返回类型 — 修复了部署命令的返回类型。
  • 安装Commerce 2.4.5时出现了 修复图标 RabbitMQ问题 — 修复了安装Commerce 2.4.5时出现的RabbitMQ崩溃问题。

v2002.1.10

发行日期： 2022年3月31日

  • 修复图标 Elasticsearch 7.10 — 更新了验证器以支持Elasticsearch 7.10版本。

v2002.1.9

发行日期： 2022年3月10日

  • 新图标 OpenSearch — 添加了对Adobe Commerce版本2.4.4、2.4.3-p2和2.3.7-p3.的OpenSearch的支持

  • 新图标 PHP — 添加了对PHP 8.1的支持。

  • 修复图标 symfony/process — 添加了与symfony/process ^5.3的兼容性。

  • 新图标 使用者多个进程 — 添加了multiple_processes选项，以便您可以指定每个使用者要衍生的进程数。 在CRON_CONSUMERS_RUNNER部署变量.中查看变量说明

  • 新图标 OpenSearch方案和完整主机路径 — 添加了配置Elasticsearch方案和完整主机路径的功能。

  • 修复图标 AWS S3 — 更改了AWS S3启用方法。

  • 修复图标 修复driver_options读取器 — 已添加env.php从验证器的ece-tools文件中读取DB连接的driver_options配置。

v2002.1.8

发行日期： 2021年10月25日

  • 新图标 备用转储位置 — 添加了--dump-directory选项，以便您可以为数据库转储选择目标目录。 现在/app/var/dump-main是数据库转储的默认目标目录。 请参阅备份管理：转储数据库
  • 修复图标 更新单一日志 — 已将monolog包所需的最低版本更新为^2.3。
  • 修复图标 更新Symfony — 已更新Symfony依赖项以便与Adobe Commerce 2.4.4兼容。
  • 修复图标 功能/解决自动加载 — 修复了部署到集成环境并看到CRITICAL: [9] Required configuration is missed in autoload section of composer.json file.错误时的问题。

v2002.1.7

发行日期： 2021年7月29日

配置更新—

  • 新图标 已添加对Composer 2.0.的支持

  • 修复图标 更新了symphony/console​的编辑器要求 — 更新了composer.json包的ECE-Tools symphony/console版本要求，以修复导致di:compile命令失败并出现以下错误的问题： Incompatible argument type: Required type: int. Actual type: string

  • 修复图标 更新了软件生命周期结束检查(eol.yaml)以包含Elasticsearch 7.9.x。

v2002.1.6

发行日期： 2021年4月20日

  • 新图标 Redis身份验证凭据 — 已添加在部署阶段从relationships属性读取Redis授权凭据的功能。

  • 新图标 Elasticsearch授权凭据 — 已添加在部署阶段从relationships属性读取Elasticsearch授权凭据的功能。

  • 新图标 专用会话存储服务 — 已添加redis-session作为会话存储的第二个选项。 您可以使用redis-session服务来存储会话信息，并使用redis服务来缓存以提供更好的性能。

  • 新图标 已弃用的SPLIT_DB消息 — 为Adobe Commerce 2.4.2的已弃用SPLIT_DB选项添加了验证器警告和严重消息，并在Adobe Commerce 2.5.0中删除了该选项。

  • 修复图标 来自关系的Elasticsearch版本 — 修复了服务验证器，以便从Cloud Docker和集成环境中的relationships属性中检索Elasticsearch的正确版本。

  • 修复图标 灵活的Redis端口验证—Redis现在可以从server URL验证自定义缓存连接中的端口。 例如，您可以将端口号添加到服务器URL中，如下所示： server: 'tcp://rfs-store-simple-page-cache:26379'。 这有助于防止port选项缺失或不正确的验证错误。

  • 修复图标 升级到Adobe Commerce 2.4.2 — 修复了在升级到Adobe Commerce 2.4.2后要求用户手动运行bin/magento setup:upgrade以使他们的站点正常运行的问题。

v2002.1.5

发行日期： 2021年2月1日

  • 新图标 远程存储 — 添加了REMOTE_STORAGE环境变量，以启用云项目以使用存储服务(如AWS S3)远程存储媒体文件。 此配置选项是ECE-Tools包的一部分，但在云基础架构上的Adobe Commerce上不受支持。

  • 新图标 新cloud:config:validate命令 — 添加了命令php vendor/bin/ece-tools cloud:config:validate，用于在将更改推送到远程云环境之前验证.magento.env.yaml配置。

  • 新图标 刷新opcache — 添加了opcache.enable_cli PHP选项的支持，可在运行部署挂接之前刷新OPcache。 此配置将重置缓存配置，以确保当前配置设置应用于每个部署。

  • 新图标 验证Aurora DB — 已更新数据库服务验证，以便它与Aurora数据库兼容。

  • 新图标 新SCD_NO_PARENT环境变量 — 已添加SCD_NO_PARENT环境变量(适用于Adobe Commerce >=2.4.2)以管理父主题的静态内容生成。

  • 修复图标 内存限制和命令 — 修复了当php vendor/bin/ece-tools文件的大小超过PHP memory_limit时，cloud.log命令无法运行的问题。 现在，我们只从日志文件读取较小的数据子集，而不是将整个cloud.log文件读入内存。

  • 修复图标 自定义数据库连接 — 修复了未使用为.magento.env.yaml定义的自定义数据库连接的DATABASE_CONFIGURATION配置问题。 未将连接设置添加到app/etc/env.php.

  • 修复图标 空错误日志 — 修复了cloud.error.log为空时导致部署失败的问题。

  • 修复图标 MariaDB 10.3验证 — 修复了Adobe Commerce 2.3.6-p1的MariaDB 10.3验证。

  • 修复图标 缓存:flush日志记录 — 改进了日志条目以指示cache:flush步骤的开始和完成。

v2002.1.4

发行日期： 2020年11月19日

  • 修复图标 修复了在SEARCH_CONFIGURATION环境变量中指定的搜索引擎是elasticsearch以外的值时导致部署失败的问题。

v2002.1.3

发行日期： 2020年11月9日

基础架构更新—

  • 新图标 当静态内容设置为在生成阶段中部署时，为只读pub/static目录添加了ECE-Tools支持。

  • 新图标 已添加对Elasticsearch 7.9和Redis 6的支持，以便与即将发布的Adobe Commerce版本兼容。

  • 修复图标 已更新ECE-Tools composer.json以添加质量修补程序工具所需的依赖项。 这修复了ECE-Tools和magento-cloud-patches包之间存在的循环依赖关系。

验证和日志改进—

  • 新图标 已添加搜索引擎验证，以确保在云基础架构2.4及更高版本上为Adobe Commerce设置elasticsearch。 如果验证失败，部署将停止，并显示一条关键错误消息，建议修复此问题。 查看严重错误，部署阶段。

  • 新图标 已添加Elasticsearch验证，以检查Elasticsearch服务版本与Adobe Commerce版本之间的兼容性。

  • 新图标 更新了Elasticsearch兼容性错误消息，以显示与Adobe Commerce Elasticsearch模块兼容的Elasticsearch版本。 现在，错误消息会提供要在您的Elasticsearch基础架构中安装的特定Cloud版本，以便与您的Adobe Commerce版本使用的Elasticsearch模块兼容。 查看警告错误，部署阶段。

  • 新图标 为无效的2026环境变量设置添加了警告错误2027和MAGE_MODE。 唯一有效值为production。 在此修复之前，可以将MAGE_MODE设置为developer，而不会出现部署错误，但只会在以后尝试写入只读文件时导致错误。 查看警告错误.

  • 修复图标 修复了Redis、RabbitMQ和MySQL服务的验证，以确保这些版本与Adobe Commerce版本兼容。 这些服务的有效版本现在写入cloud.log.

  • 修复图标 已更新cloud.log以包含在缓存预热期间发送请求的并发请求限制。 此值在WARM_UP_CONCURRENCY部署后变量中进行配置。

CLI命令更新—

  • 新图标 添加了CLI命令（cloud:config:create和cloud:config:update），用于创建和更新.magento.env.yaml文件，其配置可以包括一个或多个生成、部署和部署后变量。 请参阅从CLI创建配置文件。

环境变量更新—

  • 新图标 已添加SKIP_COMPOSER_DUMP_AUTOLOAD内部版本变量。 将变量设置为true会在安装Cloud Docker for Commerce期间停止应用程序运行composer dump-autoload命令。 变量仅与具有可写文件系统（为使用./vendor/bin/ece-docker build:compose --with-test进行测试和开发而创建）的Commerce容器的Cloud Docker相关。 对于此类安装，跳过composer dump-autoload命令可防止在运行尝试从已删除的generated目录访问文件的其他命令时出现错误。

v2002.1.2

发行日期： 2020年8月5日

验证和日志改进—

  • 新图标 添加了schema.error.yaml文件，该文件包含在生成、部署和部署后过程中可能发生的所有错误和警告通知以及解决错误的建议。 此文件中的信息也可在​ Commerce云指南 ​中找到。 查看ece-tools的错误消息引用。

  • 新图标 已将云错误日志(/var/log/cloud.error.log)条目更改为JSON格式，以使该日志更易于以编程方式解析。

  • 新图标 添加了额外的错误检查以生成、部署和部署后处理，并改进了现有检查：

    • 错误代码2026 — 未能将构建阶段生成的一些数据恢复到装入的目录

    • 错误代码3004 — 无法创建备份文件

    • 错误代码102 — 添加了对env.php文件不可写时发生的问题的额外检查

  • 新图标 已添加​ QUALITY_PATCHES ​环境变量，以指定要在部署过程中应用的一个或多个质量修补程序。 查看生成变量.

v2002.1.1

发布日期： 2020年6月25日

/fragments/zh-hans/docs/commerce-on-cloud/user-guide/release-notes/ece-tools-package/fragment-0
7c2b03ac-000c-497d-aba3-2c6dc720a938