ece-tools的发行说明存档

对ECE-Tools包的更改

• 已将Adobe Commerce修补程序从ece-tools包移动到新的magento/magento-cloud-patches编辑器包。

• 已更新ece-tools包的composer.json文件以添加magento/magento-cloud-patches v1.0.0包的依赖项。

• 修复了从2.3.2-p2及更高版本开始，在仅安全版本之上应用修补程序集时导致ece-tools修补过程中断的问题。 此问题是由为仅限安全的修补程序.采用的新版本化方案引入的

修补程序和关键修复 — 使用ece-tools版本2002.0.22更新您的云环境以应用以下修补程序和关键修复。 这些修补程序包含在magento/magento-cloud-patches v1.0.0程序包中。

• 适用于2.3.1.x和2.3.2.x版本的Page Builder安全修补程序 — 修复了Page Builder预览中的问题，该问题允许未经身份验证的用户访问某些模板化方法，这些方法可用于通过网络触发任意代码执行(RCE)，从而导致全局信息泄漏。 在Adobe Commerce版本2.3.1和2.3.2.中使用不受支持的页面生成器版本时，可能会出现此问题

• MSI修补程序 — 修复了在使用默认库存设置管理库存时导致索引错误和性能问题的情况。

• 新邮件接口的向后兼容性 — 修复了Adobe Commerce v2.3.3中引入的Magento\Framework\Mail\EmailMessageInterface PHP接口导致的向后不兼容问题。 在此修补程序的范围内，新EmailMessageInterface继承自旧MessageInterface，Adobe Commerce核心模块将还原为依赖于MessageInterface。

• 目录分页在Elasticsearch 6.x上不起作用 — 修复了搜索结果分页的一个严重问题，该问题影响使用Elasticsearch 6.x作为目录搜索引擎的客户。

Docker更新—

• 新Docker映像 — 受版本2.3.3和更高版本支持

  • PHP版本7.3.

  • 清漆缓存6.2.0

• 添加支持在Docker环境中应用.magento.app.yaml中指定的自定义挂接配置。 以前，Docker环境仅支持默认挂接配置。

• Docker环境文件在Docker构建期间不再生成，并且docker:config:convert命令已弃用。 相应的数据现在存储在docker-compose.yml文件中。

• 已更新PHP映像 — 已将Node.js添加到PHP Docker映像以支持node、npm和grunt-cli功能。

环境变量更新-

• 添加了​ LOCK_PROVIDER ​部署变量以配置锁定提供程序，该变量阻止启动重复的cron作业和cron组。 请参阅部署变量主题中的变量说明。

• 添加了​ CONSUMERS_WAIT_FOR_MAX_MESSAGES ​环境变量，以配置在使用CRON_CONSUMERS_RUNNER环境变量管理cron作业时使用者如何处理来自消息队列的消息。 请参阅部署变量主题中的变量说明。

• 修复了当consumers_runner cron作业在不同节点上启动同一使用者的多个实例时可能导致数据库死锁错误的问题。 现在，如果您在环境中启用了​ CRON_CONSUMERS_RUNNER ​部署变量，consumers_runner作业将使用single-thread选项在一个节点上启动每个使用者的一个实例。

• 修复了影响使用默认存储URL的​ WARM_UP_PAGES ​功能的问题。 现在，如果config:show:default-url命令无法获取基本URL，则使用MAGENTO_CLOUD_ROUTES变量中的URL。

更新了module:refresh命令返回的日志信息。 现在，您可以在cloud.log文件中看到已启用的模块的详细列表。

针对Adobe Commerce版本与已安装的服务（如Elasticsearch、RabbitMQ、Redis和DB）之间的兼容性问题，改进了版本兼容性验证和警告通知。

已添加对RabitMQ版本3.8.的支持

更新了服务兼容性的交互式验证，以反映新的Adobe Commerce 2.3.3和2.2.10版本支持的版本。 有关推荐的版本，请参阅​ 安装指南 ​中的系统要求。

改进了部署阶段的cron作业管理进程尝试停止已完成的cron作业时返回的日志消息，以澄清此问题不是错误。 已将日志级别从INFO更改为DEBUG。

修复了在运行setup:upgrade命令时未在app:config:import任务期间发生失败时中断部署过程的问题。

已将文件处理程序的默认日志级别更改为debug以减少Cloud Console中显示的日志中的详细信息量，同时仍提供调试的详细信息。

修复了在生成期间导致静态内容部署错误的问题。 安装和ece-tools配置转储后，如果在config.php文件中没有为管理员用户指定区域设置，则会发生错误。 现在，config.php文件中存在管理员用户的默认区域设置。

修复了在未配置安全URL (https)的环境中执行magento-cloud CLI命令失败时出现的Undefined index error。 现在，如果安全URL不可用，ECE-Tools包将使用基本URL (http)。

Docker更新—

• 您现在可以在Docker环境中使用ece-tools包执行功能测试。 查看应用程序测试.

• 添加了对使用.magento.app.yaml文件配置PHP模块的支持。 在.magento.app.yaml文件🔗中指定的任何PHP扩展将在Docker PHP容器中变得可用。

