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

アップグレードの前提条件の完了

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 経験者
  • 管理者
  • 開発者

Adobe Commerceの実行に必要な事項を理解することが重要です。 最初に、アップグレード先のバージョンの 必要システム構成を確認する必要があります。

システム要件を確認した後、システムをアップグレードする前に次の前提条件を満たす必要があります。

  • すべてのソフトウェアを更新する
  • サポートされている検索エンジンがインストールされていることを確認します
  • データベース テーブル形式を変換
  • 開いているファイルの上限を設定
  • Cron ジョブが実行中であることを確認
  • DATA_CONVERTER_BATCH_SIZE を設定
  • ファイルシステムの権限の確認
  • pub/ ディレクトリルートの設定
  • Composer アップデート プラグインのインストール

すべてのソフトウェアを更新する

システム要件には、Adobe Commerce リリースでテストされているサードパーティソフトウェアのバージョンが正確に記載されています。

環境内のすべてのシステム要件と依存関係を更新していることを確認してください。 PHP 7.4、PHP 8.0、PHP 8.1、および 必要な PHP 設定を参照してください。

NOTE
Cloud infrastructure Pro プロジェクトのAdobe Commerceの場合、ステージング環境と実稼動環境でサービスをインストールまたは更新するための サポートチケットを作成する必要があります。 必要なサービスの変更を示し、更新した .magento.app.yaml ファイルと services.yaml ファイル、および PHP バージョンをチケットに含めます。 クラウドインフラストラクチャチームがプロジェクトを更新するまで、最大 48 時間かかる場合があります。 サポートされるソフトウェアとサービスを参照してください。

サポートされている検索エンジンがインストールされていることを確認します

Adobe Commerceを使用するには、Elasticsearchまたは OpenSearch をインストールする必要があります。

2.3.x から 2.4 にアップグレードする場合、2.3.x インスタンスのカタログ検索エンジンとして、MySQL、Elasticsearch、サードパーティの拡張機能のいずれかを使用しているかどうかを確認する必要があります。 結果によって、2.4 にアップグレードする 前に 実行する必要がある作業が決まります。

2.3.x または 2.4.x のリリース行内でパッチリリースをアップグレードしている場合、Elasticsearch 7.x が既にインストールされている場合は、オプションで OpenSearch に移行できます。

コマンドラインまたは管理者を使用して、カタログ検索エンジンを決定できます。

  • bin/magento config:show catalog/search/engine コマンドを入力します。 このコマンドは、mysql、elasticsearch （Elasticsearch 2 が構成されていることを示す）、elasticsearch5、elasticsearch6、elasticsearch7 の値、またはサードパーティの検索エンジンがインストールされていることを示すカスタム値を返します。 2.4.6 より前のバージョンの場合は、Elasticsearch 7 または OpenSearch エンジンの elasticsearch7 値を使用します。 バージョン 2.4.6 以降では、OpenSearch エンジンに opensearch の値を使用します。

  • 管理者で、Stores / Settings / Configuration / Catalog / Catalog / Catalog Search / Search Engine フィールドの値を確認します。

以下の節では、2.4.0 にアップグレードする前に実行する必要があるアクションについて説明します。

MySQL

2.4 以降、MySQL はサポートされるカタログ検索エンジンではなくなりました。 アップグレードする前に、Elasticsearchまたは OpenSearch をインストールして構成する必要があります。 このプロセスのガイドとして役立つ次のリソースを使用します。

一部のサードパーティのカタログ検索エンジンは、Adobe Commerce検索エンジンの上で実行されます。 拡張機能を更新する必要があるかどうかを判断するには、ベンダーにお問い合わせください。

MariaDB

MariaDB 10.4 および 10.6 でのインデックス再作成は、以前のバージョンの MariaDB または MySQL と比較して時間がかかります。 インデックス再作成を高速化するには、次の MariaDB 設定パラメーターを設定することをお勧めします。

MariaDB 10.6 にアップグレードした後、インデックス作成に関係なくパフォーマンスが低下する場合は、--query-cache-type 設定を有効にすることを検討してください。 例：--query-cache-type=ON。

クラウドインフラストラクチャプロジェクトでAdobe Commerceをアップグレードする前に、MariaDB をアップグレードする必要がある場合もあります（MariaDB のアップグレードのベストプラクティスを参照）。

例：

  • Adobe Commerce 2.4.6 （MariaDB バージョン 10.5.1 以降）
  • Adobe Commerce 2.3.5 と MariaDB バージョン 10.3 以前

これらの推奨事項に加えて、次のパラメータの設定についてはデータベース管理者に問い合わせてください。

