向后不兼容的更改

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
云

创建对象：

管理员
开发人员

在升级到最新版本的ece-tools包或其他适用于Commerce包的Cloud Tools Suite时，向后不兼容的更改可能要求您调整现有Cloud项目的云配置和流程。

对`ece-tools`包的更改

以前包含在ece-tools包中的某些功能现在在单独的包中提供。这些包是ece-tools的编辑器依赖项，当您安装或更新ece-tools时，会自动安装和更新这些依赖项。

新架构不应影响您的安装或更新过程。但是，在使用Adobe Commerce进行云基础架构项目时，您可能需要更改某些命令语法和流程。有关详细信息，请查看以下向后不兼容的更改信息和Cloud Tools Suite发行说明。

服务版本要求更改

对于使用ece-tools v2002.1.0及更高版本的云项目，我们将PHP的最低版本要求从7.0.x更改为7.1.x。如果您的环境配置指定了PHP 7.0，请更新.magento.app.yaml文件中的php配置。

WARNING

由于PHP版本要求的更改，ece-tools 2002.1.0在运行Adobe Commerce 2.1.15或更高版本的云基础架构项目中仅支持Adobe Commerce。如果您的项目使用早期版本，则必须在更新到ece-tools 2002.1.0之前升级。

环境配置更改

下表提供了有关ece-tools v2002.1.0中已删除或弃用的环境变量和其他环境配置文件的信息。

项目

替换

SCD_EXCLUDE_THEMES变量

SCD_MATRIX

STATIC_CONTENT_THREADS变量

SCD_THREADS

DO_DEPLOY_STATIC_CONTENT变量

SKIP_SCD

STATIC_CONTENT_SYMLINK变量

无。现在，生成始终创建指向静态内容目录pub/static的符号链接。

build_options.ini文件

使用.magento.env.yaml文件配置环境变量，以管理所有环境中的生成和部署操作。

如果构建包含build_options.ini文件的云环境，则构建失败。

CLI命令更改

下表总结了ECE-Tools v2002.1.0中可能需要更新命令或脚本的CLI命令更改。

命令

替换

m2-ece-build

vendor/bin/ece-tools build

m2-ece-deploy

vendor/bin/ece-tools deploy

m2-ece-scd-dump

vendor/bin/ece-tools config:dump

vendor/bin/ece-tools patch

vendor/bin/ece-patches apply

vendor/bin/ece-tools docker:build

vendor/bin/ece-docker build:compose

vendor/bin/ece-tools docker:config:convert

vendor/bin/ece-docker image:generate:php

在早期的ECE-Tools版本中，您可以使用m2-ece-build和m2-ece-deploy命令在.magento.app.yaml文件中配置部署挂接。当您更新到v2002.1.0时，请检查.magento.app.yaml文件中的hooks配置以了解过时的命令，并根据需要替换它们。

云修补程序更改

删除已下载的修补程序- magento/magento-cloud-patches包捆绑了软件下载页面中的所有可用修补程序，并在您部署到云时自动应用这些修补程序。要防止升级到ECE-Tools 2002.1.0或更高版本后出现补丁程序冲突，请删除手动下载并添加到项目中的Adobe提供的任何补丁程序。

正在更新应用修补程序命令 — 我们将用于应用修补程序的命令从vendor/bin/ece-tools目录移动到vendor/bin/ece-patches目录。如果使用此命令手动应用修补程序，请使用新路径。

手动应用修补程序

code language-bash
`php ./vendor/bin/ece-patches apply`

Cloud Docker更改

PHP的最低版本要求现在是PHP 7.1 — 如果您的Cloud Docker for Commerce主机运行的是早期版本，请升级到PHP v7.1或更高版本。

适用于Commerce的Cloud Docker命令更改-

正在为Docker生成操作更新Commerce命令的Cloud Docker — 我们将Commerce命令的Cloud Docker从vendor/bin/ece-tools目录移动到vendor/bin/ece-docker目录。更新脚本和命令以使用新路径。

升级到ece-tools 2002.1.0后，使用以下命令查看可用的ece-docker命令。

code language-bash
`php ./vendor/bin/ece-docker list`

正在更新Cloud Docker-compose命令 — 我们已将命令文件的路径从./bin/docker重命名为./bin/magento-docker。更新脚本和命令以使用新路径。
Cron容器不再包含在默认Docker配置中 — 现在，您必须将--with-cron选项添加到ece-docker build:compose命令以在Docker环境配置中包含Cron容器。请参阅 Cloud Docker for Commerce 指南中的管理cron作业。

以前使用cron作业生成的容器现在不包含cron容器。
使用临时容器 — 在以前的版本中，未删除由bin/magento-docker命令操作创建的容器，因此您可以将它们用于其他操作。现在，magento-docker命令会移除在该命令完成后创建的所有容器。

如果要保留通过Docker撰写操作创建的容器，请使用docker-compose run命令而不是bin/magento-docker命令。

正在运行部署后挂接- cloud-deploy命令不再运行部署后挂接。使用新的cloud-post-deploy命令在部署后运行部署后挂接。更新脚本以添加命令以运行部署后挂接。

code language-shell
`bin/magento-docker ece-deploy bin/magento-docker ece-post-deploy`

或者，如果您直接使用docker-compose命令，请在部署命令之后运行docker-compose run deploy cloud-post-deploy命令。

正在刷新数据库 — 数据库容器现在存储在magento-db永久Docker卷中。刷新Docker环境时，不再自动删除数据库。如果需要，请使用以下命令之一手动删除它。

删除magento-db容器：

code language-bash
`docker volume rm magento-db`

关闭Docker容器时删除所有关联的卷：

code language-bash
`docker-compose down -v`

覆盖存档和备份文件的文件同步设置 — 使用docker-sync或mutagen时，具有以下扩展名的存档和备份文件不再同步：SQL、GZ、ZIP和BZ2。您可以通过重命名文件以其他扩展名结尾，来覆盖这些文件类型的默认文件同步。例如： synchronize-me.zip-backup

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26