• 有新命令可用于改进Docker命令行体验。 查看Docker引用](https://developer.adobe.com/commerce/cloud-tools/docker/quick-reference#cloud-docker-cli).的[bin/magento-docker部分

• 添加了使用Mutagen.io在本地主机和Docker之间进行开发期间同步文件的功能。

• 在使用Docker环境时更正了默认路径。 现在，当您使用SSH登录到Docker容器时，您按预期位于/app目录中的项目根目录。

• 已将钠库从版本1.0.11更新到版本1.0.18，并更新了Na PHP扩展。

  note warning
  WARNING
  云基础架构上的Adobe Commerce客户必须提交Adobe Commerce支持票证，以便在升级到Adobe Commerce 2.3.2之前在专业生产和暂存环境中升级libna包。 目前，您无法将入门环境升级到Adobe Commerce 2.3.2。

• 已将analysis-icu和analysis-phonetic个Elasticsearch插件添加到所有Docker图像。

• 改进的验证：为docker:build命令使用选项时，必须在使用选项时提供值。 此外，在使用docker:build run命令时添加了节点版本的验证。

环境变量更新—

• 添加了对使用DATABASE_CONFIGURATION环境变量的数据库表前缀的支持。

• 添加了​ FORCE_UPDATE_URLS ​部署变量，以便在部署到Pro和Starter生产和暂存环境时更新基本URL。 查看部署变量内容中的定义。

• 添加了​ TTFB _TESTED_PAGES ​部署后变量以配置_到第一个字节的时间_页面测试以检查部署到云基础架构的站点上的应用程序性能。 查看部署后变量中的变量说明。

• 修复了多线程SCD的问题，该问题会导致静态内容部署中出现随机失败。 解决方法是将​ SCD_THREADS ​变量设置为1。 您现在可以根据需要增加数量。 查看部署变量和生成变量.中的定义

• 您可以配置​ WARM_UP_PAGES ​环境变量以缓存单个页面、多个域和多个页面。 查看部署后变量内容中的扩展定义。

已将pub/static/.htaccess文件添加到排除列表。 由PHOENIX MEDIA GmbH的Bjorn Kraus提交的修复。

修复了在至少一个关键级别验证器返回错误时，所有验证消息显示为Critical的错误。

修复了在数据库中不存在基础URL时导致部署失败的问题。

向ece-tools包中添加了新的​env:config:show命令，该包显示环境服务、路由或变量。 请参阅服务、路由和变量。 Vladimir Kerkhoff提交的功能.

修复了在外壳重构后尝试安装Adobe Commerce 2.2.6或更早版本（具有ece-tools开发）时导致严重错误的问题。

修复了导致Adobe Commerce 2.1.x和2.2.x安装失败的问题，并警告您使用已弃用的Carbon版本。

已将shell输出的cloud.log日志级别从info降低为debug。

已将--remove-definers (-d)选项添加到ece-tools db-dump命令以从转储文件中删除定义符。

Docker更新—

• 现在，Docker环境支持.magento.app.yaml文件](https://experienceleague.adobe.com/zh-hans/docs/commerce-on-cloud/user-guide/configure/app/properties/crons-property).的[crons属性中定义的cron配置

• 新Docker容器 — 添加了TLS终止代理容器，以便于通过HTTPS终止Varnish SSL。

• 新Docker映像 — 添加了Node.js映像以支持Gulp和其他功能，如Jasmine JS单元测试。

• Docker生成模式 — 现在您可以选择在生产模式或开发人员模式中启动Docker环境。 开发人员模式支持具有完全可写文件系统权限的活动开发。

• 修复了在缓存针对不可用的服务配置时，导致Docker部署失败并出现Name or service not known错误的问题。 现在，您可以从.magento/services.yaml文件中删除服务。 Docker配置生成器自动更新docker/config.php.dist文件中的服务。

• 添加了对服务兼容性的交互式验证。 现在，如果请求的服务与Adobe Commerce版本或其他服务不兼容，交互模式​将提示用户一条消息并选择继续。 查看可用于Docker的服务版本。 使用-n选项跳过用于CICD的交互。

• 修复了Docker合成db-dump命令中擦除现有转储的问题。

• 修复了将Redis session、default和page_cache缓存存储分配到同一数据库ID的问题。

环境变量更新—

• 新的​ ELASTICSUITE_CONFIGURATION ​环境变量会在部署之间保留自定义的服务设置。 查看部署变量内容中的定义。

• 添加了​ SCD_MAX_EXECUTION_TIMEOUT ​环境变量，以便您可以增加从.magento.env.yaml文件完成静态内容部署的时间。 查看部署变量、生成变量和全局变量中的定义。

  • 已添加​ MAGENTO_CLOUD_LOCKS_DIR ​环境变量，以便为云基础架构上的锁定提供程序配置装入点的路径。 锁定提供程序阻止启动重复的cron作业和cron组。 Adobe Commerce版本2.2.5及更高版本支持此变量，并且会自动配置此变量。 查看云变量.中的定义

  • 更改了​ SCD_THREADS ​环境变量默认值，以根据检测到的CPU线程计数自动确定最佳值。 查看部署变量和生成变量中更新的定义。

修复了在2002.0.16版的云基础架构上升级到Adobe Commerce时，导致错误的数据库隔离机制修补程序问题。

添加了一个修补程序，该修补程序将​ Google图像图表 ​替换为​图像图表。 请参阅DevBlog文章M1的Google图像图表弃用和更新。

已添加SEARCH_CONFIGURATION变量的验证。 未设置“engine”选项且不需要使用_merge时，部署失败。

修复了在发生异常后公开敏感数据的问题。 现在，敏感信息已适当屏蔽。

改进了Magento Open Source包的容错设置。 在Adobe Commerce无法从Redis slave实例读取数据的情况下，将从Redis master实例进行读取。 请参阅REDIS_USE_SLAVE_CONNECTION.

服务更新 — 以下Adobe Commerce版本支持： 2.2.8及更高版本2.2.x、2.3.1及更高版本2.3.x

• 添加了对Elasticsearch版本6.x.的支持

• 添加了对Redis版本5.0的支持。

新Docker映像 — 已将以下服务添加到Docker内部版本：

• Elasticsearch 6.5

• Redis 5.0

新环境变量 — 以前，SCD压缩存在硬编码超时。 现在可以使用​ SCD_COMPRESSION_TIMEOUT ​环境变量配置SCD压缩超时。 查看生成变量和部署变量内容中的定义。

已将--use-rewrites选项添加到安装命令中，以便该命令对店面中生成的链接使用Web服务器重写以及管理员访问权限来改进安全性和客户体验。

已向var/log/install_upgrade.log文件添加时间戳，以便该文件显示安装和升级事件的日期。

Docker更新—

• 现在，在Docker环境中生成的默认服务配置与云模板中的默认配置相同。

• 您可以使用sendmail服务从Docker环境发送邮件。

• 添加了将Xdebug配置为在Cloud Docker环境中调试的功能。

• 修复了在生成docker-compose.yml文件时有关Web服务权限的问题。

升级改进 — 添加了验证，以确认composer.json文件中的autoload属性在升级到Adobe Commerce v2.3之前包含所需的配置更改。 请参阅升级版本.

部署静态内容的压缩过程现在包括本机生成或自定义的所有资源，并且在build:transfer部分的开头的生成阶段发生。 以前，压缩过程在应用自定义缩小和静态资源捆绑之前进行。 由Rafael Garcia Lepper从Tryzens Limited提交的修复。

修复了在配置其他数据库和服务关系后立即在部署期间发生的数据库连接错误。 此外，此修复还解决了在Commerce Reporting for Starter配置过程中发生的问题。 首先，此升级对于使用Commerce报表而言是“必须具有”的。

修复了导致部署过程失败的数据库配置验证问题。

已使用要与PHP常量一起使用的相应版本的symfony/yaml包更新约束。 使用低于3.2版本的symfony/yaml包时，常量分析不起作用。 由Vladimir Kerkhoff提交的修复.

环境配置检查 — 添加了验证，用于检查PHP版本并在用户未使用最新的推荐版本时警告用户。

修复了处理格式错误的JSON变量时出现的问题。 现在，如果JSON变量导致语法错误，则cloud.log文件中将显示警告，并且使用默认变量继续部署。

修复了在禁用Redis服务后立即在部署期间发生的连接错误。

正在记录更改 — 已将以下生成和部署过程事件的日志级别从Info更新为Notice：

• 将composer.json中已安装的模块与app/etc/config.php文件中的共享配置设置进行协调的进程开始和结束

• 配置验证过程的开始和结束

• 生成类的setup:di:compile进程的开始和结束

新环境变量—

• RESOURCE_CONFIGURATION部署变量 — 使用此变量将资源名称映射到数据库连接。

• X_FRAME_CONFIGURATION全局变量 — 使用此变量更改在<frame>、<iframe>或<object>中呈现Adobe Commerce页面的X-Frame-Options标题配置。

环境变量更新 — 已更改以下环境变量：

• WARM_UP_PAGES — 添加了为为Adobe Commerce存储定义的所有域上的指定页面预加载缓存的功能。 以前，如果您的站点配置了多个域，则部署后进程未能在非默认域上预加载指定页面的缓存，并在部署后日志中返回以下错误： ERROR: Warming up failed: <uri>

• SCD_COMPRESSION_LEVEL — 已使用SCD压缩级别的正确默认值更新文档和示例.magento.env.yaml文件。 查看生成变量和部署变量内容中的定义。

• SCD_EXCLUDE_THEMES — 已弃用此环境变量。 使用SCD_MATRIX控制主题配置。

• SCD_MATRIX — 修复了验证过程，以防止在SCD_MATRIX忽略包含不同字符大小写的主题值时发生问题。 查看生成变量和部署变量内容中的定义。

• 管理员变量—

  • 提高了使用环境变量管理管理员用户凭据时的安全性。 在升级过程中，不能再使用ADMIN_EMAIL、ADMIN_USERNAME和ADMIN_PASSWORD环境变量覆盖管理员凭据。 如果无法访问管理员面板，请使用​ 忘记密码 ​功能或admin:user:create CLI命令来创建新的管理员用户。 查看访问您的管理员面板。

  • 升级或应用修补程序时不再需要ADMIN_EMAIL。

Docker更新—

• 现在，当构建Docker环境时，Docker生成器使用.magento.app.yaml和.magento/services.yaml配置文件中指定的服务。 您可以使用生成参数选择其他服务版本。

• 添加了PHP 7.2映像 — 在Cloud Docker中添加了对PHP 7.2的支持；更新了Launch Docker配置以包含docker:build --php选项，从而指定与您的Adobe Commerce版本兼容的PHP版本。

• 添加了基于PHP-CLI映像的Cron容器。

• 已将以下服务添加到Docker版本：

  • RabbitMQ 3.5和3.7

  • Elasticsearch 1.7、2.4和5.2

  • Redis 3.2和4.0

使用PHP常量进行配置 — 已在.magento.env.yaml配置文件中添加对PHP常量的支持。

新环境变量 — 默认情况下，只有生产环境启用了Google Analytics。 您可以使用ENABLE_GOOGLE_ANALYTICS环境变量.在暂存环境和集成环境中启用Google Analytics

修复了在重新部署后从env.php文件中删除自定义cron配置的问题。 现在，自定义cron配置安全地保留在env.php文件中。

修复了生成、部署和部署后阶段的消息和日志级别中的不一致。 将所有阶段和子阶段的开始和结束日志消息级别从​ 信息 ​增加到​通知。 添加开始和结束日志消息（如果适用）。

修复了在配置后阻止启动部署后阶段的cron进程的问题。 现在，如果您启用了部署后挂接，则会在部署后阶段的开始时再次启用cron进程。

解决了在指定自定义数据库配置时阻止成功安装Adobe Commerce的问题。 以前，安装过程使用MAGENTO_CLOUD_RELATIONSHIP变量的数据库配置，即使您在DATABASE_CONFIGURATION环境变量.中指定了自定义连接信息也是如此

已更正config:dump命令，以便该命令包含config.php文件的system部分中的每个网站区域设置。

通过更正源基本URL引用，修复了在部署后阶段导致​ 预热错误 ​的问题。

修复了在setup:di:compile过程中不正确地生成文件的问题，该问题影响Amazon支付模块。

验证理想状态 — 现在，ideal-state向导会在每次部署期间验证当前配置，并提供有关更新配置的明确说明，以实现更快的零停机部署。

PCI合规性 — 已更新云基础架构上Adobe Commerce的消息协议，以便在与第三方消息服务连接时要求使用传输层安全性(TLS)版本1.2。 如果您使用的消息服务不支持TLS版本1.2，则必须升级您的服务。 否则，当您的Adobe Commerce应用程序尝试连接到消息服务器以发送电子邮件时，会显示以下错误消息： Unable to connect via TLS。

部署改进 — 添加了验证功能，可在暂存或生产环境启用了dev、debug或debug_logging选项时警告客户，以防止因过多的日志记录活动而导致的性能问题。

部署修复—

• 现在，维护模式在部署阶段开始时启用，在部署阶段结束时禁用。 如果部署失败，站点将保持维护模式，直到解决部署问题为止。 以前，即使部署失败，站点也会返回到生产模式。

  • 已重新处理部署阶段验证检查，将以下部署问题的错误级别从CRITICAL降级为WARNING，以便完成部署。 以前，这些问题会导致部署失败。

  • 环境配置包含不正确的部署或云变量值。

• 云基础架构上的Elasticsearch版本与云基础架构上的Adobe Commerce支持的elasticsearch/elasticsearch模块的版本不兼容。 请参阅Adobe Commerce支持知识库中的Elasticsearch疑难解答文章。

• 修复了app/etc/config.php文件中的共享配置设置的问题，该问题在部署期间导致recursion detected错误。

Cron相关修复—

• 修复了在指定默认（1分钟）以外的cron频率时阻止作业运行的cron计划问题。

• 修复了部署阶段中存在的一个问题，该问题会导致cron作业在部署期间继续运行，从而可能导致数据库锁定和其他严重问题。 现在，所有cron作业都将在部署阶段开始之前停止，并在部署完成后重新启动。<！—MAGECLOUD—2537—>

• 修复了2.2.x版中的cron作业工作流以解锁冻结的cron作业，以便在开始部署之前停止它们。 以前，冻结的cron作业导致部署停止。

更改了vendor/bin/ece-tools config:dump命令生成的config.php文件的格式，以使用短数组语法和4空格缩进以符合Adobe Commerce编码标准。

修复了当.magento.env.yaml包含Web配置的{{ base_url }}和{{ unsecure_base_url }}占位符而不是云基础架构项目上Adobe Commerce的默认URL配置时发生的部署错误。/

启用零停机部署 — 现在，云基础架构上的Adobe Commerce在部署期间将包含所需数据库更改的请求排入队列，并在部署完成后立即应用更改。 请求最长可保留5分钟，以确保不会丢失任何会话。 查看静态内容部署选项，以缩短Cloud上的部署停机时间。

云的Docker撰写 — 对Docker设置和配置进程进行了以下改进：

• 添加了命令 — docker:config:convert，用于将PHP配置文件转换为Docker ENV格式以简化环境配置。 现在，将PHP配置文件复制到Docker目录，并将其转换为Docker ENV文件。 查看Launch Docker.

• Adobe Commerce on cloud基础架构安装过程现在支持同时部署到只读和读写文件系统，以便更密切地模拟云文件系统。 请参阅配置Docker。<！—MAGECLOUD—2357—>

• Redis服务支持 — 添加了一个Redis映像，该映像部署到Docker容器并自动配置为与Docker安装配合使用。<！—MAGECLOUD—2442—>

• 在使用Cloud Docker 数据库容器时，您现在具有数据库转储功能。 此外，您还可以使用docker/mnt目录在主机计算机和容器之间共享文件。

• Varnish服务支持 — 添加了Varnish映像，该映像自动部署到Docker容器。 部署后，您可以按照Adobe Commerce最佳实践手动配置涂漆。 请参阅配置和使用Varnish。<！—MAGECLOUD—2358—>

• 安全站点访问 — 为访问Adobe Commerce商店和管理面板添加了SSL支持。<！—MAGECLOUD—2360—>

改进了Adobe Commerce on cloud infrastructure扩展支持 — 将Adobe Commerce on cloud infrastructure composer.json文件中guzzlehttp/guzzle包的最低版本要求降级为6.2版，以便ece-tools包与更多扩展兼容。

在构建阶段将自定义更改应用于Adobe Commerce应用程序 — 我们将该构建阶段拆分为两个单独的进程，这样您就可以在打包应用程序以进行部署之前，使用挂接将自定义更改应用于生成的静态内容。 _build :generate_进程生成代码、应用修补程序并生成静态内容。 build:transfer​进程将生成的代码和静态内容传输到最终目标。 查看应用程序挂接.

环境配置检查 — 改进了环境配置的验证，以便在云基础架构上构建和部署Adobe Commerce之前警告客户出现版本不兼容和配置错误。

• 添加了特定于版本的验证，以标识不支持或弃用的环境变量和值。

• 添加了Elasticsearch兼容性检查，以就Elasticsearch配置问题向用户发出警告。 现在，如果服务器上的Elasticsearch服务版本与Adobe Commerce不兼容，则部署将失败。 以前，即使Elasticsearch版本不兼容，部署也会成功，这会导致在站点部署后出现产品目录问题。

  您可以通过提交支持票证解决不兼容问题，以将Elasticsearch升级到兼容版本，或更改Adobe Commerce配置以指定兼容版本的Elasticsearch PHP客户端。

  • 对于Adobe Commerce版本2.1.x到2.2.2，请将Elasticsearch升级到版本2.4。

  • 对于Adobe Commerce版本2.2.3及更高版本，请将Elasticsearch升级到版本5.2。

  • 如果您有Elasticsearch 1.x或2.x，并且不想升级，请将composer.json中的Adobe Commerce Elasticsearch PHP客户端版本要求更新为"elasticsearch/elasticsearch": "~2.0"。

• 改进了环境变量验证，以识别在生成、部署和部署后阶段可能会导致冲突的配置设置。 例如，如果静态内容部署的全局设置与生成或部署阶段的设置冲突，则在安装和升级过程中会显示警告消息。

环境变量更新 — 已更改以下环境变量：

• SKIP_HTML_MINIFICATION全局变量 — 将默认值更改为true以启用随选HTML内容缩小，这可以最大限度地减少部署到暂存和生产环境时的停机时间。 零停机部署需要此配置。

• CLEAN_STATIC_FILES部署变量 — 添加了基于CLEAN_STATIC_FILES环境变量设置来管理生成阶段生成的静态内容的清理静态文件处理的功能。 以前，始终清理在生成阶段生成的静态内容文件。

日志记录 — 进行了以下更改以改进日志消息并减少日志大小：

• 部署失败日志条目现在包括导致失败的操作的命令输出，即使您的环境配置未指定调试级别日志记录也是如此。 查看MIN_LOGGING_LEVEL.

• 添加了针对某些扩展所需的生成工厂无法正确生成时发生的部署失败的日志记录，因为文件系统处于只读状态。

• 减少了部署日志大小，并修复了使用交互式进度条的安装命令导致的格式问题。

• 消除了不必要的详细程度并更新了一些日志语句的优先级。

特定于Cron的修复—

• 已将历史记录生命周期的默认cron作业配置设置从3d （4320分钟）更改为1h （60分钟），以防止在cron队列填充过快时可能出现性能问题和部署失败。

• 改进了部署阶段的cron作业管理过程，以防止数据库锁定和其他严重问题。 现在，所有cron作业在部署阶段停止，并在部署完成后重新启动。

• 修复了Adobe Commerce 2.2.0及更高版本中cron作业为计划使用者而启动的锁定机制的问题，以防止cron作业启动重复的使用者。

修复了在部署过程中引用压缩文件时导致not overwritten和no such file or directory错误的静态内容压缩进程 (gzip)问题。

修复了在转储过程中，如果未指定存储区域设置，则php ./vendor/bin/ece-tools config:dump命令无法从config.php文件中删除冗余部分的问题。 现在，您可以轻松地在环境之间移动配置文件。 更新到ece-tools v2002.0.13后，使用改进的config:dump命令重新生成较旧的config.php文件。 查看商店设置的配置管理。

修复了在.magento/routes.yaml文件中的路由配置从apex域重定向到www域时导致部署阶段错误的问题。

修复了SEARCH_CONFIGURATION变量的_merge选项的问题，如果更新的.magento.env.yaml配置文件中未包含engine参数，该问题会导致合并结果不正确。 现在，合并操作仅正确覆盖您在更新的.magento.env.yaml中指定的值，而无需您设置engine参数。

修复了Redis配置问题，该问题导致在云基础架构版本2.2.1及更高版本上为Adobe Commerce错误地启用会话锁定，从而可能导致性能变慢和超时。 现在，默认情况下禁用会话锁定。 此问题是由于Redis会话处理程序包v1.3.4中引入的disable_locking参数的默认行为更改所致。 请参阅colimollenhour/php-redis-session-abstract包.

云的Docker撰写 — 添加了命令 — docker:build — 以从云ece-tools存储库生成Docker撰写配置。

更改区域设置 — 现在无需导出和导入配置过程即可更改存储区域设置。 当应用程序处于生产状态并启用SCD_ON_DEMAND时，存储和管理区域设置选项可用。

站点地图和Robots — 创建了工作流以添加robots.txt文件并为单个域配置生成sitemap.xml文件，而无需更改基础结构。

向导 — 添加了两个向导以帮助您进行云配置：

• ideal-state — 配置理想状态以将部署停机时间降至最低

• master-slave — 为数据库和Redis配置负载平衡

模块刷新 — 添加了Cloud命令 — module:refresh — 以启用已禁用或未显式启用的模块，类似于在生成期间自动启用的方式。

添加了使用CACHE、SESSION、QUEUE和SEARCH配置中的_merge选项为服务选择合并或覆盖配置的功能。

环境配置示例文件 — 我们已将一个.magento.env.yaml示例文件添加到ECE-Tools包中，其中包含每个环境变量的详细说明和可能值。

• 我们还为.magento.env.yaml配置添加了深层验证，以防止部署过程中因意外值而导致失败。 失败时，您现在会收到一条详细的错误消息，其开头为：Environment configuration is not valid. Please correct .magento.env.yaml file with next suggestions:

已添加以下​环境变量：

• 现在，您可以使用新的SCD_MATRIX环境变量为每个主题定义多个区域设置，这会减少要部署的主题文件数量。

• 添加了DATABASE_CONFIGURATION环境变量以自定义部署的数据库连接。

• 新的MIN_LOGGING_LEVEL变量覆盖所有输出流的最低日志记录级别，而不更改代码。

修复了导致部署和部署后阶段之间出现停机时间的问题。 现在，部署后阶段在部署阶段结束后​ 立即 ​开始。

修复了未从计划清除成功的cron作业（具有status = success的作业）的问题。

修复了在部署阶段而非项目的部署后阶段清除缓存的post_deploy挂接的问题。

修复了在使用具有多个区域设置的SCD时的问题，这会为每个区域设置生成相同的js-translation.json文件。

已优化ece-tools包中的db:dump命令，以避免锁定表并提高速度。

配置向导 — 添加了一个向导以帮助验证您的静态内容部署配置。 查看智能向导.

Symfony控制台支持 — 已添加对具有Adobe Commerce 2.3的Symfony控制台4的支持。

Cron计划优化 — 改进了队列管理并增强了日志记录以帮助调试cron相关问题。

如果ADMIN_EMAIL或ADMIN_USERNAME值与现有管理员帐户相同，则 部署验证失败。

删除了2.2.x版本的SOLR支持。 2.1.x版本保留启用SOLR.的功能

PRO项目的暂存和生产环境的首次安装现在包含Elasticsearch的不同索引前缀，以防止在识别属于每个环境的记录时可能发生冲突。

修复了在静态内容部署期间中断旧体系结构的生成阶段的问题。

特定于Cron的改进 — 已重新处理cron实施：

• 修复了导致cron队列快速填充的问题。 如今，它以更可靠的方式清理了过时的cron工作。

• 重新组织了cron作业序列，以便单独线程中的所有作业在常规组之前启动。

• 改进了日志记录，以更好地协助调试cron问题。

• 注意 — 此版本解决了许多与cron相关的问题。 如果您当前在​ m2修补程序 ​中使用一些与cron相关的修补程序，请删除它们。

特定于SCD的改进—

• 您可以在​ 生成 ​和de_ploy阶段期间使用VERBOSE_COMMANDS和SCD_COMPRESSION_LEVEL环境变量。

• 修复了在遇到SCD_COMPRESSION_LEVEL环境变量的意外值时导致部署失败并出现随机错误的问题。 改进了配置验证以提供有意义的通知。 有关可接受的值，请参阅SCD_COMPRESSION_LEVEL。

• 修复了SCD_COMPRESSION_LEVEL环境变量配置流的行为，以使覆盖按预期工作。

• 修复了导致无法在.magento.env.yaml文件​ 部署 ​阶段中配置SCD_THREADS环境变量的问题。

静态内容部署(SCD) — 有一个新的替代部署过程可在请求时生成静态内容（按需）。 这通过生成最关键的资产来减少停机时间并改进缓存处理。

• 新环境变量 — 已添加SCD_ON_DEMAND全局环境变量，以便在请求时生成静态内容。

• 部署后挂接 — 为.magento.app.yaml文件添加了post_deploy挂接，该挂接清除缓存并在​ 容器开始接受连接后 ​预载（加温）缓存。 它仅适用于在Cloud Console中包含暂存和生产环境的Pro项目以及入门项目。 尽管不是必需的，但是它与SCD_ON_DEMAND环境变量协同工作。

优化 — 已优化部署期间移动或复制文件以提高部署速度并降低文件系统的负载。

部署日志记录 — 添加了启用Syslog和Graylog扩展日志格式(GELF)处理程序以便在部署过程中输出日志的功能。 查看日志记录处理程序.

已添加以下​环境变量：

• CRYPT_KEY — 移动数据库时向另一个环境提供密钥。

• SKIP_HTML_MINIFICATION—Global​环境变量，该变量跳过复制var/view_preprocessed目录中的静态视图文件并在请求时生成缩小的HTML。

• SCD_ON_DEMAND—全局​环境变量，以便在请求时生成静态内容。

• WARM_UP_PAGES — 您可以列出要用于预加载缓存的页面。 在新的部署后变量中可用。

修复了本地应用的修补程序中断实例上的部署的问题。 现在，ECE-Tools可以检测到已应用了修补程序。

修复了JavaScript捆绑包与GZIP功能之间的冲突。 现在，这些功能可以正常配合使用。

修复了在使用早期PHP 7.0.x版本时导致ECE-Tools CLI命令失败的问题。

修复了阻止在多个线程中使用压缩策略的静态内容部署的问题。

修复了导致管理员登录延迟的Redis会话锁定问题。 此外，此修复程序还可用于2.1.x.

ece-tools— ece-tools包现在支持Adobe Commerce 2.1.x。

Redis配置 — 您现在可以使用环境变量配置Redis页面以及默认缓存和Redis会话存储。

搜索、AMQP和Redis服务改进 — 我们统一了服务配置流程，以便所有服务的行为现在都相同。 不再支持手动编辑env.php文件来配置服务。 您必须改用环境变量或.magento.env.yaml文件。

环境变量—

• env:STATIC_CONTENT_THREADS的使用已被弃用，将在未来版本中删除。 请改用SCD_THREADS。

• 已弃用STATIC_CONTENT_EXCLUDE_THEMES环境变量。 必须改用SCD_EXCLUDE_THEMES环境变量。

日志记录 — 我们简化了有关内置修补操作的日志记录。

我们删除了developer模式支持和APPLICATION_MODE环境变量，因为它们导致了意外行为。

我们修复了导致与Redis相关的静态内容部署失败的问题。 现在，多线程静态内容部署按设计运行。

我们修复了导致用户无法在管理员中保存对配置字段的修改的问题，在运行app:config:dump命令后，这些字段标记为敏感。

我们添加了对早期版本的symfony/yaml的支持以修复与某些包之间的冲突，这些包尚未与最新版本兼容。

已改进日志记录

• 我们改进了日志消息，以便在构建或部署过程覆盖环境变量时提供更好的解释。

• 您现在可以实时查看安装和升级进度。 跟踪install_update.log文件以查看进度。 例如，

  code language-bash
  tail -f var/log/install_upgrade.log

新cron命令 — 您现在可以解锁特定的cron卡作业，而不是使用cron:unlock命令停止并重新启动所有此类作业。 在2.1.中不可用

统一配置文件 — 您现在可以使用.magento.env.yaml文件配置生成和部署阶段。

备份配置文件 — 部署过程现在会在部署后自动创建app/etc/env.php和app/etc/config.php配置文件的备份。 我们还添加了新CLI命令以从备份中还原这些配置文件。

验证错误疑难解答 — 我们更改了当config.php不包含足够的数据以进行静态内容部署时，必须用来解决验证错误的命令。 以前，错误消息指示您运行bin/magento app:config:dump。 现在，您必须运行php ./vendor/bin/ece-tools config:dump.

新环境变量 — 您现在可以使用环境变量将自定义搜索和基于AMQP的服务连接到您的站点。

我们实施了智能修补。 现在，该包不基于Adobe Commerce在云基础架构版本上应用修补程序，而是基于修补的包版本应用修补程序。

我们修复了导致生成错误的日志记录问题。

我们修复了在交互模式下运行部署时导致超时异常的问题。

我们修复了在使用压缩策略生成静态内容时导致错误的问题。 在2.1.中不可用

我们修复了导致部署脚本无法正确识别暂存环境和生产环境的问题。

我们修复了在安装和升级过程中导致网络问题中断数据库连接和导致失败的问题。

我们修复了阻止您多次使用app:config:dump导出配置文件的问题。 在2.1.中不可用

我们修复了导致​ 管理员 ​登录延迟的Redis会话​ 锁定 ​问题。 在2.1.中不可用

我们修复了与版本控制相关的实施问题，该问题会导致与其他基于编辑器的修补模块发生冲突。

我们修复了在导入期间导致PHP内存问题的问题。

已删除修补程序；修复了colinmollenhour/credis v1.6中的错误，以便在云基础架构2.2.1上启用对Adobe Commerce的支持。 在2.1.中不可用

我们修复了在文件或目录名称包含空格时导致gzip错误的问题。

我们修复了阻止部署脚本正确识别和启用模块依赖项的问题。

使用环境变量配置cron使用者 — 您现在可以使用新的CRON_CONSUMERS_RUNNER环境变量配置cron使用者。

配置扫描 — 我们现在在构建/部署过程中扫描关键组件，如果扫描失败，则停止该过程，这样可以防止由于站点处于维护模式而造成的不必要的停机。

生成/部署通知 — 我们添加了一个配置文件，您可以使用它设置Slack和/或电子邮件通知，以便在所有环境中执行生成/部署操作。

静态内容压缩 — 我们现在在生成和部署阶段使用gzip压缩静态内容。 此压缩与Fastly压缩相结合，有助于减小存储的大小并提高部署速度。 如有必要，您可以使用生成选项或部署变量来禁用压缩。 有关更多信息，请参阅以下主题：

• 应用程序环境变量

• 静态内容部署性能

• 部署过程

配置管理 — 我们现在会在构建阶段在您的Git存储库中自动生成一个app/etc/config.php文件（如果尚不存在）。 自动生成的文件仅包含模块和扩展名的列表。 如果文件已存在，则构建阶段将继续正常进行。 如果稍后执行配置管理，则命令会更新文件，而无需其他步骤。 有关详细信息，请参阅部署进程。

数据库转储 — 我们添加了一个magento/ece-tools CLI命令，用于在所有环境中创建数据库转储。 对于Pro Plan生产环境，此命令仅从三个高可用性节点中的一个转储，因此转储期间写入其他节点的生产数据可能不会被复制。 我们建议先将应用程序置于维护模式，然后再在生产环境中执行数据库转储。 有关详细信息，请参阅备份管理。

已取消Cron间隔限制 — 在us-3、eu-3和ap-3区域中配置的所有环境的默认Cron间隔为1分钟。 对于专业集成环境，所有其他区域的默认cron间隔为5分钟；对于专业暂存和生产环境，默认间隔为1分钟。 要修改现有cron作业，请在.magento.app.yaml中编辑您的设置，或者为生产/暂存环境创建支持票证。 有关详细信息，请参阅设置cron作业。

我们修复了由于部署进程在静态内容部署之前调用cache-clean操作而导致部署时间较长的问题。

我们修复了在生产环境中部署的静态内容生成步骤期间导致错误的问题。

我们修复了某些magento/ece-tools命令无法将输出记录到stderr的问题。

我们修复了无法在分支中更新env.php中的基本URL值的问题。

我们修复了导致magento setup:install命令添加不安全的前缀(http://)来保护基本URL的问题。

我们修复了阻止修补程序错误导致部署失败的问题。

我们修复了导致ece-tools无法停止执行并在无法应用修补程序时引发异常的问题。

我们修复了在管理员中启用HTML缩小后加载店面时导致错误的问题。

云基础架构上的Adobe Commerce现在支持范围和静态内容部署策略。 我们为静态内容部署策略添加了默认设置为quick的–s参数。 您可以使用环境变量SCD_STRATEGY自定义这些策略，并将其用于生成和部署操作。 此变量支持选项standard、quick或compact。 如果您选择compact，我们将使用1覆盖STATIC_CONTENT_THREADS值，这可能会降低部署速度，尤其是在生产环境中。 在2.1.中不可用

我们在环境中创建了一个日志文件，用于捕获和编译生成和部署操作。 var/log/cloud.log文件位于根应用程序目录中。

已重构ece-tools包，使其与Adobe Commerce在云基础架构2.2.0及更高版本上兼容。

我们修复了导致ece-tools无法停止执行并在无法应用修补程序时引发异常的问题。

我们修复了在生成期间跳过依赖项注入(di)编译时导致引发异常的问题。

我们修复了导致部署过程覆盖env.php文件中的自定义Redis配置的问题。

我们修复了导致重定向循环的问题，该问题导致默认安全管理员禁用重定向循环。