升級 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.4

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

修改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 Systems 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 Systems 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才能將所有變更的檔案新增到原始檔控制中。 從基底封裝（magento/magento2-base和magento/magento2-ee-base）將composer install和composer update封送檔案合併到封裝根目錄中。

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>