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'

ファイルを保存します。 リモート環境に対する変更は、まだコミットまたはプッシュしないでください。

アップグレードプロセスを続行します。

config セクションに次の allow-plugins を追加します。

"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 を使用してリモート環境にログインします。

データベースダンプを作成します。 DB ダンプのターゲット・ディレクトリを選択するには、--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: 品質パッチのリリースノートで該当するバージョンを確認してください

方法 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>