使用方法
Quality Patches Tool は、AdobeとMagento Open Sourceコミュニティが開発した個別のパッチを提供します。 インストールされたバージョンのAdobe Commerceで使用可能な個々のパッチに関する一般情報を適用、元に戻して表示できます。 パッチの開発者に関係なく、Adobe Commerce プロジェクトにパッチを適用できます。 例えば、コミュニティが開発したパッチをAdobe Commerce プロジェクトに適用できます。
この テクニカルビデオでは、Adobe Commerce用の品質向上パッチツールの使用方法について説明します。
インストール
composer require magento/quality-patches
個々のパッチの表示
Adobe Commerceのバージョンで使用可能な個々のパッチのリストを表示するには:
./vendor/bin/magento-patches status
次のような出力が表示されます。
- magento/module-page-cache
- magento/framework
該当するコンポーネント:- magento/framework
- amzn/amazon-pay-module
- magento/module-cms
- magento/module-cms
- MC-2
影響を受けるコンポーネント:
- magento/module-cms
- 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
– 非推奨(廃止予定)のパッチの代わりとして推奨されるパッチ。
個別パッチの適用 apply-individual-patches
単一のパッチを適用するには、次のコマンドを実行します。ここで、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
個々のパッチを元に戻す
単一のパッチを元に戻すには、次のコマンドを実行します。ここで、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
追加されたパッチを表示します。
./vendor/bin/magento-patches status
アップグレード後のパッチの再適用 re-apply-patches-after-an-upgrade
新しいバージョンのAdobe Commerceにアップグレードする場合、パッチが新しいバージョンに含まれていなければ、パッチを再適用する必要があります。
パッチを再適用するには:
-
Quality Patches Tool を更新します。
code language-bash composer update magento/quality-patches.
-
個別パッチの適用で推奨された、以前に適用したパッチのリストを開きます。
-
パッチを適用します。
code language-bash ./vendor/bin/magento-patches apply MAGETWO-XXXX
パッチを 1 つずつ適用することをお勧めします。
-
キャッシュのクリーンアップ:
code language-bash ./bin/magento cache:clean
note info INFO status
コマンドを実行すると、新しいバージョンに含まれていたパッチは、使用可能なパッチの表に表示されなくなります。
ログ
Quality Patches Tool は、<Magento_root>/var/log/patch.log
ファイルのすべての操作をログに記録します。