NOTE
これらの設定は、オンプレミスのデプロイメントでのみ使用できます。 クラウドインフラストラクチャー上のAdobe Commerceのユーザーは、これらの設定にアクセスできません。

検索エンジン

2.4.0 にアップグレードする前に、Elasticsearch 7.6 以降または OpenSearch 1.2 をインストールして設定する必要があります。Adobeは、Elasticsearch 2.x、5.x および 6.x をサポートしなくなりました。設定ガイド の 検索エンジンの設定では、Elasticsearchをサポートされているバージョンにアップグレードした後に実行する必要があるタスクについて説明しています。

データのバックアップ、潜在的な移行の問題の検出、実稼動環境にデプロイする前のアップグレードのテストに関する手順について詳しくは、Elasticsearchのアップグレードを参照してください。 現在のElasticsearchのバージョンに応じて、クラスターの完全な再起動は必要な場合と不要な場合があります。

Elasticsearchには、Java Development Kit （JDK） 1.8 以降が必要です。 インストールされている JDK のバージョンを確認するには、Java Software Development Kit （JDK）をインストールするを参照してください。

OpenSearch

OpenSearch は、Elasticsearchのライセンスの変更に伴い、Elasticsearch 7.10.2 のオープンソースのフォークになりました。 Adobe Commerceの次のリリースでは、OpenSearch のサポートが導入されています。

  • 2.4.6 （OpenSearch には別のモジュールと設定があります）
  • 2.4.5
  • 2.4.4
  • 2.4.3-p2
  • 2.3.7-p3

Elasticsearchから OpenSearch への移行は、上記（またはそれ以降）のAdobe Commerceのバージョンにアップグレードする場合にのみ実行できます。

OpenSearch には JDK 1.8 以降が必要です。 インストールされている JDK のバージョンを確認するには、Java Software Development Kit （JDK）をインストールするを参照してください。

検索エンジン設定では、検索エンジンを変更した後に実行する必要があるタスクについて説明します。

アップグレードElasticsearch

Elasticsearch 8.x のサポートは、Adobe Commerce 2.4.6 で導入されました。以下の手順は、Elasticsearchを 7.x から 8.x にアップグレードする例を示しています。

  1. Elasticsearch 7.x サーバを 8.x にアップグレードし、が稼働していることを確認します。 Elasticsearchドキュメントを参照してください。

  2. elasticsearch.yml ファイルに次の設定を追加し、Elasticsearch 8.x サービスを再起動して、「id_field_data」フィールドを有効にします。

    code language-yaml 
    indices:
  id_field_data:
    enabled: true
    note info
    INFO
    Elasticsearch 8.x をサポートするために、Adobe Commerce 2.4.6 では indices.id_field_data プロパティがデフォルトで許可されず、docvalue_fields プロパティの _id フィールドが使用されます。

  3. Adobe Commerce プロジェクトのルート ディレクトリで、Composer の依存関係を更新して Magento_Elasticsearch7 モジュールを削除し、Magento_Elasticsearch8 モジュールをインストールします。

    code language-bash 
    composer require magento/module-elasticsearch-8 --update-with-all-dependencies

  4. プロジェクトコンポーネントを更新します。

    code language-bash 
    bin/magento setup:upgrade

  5. Admin で Elasticsearchを設定します。

  6. カタログインデックスを再インデックス化します。

    code language-bash 
    bin/magento indexer:reindex catalogsearch_fulltext

  7. 有効なキャッシュタイプからすべての項目を削除します。

    code language-bash 
    bin/magento cache:clean

ダウングレードElasticsearch

誤ってサーバー上のElasticsearchのバージョンをアップグレードした場合や、他の理由でダウングレードが必要と判断した場合は、Adobe Commerce プロジェクトの依存関係も更新する必要があります。 例えば、Elasticsearch 8.x から 7.x にダウングレードするには、次のようにします

  1. Elasticsearch 8.x サーバを 7.x にダウングレードし、が稼働していることを確認します。 Elasticsearchドキュメントを参照してください。

  2. Adobe Commerce プロジェクトのルート ディレクトリで、Composer 依存関係を更新して Magento_Elasticsearch8 モジュールとその Composer 依存関係を削除し、Magento_Elasticsearch7 モジュールをインストールします。

    code language-bash 
    composer remove magento/module-elasticsearch-8

  3. プロジェクトコンポーネントを更新します。

    code language-bash 
    bin/magento setup:upgrade

  4. Admin で Elasticsearchを設定します。

  5. カタログインデックスを再インデックス化します。

    code language-bash 
    bin/magento indexer:reindex catalogsearch_fulltext

  6. 有効なキャッシュタイプからすべての項目を削除します。

    code language-bash 
    bin/magento cache:clean

