升级Commerce版本

创建config.local.php文件的副本并将其命名为config.php。

将此文件添加到您项目的app/etc文件夹中。

将文件添加并提交到分支。

将文件推送到集成分支。

继续升级过程。

在本地工作站上，转到您的项目目录。

请查看您的集成分支。

在文本编辑器中打开composer.json文件。

检查Zend插件管理器实施的autoload:psr-4部分以了解控制器依赖关系。

 "autoload": {
    "psr-4": {
       "Magento\\Framework\\": "lib/internal/Magento/Framework/",
       "Magento\\Setup\\": "setup/src/Magento/Setup/",
       "Magento\\": "app/code/Magento/",
       "Zend\\Mvc\\Controller\\": "setup/src/Zend/Mvc/Controller/"
    },
}

如果缺少Zend依赖项，请更新composer.json文件：

• 将以下行添加到autoload:psr-4部分。

  code language-json
  "Zend\\Mvc\\Controller\\": "setup/src/Zend/Mvc/Controller/"

• 更新项目依赖关系。

  code language-bash
  composer update

• 添加、提交和推送代码更改。

  code language-bash
  git add -A

  code language-bash
  git commit -m "Add Zend plugin manager implementation for controllers dependency for Laminas support"

  code language-bash
  git push origin <branch-name>

• 先将更改合并到暂存环境，然后再合并到生产环境。

在本地工作站上，转到您的项目目录。

打开并编辑magento.app.yaml文件。

更新PHP选项。

type: php:8.3

build:
    flavor: none
dependencies:
    php:
        composer/composer: '2.7.2'

修改hooks属性build和deploy命令

hooks:
    # We run build hooks before your application has been packaged.
    build: |
        set -e
        composer install
        php ./vendor/bin/ece-tools run scenario/build/generate.xml
        php ./vendor/bin/ece-tools run scenario/build/transfer.xml
    # We run deploy hook after your application has been deployed and started.
    deploy: |
        php ./vendor/bin/ece-tools run scenario/deploy.xml
    # We run post deploy hook to clean and warm the cache. Available with ECE-Tools 2002.0.10.
    post_deploy: |
        php ./vendor/bin/ece-tools run scenario/post-deploy.xml

在文件末尾添加以下环境变量。

对于Adobe Commerce 2.2.x到2.3.x-

variables:
    env:
        CONFIG__DEFAULT__PAYPAL_ONBOARDING__MIDDLEMAN_DOMAIN: 'payment-broker.magento.com'
        CONFIG__STORES__DEFAULT__PAYMENT__BRAINTREE__CHANNEL: 'Magento_Enterprise_Cloud_BT'
        CONFIG__STORES__DEFAULT__PAYPAL__NOTATION_CODE: 'Magento_Enterprise_Cloud'

对于Adobe Commerce 2.4.x-

variables:
    env:
        CONFIG__DEFAULT__PAYPAL_ONBOARDING__MIDDLEMAN_DOMAIN: 'payment-broker.magento.com'
        CONFIG__STORES__DEFAULT__PAYPAL__NOTATION_CODE: 'Magento_Enterprise_Cloud'

保存文件。 不要将更改提交或推送到远程环境。

继续升级过程。

将以下allow-plugins添加到config部分：

"config": {
   "allow-plugins": {
      "dealerdirect/phpcodesniffer-composer-installer": true,
      "laminas/laminas-dependency-plugin": true,
      "magento/*": true
   }
},

将以下插件添加到require部分：

"require": {
    "magento/composer-root-update-plugin": "^2.0.3"
},

将以下组件添加到extra:component_paths部分：

"extra": {
   "component_paths": {
      "tinymce/tinymce": "lib/web/tiny_mce_5"
   },
},

保存文件。 尚未提交更改或将更改推送到分支。

继续升级过程。

创建远程数据库的本地备份。

magento-cloud db:dump

备份代码和介质。

php bin/magento setup:backup --code [--media]

或者，如果您有大量静态文件已在源代码管理中，则可以省略[--media]。

使用SSH登录到远程环境。

创建数据库转储。 要为数据库转储选择目标目录，请使用--dump-directory选项。

vendor/bin/ece-tools db-dump

转储操作将在远程项目目录中创建dump-<timestamp>.sql.gz存档文件。 请参阅备份数据库。

在本地工作站上，转到您的项目目录。

使用版本约束语法设置升级版本。

composer require "magento/magento-cloud-metapackage":">=CURRENT_VERSION <NEXT_VERSION" --no-update

更新项目。

composer update

查看当前应用的修补程序：

• 如果m2-hotfixes目录中安装了任何修补程序，请提交Adobe Commerce支持票证，并与Adobe Commerce支持部门合作，验证哪些修补程序仍可以应用于新版本。 从m2-hotfixes目录中删除不适用的修补程序。

• 如果.magento.env.yaml文件中应用了任何[质量修补程序]，请验证它们是否仍可应用于新版本。 从.magento.env.yaml文件的QUALITY_PATCHES部分删除不适用的修补程序。

方法1： 验证Quality Patches发行说明中的适用版本

方法2： 查看可用的修补程序和状态

方法3： 搜索修补程序

添加、提交和推送代码更改。

git add -A

git commit -m "Upgrade"

git push origin <branch-name>

由于Composer封送基础包的方式，将所有更改的文件添加到源代码管理时需要git add -A。 composer install和composer update将基包（magento/magento2-base和magento/magento2-ee-base）中的文件封送到包根中。

Composer封送的文件属于新版本的Adobe Commerce，用于覆盖这些相同文件的过时版本。 目前，Adobe Commerce中已禁用封送处理，因此您必须将封送处理文件添加到源代码管理。

等待部署完成。

通过使用SSH登录并检查版本，在集成、暂存或生产环境中验证升级。

php bin/magento --version

从终端，使用SSH命令为环境生成/app/etc/config.php文件。

ssh <SSH-URL> "<Command>"

例如，对于Pro，要在integration分支上运行scd-dump，请执行以下操作：

ssh <project-id-integration>@ssh.us.magentosite.cloud "php vendor/bin/ece-tools config:dump"

使用rsync或scp将config.php文件传输到本地工作站。 您只能将此文件添加到本地分支中。

rsync <SSH-URL>:app/etc/config.php ./app/etc/config.php

添加、提交和推送代码更改。

git add app/etc/config.php && git commit -m "Add system-specific configuration" && git push origin master

这将生成一个包含模块列表和配置设置的更新/app/etc/config.php文件。

在本地工作站上创建分支。

根据需要禁用扩展。

可用时，下载扩展升级。

按照第三方文档的说明安装升级。

启用并测试扩展。

添加、提交代码更改并将其推送到远程。

推送到并在您的集成环境中测试。

推送到暂存环境以在预生产环境中测试。

在本地工作站上，转到您的项目目录。

使用SSH登录到远程环境。

magento-cloud ssh

打开./app/var/report/<error number>文件。

检查日志并确定问题的来源。

添加、提交和推送代码更改。

git add -A && git commit -m "Fixed deployment failure" && git push origin <branch-name>