ドキュメントCommerceアップグレードガイド

アップグレードの実行

Last update: Thu May 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Experienced
  • Admin
  • Developer

アップグレードできます オンプレミス コマンドラインからのAdobe Commerce アプリケーションのデプロイメント（以下を行ってソフトウェアをインストールした場合）

  • を使用した Composer メタパッケージのダウンロード composer create-project コマンド。
  • 圧縮されたアーカイブをインストールしています。
NOTE

以下の手順は、Composer パッケージ マネージャを使用してアップグレードする方法を示しています。 Adobe Commerce 2.4.2 では、Composer 2 のサポートが導入されました。 <2.4.1 からアップグレードする場合は、まず Composer 1 を使用して、Composer 2 と互換性のあるバージョン（2.4.2 など）にアップグレードする必要があります 次の前 2.4.2 以降のアップグレードの場合は、Composer 2 にアップグレードします。 また、を実行している必要があります サポート対象バージョン （PHP の場合）

WARNING
Adobe Commerceのアップグレード手順が変更されました。 新しいバージョンのをインストールする必要があります magento/composer-root-update-plugin パッケージ（ 前提条件）に設定します。 また、アップグレード用のコマンドはから変更されました。 composer require magento/<package_name> 対象： composer require-commerce magento/<package_name>.

始める前に

を完了する必要があります アップグレードの前提条件 アップグレード処理を開始する前に環境を準備します。

パッケージの管理

NOTE
様々なリリースレベルの指定に関するヘルプについては、このセクションの最後にある例を参照してください。 例えば、品質向上パッチやセキュリティパッチなどです。 Composer でこれらのパッケージが見つからない場合は、Adobe Commerce サポートにお問い合わせください。

  1. メンテナンスモードに切り替えて、アップグレードプロセス中にストアにアクセスできないようにします。

    code language-bash 
    bin/magento maintenance:enable

    参照： メンテナンスモードの有効化または無効化 （その他のオプション）。 オプションで、 カスタムメンテナンスモードページ.

  2. メッセージキューコンシューマーなどの非同期プロセスの実行中にアップグレードプロセスを開始すると、データが破損する可能性があります。 データの破損を防ぐには、すべての cron ジョブを無効にします。

    クラウドインフラストラクチャー上のAdobe Commerce:

    code language-bash 
    ./vendor/bin/ece-tools cron:disable

    Magento Open Source:

    code language-bash 
    bin/magento cron:remove

  3. すべてのメッセージキューコンシューマーを手動で開始して、すべてのメッセージが消費されるようにします。

    code language-bash 
    bin/magento cron:run --group=consumers

    cron ジョブが完了するのを待ちます。 ジョブのステータスは、プロセスビューアで監視できます。また、 ps aux | grep 'bin/magento queue' すべてのプロセスが完了するまで、コマンドを複数回実行します。

  4. のバックアップを作成 composer.json ファイル。

    code language-bash 
    cp composer.json composer.json.bak

  5. 必要に応じて、特定のパッケージを追加または削除します。

    例えば、Magento Open SourceからAdobe Commerceにアップグレードする場合は、Magento Open Sourceパッケージを削除します。

    code language-bash 
    composer remove magento/product-community-edition --no-update

    サンプルデータをアップグレードすることもできます。

    code language-bash 
    composer require <sample data module-1>:<version> ... <sample data module-n>:<version> --no-update

    • Adobe Commerce:

      code language-bash 
      composer require magento/module-bundle-sample-data:100.4.* magento/module-widget-sample-data:100.4.* magento/module-theme-sample-data:100.4.* magento/module-catalog-sample-data:100.4.* magento/module-customer-sample-data:100.4.* magento/module-cms-sample-data:100.4.*  magento/module-catalog-rule-sample-data:100.4.* magento/module-sales-rule-sample-data:100.4.* magento/module-review-sample-data:100.4.* magento/module-tax-sample-data:100.4.* magento/module-sales-sample-data:100.4.* magento/module-grouped-product-sample-data:100.4.* magento/module-downloadable-sample-data:100.4.* magento/module-msrp-sample-data:100.4.* magento/module-configurable-sample-data:100.4.* magento/module-product-links-sample-data:100.4.* magento/module-wishlist-sample-data:100.4.* magento/module-swatches-sample-data:100.4.* magento/sample-data-media:100.4.* magento/module-offline-shipping-sample-data:100.4.* magento/module-gift-card-sample-data:100.4.* magento/module-customer-balance-sample-data:100.4.* magento/module-target-rule-sample-data:100.4.* magento/module-gift-registry-sample-data:100.4.* magento/module-multiple-wishlist-sample-data:100.4.* --no-update

    • Magento Open Source:

      code language-bash 
      composer require magento/module-bundle-sample-data:100.4.* magento/module-widget-sample-data:100.4.* magento/module-theme-sample-data:100.4.* magento/module-catalog-sample-data:100.4.* magento/module-customer-sample-data:100.4.* magento/module-cms-sample-data:100.4.*  magento/module-catalog-rule-sample-data:100.4.* magento/module-sales-rule-sample-data:100.4.* magento/module-review-sample-data:100.4.* magento/module-tax-sample-data:100.4.* magento/module-sales-sample-data:100.4.* magento/module-grouped-product-sample-data:100.4.* magento/module-downloadable-sample-data:100.4.* magento/module-msrp-sample-data:100.4.* magento/module-configurable-sample-data:100.4.* magento/module-product-links-sample-data:100.4.* magento/module-wishlist-sample-data:100.4.* magento/module-swatches-sample-data:100.4.* magento/sample-data-media:100.4.* magento/module-offline-shipping-sample-data:100.4.* --no-update

  6. 次を使用してインスタンスをアップグレードします composer require-commerce コマンド構文：

    code language-bash 
    composer require-commerce magento/<product> <version> --no-update [--interactive-root-conflicts] [--force-root-updates] [--help]

    次のようなコマンドオプションがあります。

    • <product> – （必須）アップグレードするパッケージ。 オンプレミスのインストールの場合、この値はである必要があります product-community-edition または product-enterprise-edition.

    • <version> – （必須）アップグレード先のAdobe Commerceのバージョン。 例： 2.4.3.

    • --no-update – （必須）依存関係の自動更新を無効にします。

    • --interactive-root-conflicts – （オプション）以前のバージョンの古い値や、アップグレード先のバージョンと一致しないカスタマイズされた値を、インタラクティブに表示および更新できます。

    • --force-root-updates – （オプション）競合するカスタム値をすべて、期待されるCommerce値で上書きします。

    • --help – （任意）プラグインの使用方法の詳細を提供します。

    どちらでもない場合 --interactive-root-conflicts nor --force-root-updates を指定すると、コマンドは競合する既存の値を保持し、警告メッセージを表示します。 このプラグインの詳細については、 プラグイン使用状況の README.

  7. 依存関係を更新します。

    code language-bash 
    composer update

