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。

• 目录分页在Elasticsearch6.x上不起作用 — 修复了搜索结果分页的一个关键问题，该问题影响将Elasticsearch6.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-phoneticElasticsearch插件添加到所有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-cloud-service/user-guide/configure/app/properties/crons-property?lang=zh-Hans).的[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内部版本：

• Elasticsearch6.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

  • Elasticsearch1.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的问题。 以前，安装过程使用DATABASE_CLOUD_RELATIONSHIP变量中的数据库配置，即使您在DATABASE_CONFIGURATIONMAGENTO变量.中指定了自定义连接信息也是如此

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

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

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