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

のコピーを作成 config.local.php ファイルと名前 config.php.

このファイルをに追加します app/etc プロジェクトのフォルダー。

ブランチにファイルを追加してコミットします。

ファイルを統合ブランチにプッシュします。

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

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

統合ブランチを確認します。

を開きます composer.json ファイルをテキストエディターで開きます。

を確認します autoload:psr-4 コントローラの依存関係用の Zend プラグインマネージャーの実装に関する節。

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

を作成 データベース ダンプ. 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

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

git add -A

git commit -m "Upgrade"

git push origin <branch-name>

git add -A は、Composer マーシャリング ベース パッケージの方式により、変更されたすべてのファイルをソース コントロールに追加するために必要です。 両方 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 の場合、を実行するには scd-dump 日 integration ブランチ：

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

を転送 config.php を使用してローカル ワークステーションにファイルを送信する rsync または scp. このファイルはブランチに対してのみローカルに追加できます。

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>