例 – 使用可能なバージョンのリスト

使用可能な 2.4.x バージョンの完全なリストを表示するには：

Magento Open Source:

composer show magento/product-community-edition 2.4.* --available | grep -m 1 versions

Adobe Commerce:

composer show magento/product-enterprise-edition 2.4.* --available | grep -m 1 versions

例 – 品質パッチ

品質向上パッチには、主に機能性パッチが含まれています および セキュリティの修正。 ただし、下位互換性のある新しい機能が含まれることもあります。 Composer を使用して品質パッチをダウンロードします。

Adobe Commerce:

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

Magento Open Source:

composer require-commerce magento/product-community-edition 2.4.6 --no-update

例 – セキュリティパッチ

セキュリティパッチには、セキュリティ修正のみが含まれています。 これらは、アップグレードプロセスをより速く、より簡単にするように設計されています。 セキュリティパッチでは、Composer 命名規則を使用します 2.4.x-px.

Adobe Commerce:

composer require-commerce magento/product-enterprise-edition 2.4.6-p3 --no-update

Magento Open Source:

composer require-commerce magento/product-community-edition 2.4.6-p3 --no-update

メタデータを更新

  1. を更新 "name", "version"、および "description" のフィールド composer.json 必要に応じて、ファイルを作成します。

    note note
    NOTE
    でのメタデータの更新 composer.json ファイルは完全に表面的であり、機能していません。

  2. 更新を適用します。

    code language-bash 
    composer update

  3. をクリア var/ および generated/ サブディレクトリ：

    code language-bash 
    rm -rf var/cache/*
    code language-bash 
    rm -rf var/page_cache/*
    code language-bash 
    rm -rf generated/code/*
    note note
    NOTE
    Redis や Memcached など、ファイルシステム以外のキャッシュストレージを使用する場合は、手動でキャッシュをクリアする必要があります。

  4. データベーススキーマとデータを更新します。

    code language-bash 
    bin/magento setup:upgrade

  5. メンテナンスモードを無効にします。

    code language-bash 
    bin/magento maintenance:disable

  6. （オプション） ワニスを再起動します。

    ページのキャッシュに Varnish を使用する場合は、再起動します。

    code language-bash 
    service varnish restart

作業内容を確認する

アップグレードが成功したかどうかを確認するには、web ブラウザーでストアフロント URL を開きます。 アップグレードに失敗した場合、ストアフロントが正しく読み込まれません。

アプリケーションがで失敗した場合 We're sorry, an error has occurred while generating this email. エラー：

  1. Reset ファイルシステムの所有権と権限 as a のユーザー root 権限。

  2. 次のディレクトリをクリアします。

    • var/cache/
    • var/page_cache/
    • generated/code/

  3. Web ブラウザーでストアフロントを再度確認します。

recommendation-more-help
83a60e0e-8849-4685-a8cd-c129ecd795ea