サードパーティの拡張機能

使用している拡張機能がAdobe Commerce リリースと完全に互換性があるかどうかを確認するには、検索エンジンのベンダーにお問い合わせください。

データベース テーブル形式を変換

すべてのデータベース テーブルの形式を COMPACT から DYNAMIC に変換する必要があります。 また、ストレージエンジンのタイプを MyISAM から InnoDB に変換する必要があります。 ベストプラクティスを参照してください。

開いているファイルの上限を設定

開いているファイル数の制限（ulimit）を設定すると、長いクエリ文字列を何度も繰り返し呼び出したり、bin/magento setup:rollback コマンドを使用する際の問題によって発生する障害を回避できます。 このコマンドは、UNIX シェルごとに異なります。 ulimit コマンドの詳細については、個々のフレーバーを参照してください。

Adobeは、開いているファイル ulimit を 65536 以上の値に設定することをお勧めしますが、必要に応じて大きな値を使用できます。 ulimit は、コマンドラインで設定することも、ユーザーのシェルの恒久的な設定にすることもできます。

コマンドラインから ulimit を設定するには：

  1. ファイルシステム所有者に切り替えます。

  2. ulimit を 65536 に設定します。

    code language-bash 
    ulimit -n 65536

Bash シェルに値を設定するには：

  1. ファイルシステム所有者に切り替えます。

  2. /home/<username>/.bashrc をテキストエディターで開きます。

  3. 次の行を追加します。

    code language-bash 
    ulimit -n 65536

  4. 変更内容を .bashrc ファイルに保存し、テキストエディターを終了します。

IMPORTANT
php.ini ファイルの pcre.recursion_limit プロパティの値は設定しないことをお勧めします。設定すると、エラー通知のない不完全なロールバックが生じる可能性があるからです。

Cron ジョブが実行中であることを確認

UNIX タスクスケジューラー cron は、Adobe Commerceの日々の操作にとって重要です。 インデックス再作成、ニュースレター、メール、サイトマップなどのスケジュールを設定します。 いくつかの機能では、ファイルシステムの所有者として少なくとも 1 つの cron ジョブを実行する必要があります。

cron ジョブが正しく設定されていることを確認するには、ファイルシステムの所有者として次のコマンドを入力して crontab を確認します。

NOTE
crontab は、cron ジョブの実行を担当する設定ファイルです。
crontab -l

次のような結果が表示されます。

#~ MAGENTO START c5f9e5ed71cceaabc4d4fd9b3e827a2b
* * * * * /usr/bin/php /var/www/html/magento2/bin/magento cron:run 2>&1 | grep -v "Ran jobs by schedule" >> /var/www/html/magento2/var/log/magento.cron.log
#~ MAGENTO END c5f9e5ed71cceaabc4d4fd9b3e827a2b

Cron が実行されていないもう 1 つの症状は、Admin で次のエラーが発生することです。

このエラーを確認するには、次のように、ウィンドウの上部にある システムメッセージ をクリックします。

詳しくは、cron の設定と実行を参照してください。

Set DATA_CONVERTER_BATCH_SIZE

Adobe Commerce 2.4 には、一部のデータをシリアル化されたから JSON に変換する必要があるセキュリティ強化が含まれています。 この変換はアップグレード中に行われ、データベースに含まれるデータの量によっては、長い時間がかかる場合があります。

最も影響を受けるのは、次の表です。

  • catalogrule
  • core_config_data
  • magento_reward_history
  • quote_payment
  • quote
  • sales_order_payment
  • sales_order
  • salesrule
  • url_rewrite

データが大量にある場合は、環境変数 DATA_CONVERTER_BATCH_SIZE の値を設定することでパフォーマンスを向上できます。 デフォルトでは、値は 50,000 に設定されています。

環境変数を設定するには：

  1. ファイルシステム所有者に切り替えます。

  2. 次の変数を設定します。

    code language-bash 
    export DATA_CONVERTER_BATCH_SIZE=100000
    note note
    NOTE
    DATA_CONVERTER_BATCH_SIZE にはメモリが必要です。最初にテストせずに、大きな値（約 1 GB）に設定しないでください。

  3. アップグレードが完了したら、この変数の設定を解除できます。

    code language-bash 
    unset DATA_CONVERTER_BATCH_SIZE

ファイルシステムの権限の確認

セキュリティ上の理由から、Adobe Commerceにはファイルシステムに対する特定の権限が必要です。 権限は 所有権 とは異なります。 所有権によってファイルシステムに対してアクションを実行できるユーザーが決まり、権限によってユーザーが実行できる操作が決まります。

