ECE-Tools发行说明
ece-tools包是一组用于管理和部署云项目的脚本和工具。 这些发行说明介绍了此包的最新改进,此包是适用于Commerce的Cloud Tools Suite的一部分。
ece-tools包的最新版本的信息,请参阅升级ECE工具。ece-tools包使用以下版本控制序列: 200<major>.<minor>.<patch>
发行说明包括:
-
新功能 -
修复和改进
v2002.2.11 latest
发行日期: 2026年5月06日
-
RabbitMQ — 已添加RabbitMQ 4.2支持。 -
Opensearch — 为多个Magento版本添加了Opensearch 2.19和3.5支持。 -
Valkey — 已添加Valkey 8.1和9支持。 -
ActiveMQ — 已添加ActiveMQ 2.5.1支持。 -
MariaDB — 已添加MariaDB 11.8和12.2支持。 -
配置和部署 — 修复了云部署警告、更新了编辑器测试弃用并更正了部署时的ECE工具版本可见性。
v2002.2.10
发行日期: 2026年3月5日
-
PHP 8.5 — 添加了对PHP 8.5的支持。 -
已更新功能测试 — 已更新Valkey 8.1、8、2和Redis 8.4测试 -
已更新MariaDB、PHP和Opensearch验证器 — 已更新验证器脚本。 -
EOL验证器 — 已更新生命周期结束(EOL)服务日期。
v2002.2.9
发行日期: 2025年11月13日
-
Symfony包 — 已添加对最新Symfony YAML包的支持。 -
修复了活动服务的缓存清理 — 添加了活动服务验证。
v2002.2.8
发行日期: 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日
-
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在app/etc/env.php文件中保留cache配置中的GraphQLid_salt值。
v2002.1.12
发行日期: 2022年9月13日
-
启用synchronous_replication— 启用MYSQL_USE_SLAVE_CONNECTION时,ECE-Tools在app/etc/env.php文件中设置synchronous_replication=>true。 此配置仅影响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读取器 — 已添加ece-tools从验证器的env.php文件中读取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的编辑器要求 — 更新了symphony/console包的ECE-Toolscomposer.json版本要求,以修复导致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现在可以从serverURL验证自定义缓存连接中的端口。 例如,您可以将端口号添加到服务器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_cliPHP选项的支持,可在运行部署挂接之前刷新OPcache。 此配置将重置缓存配置,以确保当前配置设置应用于每个部署。 -
验证Aurora DB — 已更新数据库服务验证,以便它与Aurora数据库兼容。 -
新SCD_NO_PARENT环境变量 — 已添加SCD_NO_PARENT环境变量(适用于Adobe Commerce >=2.4.2)以管理父主题的静态内容生成。 -
内存限制和命令 — 修复了当cloud.log文件的大小超过PHP memory_limit时,php vendor/bin/ece-tools命令无法运行的问题。 现在,我们只从日志文件读取较小的数据子集,而不是将整个cloud.log文件读取到内存中。 -
自定义数据库连接 — 修复了未使用为DATABASE_CONFIGURATION定义的自定义数据库连接的.magento.env.yaml配置问题。 未将连接设置添加到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-Toolscomposer.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模块兼容。 查看警告错误,部署阶段。 -
为无效的MAGE_MODE环境变量设置添加了警告错误2026和2027。 唯一有效值为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日
-
基础架构更新—-
日志记录改进 — 改进了日志跟踪功能,将退出代码分配给严重的部署错误,并在错误消息通知和日志事件中公开退出代码。 查看ece-tools🔗的错误消息引用。 -
改进了数据库转储的进程(vendor/bin/ece-tools db-dump)并更新了日志消息,以明确说明数据库转储操作将应用程序切换到维护模式,停止使用者队列进程,并在转储开始之前禁用cron作业。 -
修复了一个问题,以确保在部署到暂存环境和生产环境时项目URL正确更新。 现在,ece-tools在项目路由配置中设置了primary:true属性的路由使用该URL。 查看部署变量. -
已更新用于应用修补程序的generate.xml生成方案工作流。 必须提前应用修补程序以更新Adobe Commerce,从而修复可能导致di:compile和module:refresh步骤失败的任何问题。 -
修复了安装过程中错误返回Crypt key missing错误的问题。crypt/key值在安装期间自动生成。
-
-
服务更新—-
添加了对PHP 7.4和MariaDB 10.4的支持。
-
-
环境变量更新— -
CLI命令更新—-
更新了以下CLI命令,其中包含用于更详细日志记录的选项:app:config:dumpapp:config:importmodule:enable
每个调用的日志记录级别由
.magento.env.yaml文件中VERBOSE_COMMANDS变量的配置决定。
-
-
验证改进—-
Elasticsearch 7.x兼容性检查 — 更新了Elasticsearch验证以进行Elasticsearch 7.x软件兼容性检查。 -
更新了服务版本和EOL验证检查 — 更新了验证以根据Adobe Commerce 2.4检查已安装的服务版本。 要求。 -
修复了一个验证问题,以便仅在.magento.app.yaml文件中缺少post-deploy挂接配置时显示以下部署后警告消息:code language-text Your application does not have the "post_deploy" hook enabled. -
已添加Zend Framework依赖项验证 — 已添加已迁移到Laminas项目的Zend Framework的编辑器依赖项验证。 如果缺少所需的依赖关系,则在构建过程中会显示以下错误消息。code language-text Required configuration is missing from the autoload section of the composer.json file. Add ("Laminas\Mvc\Controller\Zend\": "setupsrc/ Zend/Mvc/Controller/") to the `autoload -> psr-4` section. Then, re-run the "composer update" command locally, and commit the updated composer.json and composer.lock files.请参阅验证Zend框架依赖项。
-
已添加env.php文件和数据的验证 — 已在安装和升级过程中添加对env.php文件和数据的检查。-
如果安装中缺少
env.php文件,并且未在.magento.app.yaml文件中指定crypt/key值,则部署将失败,并出现以下通知:code language-text The crypt/key key value does not exist in the ./app/etc/env.php file or the CRYPT_KEY cloud environment variable``Missing crypt key for upgrading Magento`. -
如果安装不包含
env.php文件,或配置仅包含一个缓存类型,则在升级过程中将运行cron:enable命令以恢复包含所有cache_types的文件。 以下通知将添加到日志中:code language-text Magento state indicated as installed but configuration file app/etc/env.php was empty or did not exist. Required data will be restored from environment configurations and from the .magento.env.yaml file.
-
-
v2002.1.0
发行日期: 2020年2月6日
-
基础架构更新—-
为Commerce的Cloud Docker添加了单独的包 — 将Docker包与ece-tools包分离,以保持代码质量并提供独立的发行版。 从magento-cloud-docker GitHub存储库中管理与ece-tools相关的更新和修复。 -
更新了修补功能 — 已将修补功能从ECE-Tools包移动到单独的magento-cloud-patches包。 在部署期间,ece-tools使用新包来应用修补程序。 请参阅Cloud修补程序发行说明. -
已更新编辑器依赖项 — 已更新云基础架构上Adobe Commerce的composer.json文件,该文件依赖于magento/magento-cloud-docker包。 现在,ece-tools包含Cloud Tools Suite for Commerce中所有包的依赖项。 安装或更新ece-tools时,会自动安装和更新这些软件包。
-
-
支持基于方案的部署—-
现在您可以使用XML配置文件自定义生成、部署和部署后进程以覆盖或自定义默认配置。 -
已在.magento.app.yaml中更改hooks配置 — 我们更新了hooks配置格式以支持基于方案的部署。 旧版ECE-Tools 2002.0.x仍然受支持。 但是,必须更新为新格式才能使用基于场景的部署功能。 请参阅基于方案的部署。
-
-
服务更新—-
添加了对PHP 7.3.的支持 -
已添加对RabbitMQ 3.8.的支持 -
已添加验证,以根据每个服务的EOL日期检查已安装的服务版本。 现在,如果服务版本在EOL日期后的三个月内,客户将收到通知,如果EOL日期在过去,客户将收到警告。 -
修复了Elasticsearch配置问题,以确保在所有环境中都配置了正确的Elasticsearch设置。
-
-
环境变量更新—-
扩展了WARM_UP_PAGES环境变量的功能,以支持特定产品页面的缓存预加载。 请参阅部署后变量主题中的扩展定义。 -
添加了ERROR_REPORT_DIR_NESTING_LEVEL环境变量,以简化<magento_root>/var/report/目录中的错误报告数据管理。 请参阅生成变量主题中的变量说明。 -
已删除SCD_EXCLUDE_THEMES、STATIC_CONTENT_THREADS、DO_DEPLOY_STATIC_CONTENT和STATIC_CONTENT_SYMLINK环境变量。 查看向后不兼容的更改. -
修复了Elastic Suite配置过程中的问题,以便在配置ELASTICSUITE_CONFIGURATION部署变量而不使用_merge选项时,按预期覆盖默认配置。
-
-
CLI命令更新—-
新cron命令 — 您现在可以使用cron:disable和cron:enable命令在Adobe Commerce中在云基础架构环境中手动管理cron处理。 使用disable命令停止所有活动的cron进程并禁用所有cron作业。 准备就绪后,使用enable命令重新启用cron作业。 请参阅禁用cron作业。 -
改进了错误报告 — 为ECE-Tools处理期间发生的CLI命令失败添加了更好的日志记录。 -
删除已弃用的生成命令 — 删除了以下生成命令:m2-ece-build、m2-ece-deploy、m2-ece-scd-dump,并将ece-tools docker命令重命名为ece-docker。 查看向后不兼容的更改
-
-
删除了已弃用的build_options.ini文件并添加了验证,如果文件存在,则生成会失败。 使用.magento.env.yaml文件配置生成选项。 -
修复了config.php文件为空时导致生成过程失败的问题。
2002.0.23
发行日期: 2020年2月27日
-
修复了ece-tools2002.0.x版本的兼容性问题,该问题导致按需静态内容生成无法在生产模式下成功完成。
旧版本
请参阅版本2002.0.22和更早版本的发行说明存档。