ドキュメントCommerceツール

使用方法

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

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

Quality Patches Tool は、AdobeとMagento Open Sourceコミュニティが開発した個別のパッチを提供します。 インストールされたバージョンのAdobe Commerceで使用可能な個々のパッチに関する一般情報を適用、元に戻して表示できます。 パッチの開発者に関係なく、Adobe Commerce プロジェクトにパッチを適用できます。 例えば、コミュニティが開発したパッチをAdobe Commerce プロジェクトに適用できます。

この テクニカルビデオでは、Adobe Commerce用の品質向上パッチツールの使用方法について説明します。

INFO
Adobe Commerce プロジェクトにパッチを適用する手順については、 個別のパッチの適用を参照してください。 リリースされたパッチの完全なリストを確認するには、「Quality Patches Tool: パッチの検索」を参照してください。
WARNING
コードが複雑になり、新しいバージョンへのアップグレードがより困難になるため、Quality Patches Tool を使用して多数のパッチを適用することはお勧めしません。

インストール

INFO
まだインストールされていない場合は、Quality Patches Tool をインストールする前に Git または パッチをインストールする必要があります。 magento/quality-patches Composer パッケージを composer.json ファイルに追加します。
composer require magento/quality-patches

個々のパッチの表示

Adobe Commerceのバージョンで使用可能な個々のパッチのリストを表示するには：

./vendor/bin/magento-patches status

次のような出力が表示されます。

Id
タイトル
タイプ
ステータス
詳細
MAGECLOUD-5069
展開中に FPC が無効になります
オプション
適用なし
影響を受けたコンポーネント：
- magento/module-page-cache
MCLOUD-5650
ファイルから読み取った後でデプロイメント設定を保持
オプション
適用なし
影響を受けるコンポーネント：
- magento/framework
MCLOUD-5684
ページネーションが機能しない – product_list_limit=all
オプション
適用なし
影響を受けるコンポーネント：- magento/module-elasticsearch
MCLOUD-5837
ロードバランサーの問題を修正
非推奨
適用日
推奨交換品：MC-1
該当するコンポーネント：- magento/framework
バンドル–2554
支払情報バグの設定
オプション
適用なし
影響を受けるコンポーネント：
- amzn/amazon-pay-module
MC-1
修正点（問題 1）
オプション
適用日
影響を受けたコンポーネント：
- magento/module-cms
MC-2
修正点（問題 2）
オプション
適用なし
影響を受けたコンポーネント：
- magento/module-cms
MC-3
修正点（問題 3）
オプション
適用なし
必要なパッチ：
- MC-2
影響を受けるコンポーネント：
- magento/module-cms
MC-3-V2
問題 3 の修正を更新し、MC-3 パッチを置き換えました。
オプション
該当なし
影響を受けたコンポーネント：
- magento/module-cms

Adobe Commerce 2.3.5。

ステータステーブルには、以下が含まれます。

  • タイプ:

    • Optional — Adobe Commerceのインストールでは、「Quality Patches Tool and the Commerce on Cloud Infrastructure Guide」 > 「Apply patches」パッケージのすべてのパッチがオプションです。
    • Deprecated — Adobeは個々のパッチを非推奨（廃止予定）にしました。 パッチを適用した場合は、元に戻すことをお勧めします。 元に戻す操作では、ステータステーブルからパッチも削除されます。

  • ステータス:

    • Applied — パッチが適用されました。
    • Not applied — パッチが適用されていません。
    • N/A – 競合が原因で、パッチのステータスを定義できません。

  • 詳細:

    • Affected components – 影響を受けるモジュールのリスト。
    • 「Required patches」 – 正しく動作するために指定されたパッチに適用する必要があるパッチのリスト （依存関係）。
    • Recommended replacement – 非推奨（廃止予定）のパッチの代わりとして推奨されるパッチ。
INFO
新しいバージョンのAdobe Commerceにアップグレードした後、パッチが新しいバージョンに含まれていない場合は、パッチを再適用する必要があります。 アップグレード後のパッチの再適用を参照してください。

個別パッチの適用 apply-individual-patches

WARNING
実稼動環境にデプロイする前に、ステージング環境または開発環境ですべてのパッチをテストすることをお勧めします。 また、パッチを適用する前に、データをバックアップすることをお勧めします。 ファイル・システム、メディア、データベースのバックアップとロールバックを参照してください。

単一のパッチを適用するには、次のコマンドを実行します。ここで、MAGETWO-XXXX は、ステータステーブルで指定されたパッチ ID です。

./vendor/bin/magento-patches apply MAGETWO-XXXX

また、追加の各パッチ ID をスペースで区切ることで、複数のパッチを同時に適用することもできます。

./vendor/bin/magento-patches apply MAGETWO-XXXX MAGETWO-YYYY

Adobe Commerce アプリケーションで変更内容を確認するには、パッチを適用した後でキャッシュをクリーンアップする必要があります。

./bin/magento cache:clean
INFO
適用されたパッチのリストを別の場所に保持することを検討してください。 Adobe Commerceの新しいバージョンにアップグレードした後で、一部の機能を再適用する必要が生じる場合があります。 アップグレード後のパッチの再適用を参照してください。

個々のパッチを元に戻す

WARNING
実稼動環境にデプロイする前に、ステージング環境または開発環境ですべてのパッチをテストすることをお勧めします。 また、パッチを適用する前に、データをバックアップすることをお勧めします。 ファイル・システム、メディア、データベースのバックアップとロールバックを参照してください。

単一のパッチを元に戻すには、次のコマンドを実行します。ここで、MAGETWO-XXXX は、ステータステーブルで指定されたパッチ ID です。

./vendor/bin/magento-patches revert MAGETWO-XXXX

また、追加の各パッチ ID をスペースで区切ることで、複数のパッチを同時に元に戻すこともできます。

./vendor/bin/magento-patches revert MAGETWO-XXXX MAGETWO-YYYY

適用したすべてのパッチを元に戻すには、次の手順に従います。

./vendor/bin/magento-patches revert --all

Adobe Commerce アプリケーションで変更内容を確認するには、パッチを元に戻した後でキャッシュをクリーンアップする必要があります。

./bin/magento cache:clean

最新情報を取得

Adobe Commerceでは、新しい個別パッチを定期的にリリースしています。 新しい個別パッチを取得するには、Quality Patches Tool を更新する必要があります。

composer update magento/quality-patches

追加されたパッチを表示します。

TIP
新しいパッチの追加が表の下部に表示されます。
./vendor/bin/magento-patches status

アップグレード後のパッチの再適用 re-apply-patches-after-an-upgrade

新しいバージョンのAdobe Commerceにアップグレードする場合、パッチが新しいバージョンに含まれていなければ、パッチを再適用する必要があります。

パッチを再適用するには：

  1. Quality Patches Tool を更新します。

    code language-bash 
    composer update magento/quality-patches.

  2. 個別パッチの適用で推奨された、以前に適用したパッチのリストを開きます。

  3. パッチを適用します。

    code language-bash 
    ./vendor/bin/magento-patches apply MAGETWO-XXXX

    パッチを 1 つずつ適用することをお勧めします。

  4. キャッシュのクリーンアップ：

    code language-bash 
    ./bin/magento cache:clean
    note info
    INFO
    status コマンドを実行すると、新しいバージョンに含まれていたパッチは、使用可能なパッチの表に表示されなくなります。

ログ

Quality Patches Tool は、<Magento_root>/var/log/patch.log ファイルのすべての操作をログに記録します。

recommendation-more-help
c2d96e17-5179-455c-ad3a-e1697bb4e8c3