ファイルシステム内のディレクトリは、 ファイルシステム所有者グループによって書き込み可能でなければなりません。

ファイルシステムの権限が正しく設定されていることを確認するには、アプリケーションサーバーにログインするか、ホスティングプロバイダーの file manager アプリケーションを使用します。

例えば、アプリケーションが /var/www/html/magento2 にインストールされている場合は、次のコマンドを入力します。

ls -l /var/www/html/magento2

サンプル出力：

total 1028
drwxrwx---. 12 magento_user apache   4096 Jun  7 07:55 .
drwxr-xr-x.  3 root         root     4096 May 11 14:29 ..
drwxrwx---.  4 magento_user apache   4096 Jun  7 07:53 app
drwxrwx---.  2 magento_user apache   4096 Jun  7 07:53 bin
-rw-rw----.  1 magento_user apache 439792 Apr 27 21:23 CHANGELOG.md
-rw-rw----.  1 magento_user apache   3422 Apr 27 21:23 composer.json
-rw-rw----.  1 magento_user apache 425214 Apr 27 21:27 composer.lock
-rw-rw----.  1 magento_user apache   3425 Apr 27 21:23 CONTRIBUTING.md
-rw-rw----.  1 magento_user apache  10011 Apr 27 21:23 CONTRIBUTOR_LICENSE_AGREEMENT.html
-rw-rw----.  1 magento_user apache    631 Apr 27 21:23 COPYING.txt
drwxrwx---.  4 magento_user apache   4096 Jun  7 07:53 dev
-rw-rw----.  1 magento_user apache   2926 Apr 27 21:23 Gruntfile.js
-rw-rw----.  1 magento_user apache   7592 Apr 27 21:23 .htaccess
-rw-rw----.  1 magento_user apache   6419 Apr 27 21:23 .htaccess.sample
drwxrwx---.  4 magento_user apache   4096 Jun  7 07:53 lib
-rw-rw----.  1 magento_user apache  10376 Apr 27 21:23 LICENSE_AFL.txt
-rw-rw----.  1 magento_user apache  30634 Apr 27 21:23 LICENSE_EE.txt
-rw-rw----.  1 magento_user apache  10364 Apr 27 21:23 LICENSE.txt
-rw-rw----.  1 magento_user apache   4108 Apr 27 21:23 nginx.conf.sample
-rw-rw----.  1 magento_user apache   1427 Apr 27 21:23 package.json
-rw-rw----.  1 magento_user apache   1659 Apr 27 21:23 .php_cs
-rw-rw----.  1 magento_user apache    804 Apr 27 21:23 php.ini.sample
drwxrwx---.  2 magento_user apache   4096 Jun  7 07:53 phpserver
drwxrwx---.  6 magento_user apache   4096 Jun  7 07:53 pub
-rw-rw----.  1 magento_user apache   2207 Apr 27 21:23 README_EE.md
drwxrwx---.  7 magento_user apache   4096 Jun  7 07:53 setup
-rw-rw----.  1 magento_user apache   3731 Apr 27 21:23 .travis.yml
drwxrwx---.  7 magento_user apache   4096 Jun  7 07:53 update
drwxrws---. 11 magento_user apache   4096 Jun 13 16:05 var
drwxrws---. 29 magento_user apache   4096 Jun  7 07:53 vendor

サンプル出力の説明については、次を参照してください。

  • ほとんどのファイルは -rw-rw---- で、これは 660 です
  • drwxrwx--- = 770
  • -rw-rw-rw- = 666
  • ファイルシステムの所有者は magento_user

詳細情報を取得するには、次のコマンドを入力します。

ls -la /var/www/html/magento2/pub

Adobe Commerceは静的ファイルアセットを pub のサブディレクトリにデプロイするので、権限と所有権を確認することもお勧めします。

詳しくは、 ファイルシステムの権限と所有権を参照してください。

pub/ ディレクトリルートの設定

詳しくは、 セキュリティを強化するための docroot の変更を参照してください。

Composer アップデート プラグインのインストール

magento/composer-root-update-plugin Composer プラグインは、新しい製品要件に更新する前に、ルート プロジェクト composer.json ファイルに加える必要がある変更を解決します。

このプラグインは、依存関係の競合を手動で特定および修正するのではなく、特定して解決を支援することで、手動アップグレードを部分的に自動化します。

プラグインをインストールするには：

  1. パッケージを composer.json ファイルに追加します。

    code language-bash 
    composer require magento/composer-root-update-plugin ~2.0 --no-update

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

    code language-bash 
    composer update
recommendation-more-help
83a60e0e-8849-4685-a8cd-c129ecd795ea