ECE-Tools发行说明

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配置。

已添加对Composer 2.0.的支持

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

更新了软件生命周期结束检查(eol.yaml)以包含Elasticsearch7.9.x。

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

Elasticsearch授权凭据 — 添加了在部署阶段从relationshipsElasticsearch读取资产授权凭据的功能。

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

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

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

灵活的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以使他们的站点正常运行的问题。

远程存储 — 添加了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)以管理父主题的静态内容生成。

内存限制和命令 — 修复了当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验证。

缓存：刷新日志记录 — 改进了日志条目以指示cache:flush步骤的开始和完成。

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

已添加对Elasticsearch7.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 CommerceElasticsearch模块兼容的Elasticsearch版本。 现在，错误消息会提供要在您的Cloud基础架构中安装的特定Elasticsearch版本，以便与您的Adobe Commerce版本使用的Elasticsearch模块兼容。 查看警告错误，部署阶段。

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

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

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

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

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

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

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

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

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

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

基础架构更新—

• 日志记录改进 — 改进了日志跟踪功能，将退出代码分配给严重的部署错误，并在错误消息通知和日志事件中公开退出代码。 查看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的支持。

环境变量更新—

• 添加了​ SCD_USE_BALER ​变量，以便在Adobe Commerce on Cloud基础架构构建过程中为JavaScript捆绑启用包模块。 查看生成变量.中的变量说明

• 已添加​ REDIS_BACKEND ​环境变量以为Adobe Commerce 2.3.5或更高版本的Redis缓存配置Redis后端模型。 查看部署变量.中的变量说明

CLI命令更新—

• 更新了以下CLI命令，其中包含用于更详细日志记录的选项：

  • app:config:dump
  • app:config:import
  • module:enable

  每个调用的日志记录级别由.magento.env.yaml文件中VERBOSE_COMMANDS变量的配置决定。

验证改进—

• Elasticsearch7.x兼容性检查 — 已更新Elasticsearch7.x软件兼容性检查的Elasticsearch验证。

• 更新了服务版本和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.

基础架构更新—

• 为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仍然受支持。 但是，必须更新为新格式才能使用基于场景的部署功能。 请参阅基于方案的部署。