Commerceのバージョンのアップグレード

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

​ データベースダンプ ​ を作成します。 DB ダンプのターゲット・ディレクトリを選択するには、--dump-directory オプションを使用します。

vendor/bin/ece-tools db-dump

ダンプ操作では、リモート・プロジェクト・ディレクトリに dump-<timestamp>.sql.gz アーカイブ・ファイルが作成されます。 ​ データベースのバックアップ ​ を参照してください。

ローカルワークステーションで、をプロジェクトディレクトリに変更します。

ターゲットのアップグレード バージョンに対して ​ バージョン制約 ​ を設定します。 この手順は、ターゲットバージョンが既存の制約の範囲外にある場合にのみ必要です。

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

コアのCommerce アップグレードバージョンで composer.json ファイルを更新します。

composer require-commerce magento/product-enterprise-edition 2.4.8 --no-update

B2B を使用している場合は、Commerceの composer.json サポートされているバージョン ​ で ​ ファイルをアップデートします。

composer require-commerce magento/extension-b2b 1.5.2 --no-update

プロジェクトの依存関係を更新します。

composer update

現在適用されているパッチを確認します。

• m2-hotfixes ディレクトリにパッチがインストールされている場合は、Adobe Commerce サポートチケットを送信 ​ し、Adobe Commerce サポートに連絡して、新しいバージョンに適用可能なパッチを確認します。 該当しないパッチを m2-hotfixes ディレクトリから削除します。

• [ ファイルに ] 品質向上パッチ .magento.env.yaml が適用されている場合は、そのパッチを新しいバージョンにも適用できるかどうかを確認します。 QUALITY_PATCHES ファイルの .magento.env.yaml セクションから、適用できないパッチを削除します。

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

magento-cloud ssh

./app/var/report/<error number> ファイルを開きます。

​ ログを調べて ​ 問題の原因を特定します。

コードの変更を追加、コミットおよびプッシュします。

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