パッチの適用
Cloud Patches for Commerce および Quality Patches Tool は、インストールされているAdobe Commerce アプリケーションにパッチを提供します。
- Commerce用クラウドパッチ パッケージは、重要な修正を含む必要なパッチを提供します
- 品質パッチは、後方互換性のない変更を含まない 個別パッチとして、オプションの影響の少ない品質修正を提供します
リリース済みのパッチの完全なリストを確認するには、Commerce運用ツールガイド の 使用可能なパッチを参照してください。
どちらのパッケージも、すべてのAdobe Commerce バージョンとクラウド環境の統合を強化し、重要な修正、オプションの修正、カスタムの修正の迅速な配信をサポートします。 これらのパッケージを使用して、Commerceで使用可能な個々のパッチに関する一般情報を適用、元に戻し、表示できます。
リモート環境に変更をデプロイすると、ece-tools パッケージは magento/magento-cloud-patches と magento/quality-patches を使用して保留中のパッチをチェックし、次の順序で自動的に適用します。
- 「Commerce用クラウドパッチ」パッケージに含まれる、必要なすべてのCommerce パッチを適用します。
- Quality Patches Tool に含まれているオプションのCommerce パッチを適用します。
- カスタムパッチをパッチ名のアルファベット順に
/m2-hotfixesディレクトリに適用します。
ece-tools パッケージまたはCommerce用クラウド修正プログラム パッケージを更新すると、次回プロジェクトをデプロイする際に必要な最新の修正プログラムが適用されます。または、ece-patches apply CLI コマンドを使用して即座に修正プログラムをデプロイし、クラウド環境を再デプロイすることもできます。 デプロイメントプロセス中は 必須パッチをスキップすることはできません。前提条件
Quality Patches Tool は、Cloud Patches for Commerceおよび ece-tools パッケージの依存関係です。 最新のパッチを適用するには、 最新バージョンの ECE-Tools がインストールされている必要があります。 ECE-Tools の最低限必要なバージョンは 2002.1.2 です。
使用可能なパッチとステータスの表示
使用可能な個別パッチのリストを表示するには：
php ./vendor/bin/ece-patches status
応答の例：
More detailed information about patches you can find on https://support.magento.com/
╔════════════════╤═════════════════════════════════════════════════╤══════════╤═════════════╤═════════════════════════════════╗
║ Id │ Title │ Type │ Status │ Details ║
╠════════════════╪═════════════════════════════════════════════════╪══════════╪═════════════╪═════════════════════════════════╣
║ MAGECLOUD-5069 │ FPC is getting disabled during deployments │ Required │ Applied │ Affected components: ║
║ │ │ │ │ - magento/module-page-cache ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ MCLOUD-5650 │ Hold deployment config after reading from file │ Required │ Applied │ Affected components: ║
║ │ │ │ │ - magento/framework ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ MCLOUD-5684 │ Pagination Not working - product_list_limit=all │ Required │ Applied │ Affected components: ║
║ │ │ │ │ - magento/module-elasticsearch ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ MC-65837 │ Fix load balancer issue │Deprecated│ Applied │ Recommended replacement: MC-1 ║
║ │ │ │ │ Affected components: ║
║ │ │ │ │ - magento/framework ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ BUNDLE-2554 │ Set Payment info bug │ Required │ Not applied │ Affected components: ║
║ │ │ │ │ - amzn/amazon-pay-module ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ MC-1 │ Fixes issue 1 │ Optional │ Applied │ Affected components: ║
║ │ │ │ │ - magento/module-cms ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ MC-2 │ Fixes issue 2 │ Optional │ Not applied │ Affected components: ║
║ │ │ │ │ - magento/module-cms ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ MC-3 │ Fixes issue 3 │ Optional │ Not applied │ Required patches: ║
║ │ │ │ │ - MC-2 ║
║ │ │ │ │ Affected components: ║
║ │ │ │ │ - magento/module-cms ║
╟────────────────┼─────────────────────────────────────────────────┼──────────┼─────────────┼─────────────────────────────────╢
║ N/A │ ../m2-hotfixes/MDVA_custom__2.3.5_ce.patch │ Custom │ N/A │ Affected components: ║
║ │ │ │ │ - magento/module-framework ║
╚════════════════╧═════════════════════════════════════════════════╧══════════╧═════════════╧═════════════════════════════════╝
Magento 2 Enterprise Edition, version 2.3.5.0
ステータステーブルには、以下のタイプの情報が表示されます。
-
タイプ:
Optional– 品質向上パッチツールおよびクラウドパッチパッケージのすべてのパッチは、Adobe CommerceおよびMagento Open Sourceのインストールではオプションです。 クラウドインフラストラクチャー上のAdobe Commerceの場合、すべてのパッチはオプションです。Required- Cloud のお客様には、Cloud Patches for Commerce パッケージのすべてのパッチが必要です。Deprecated– 個々のパッチは非推奨としてマークされています。適用した場合は元に戻すことをお勧めします。 非推奨パッチを元に戻すと、そのパッチはステータステーブルに表示されなくなります。Custom- 「m2-hotfixes」ディレクトリのすべてのパッチ。
-
ステータス:
Applied- パッチが適用されました。Not applied- パッチが適用されていません。N/A– 競合が原因でパッチのステータスを定義できません。
-
詳細:
Affected components– 影響を受けるモジュールのリスト。Required patches– 必要なパッチ（依存関係）のリスト。Recommended replacement– 非推奨のパッチの代わりとして推奨されるパッチ。
ローカル環境でのパッチの適用
ローカル環境でパッチを手動で適用し、デプロイ前にテストできます。
ローカル開発環境で個別のパッチを適用するには:
-
.magento.env.yamlファイルに「QUALITY_variables」PATCHを追加し、その下に必要なパッチをリストします。code language-yaml stage: build: QUALITY_PATCHES: - MCTEST-1002 - MCTEST-1003 -
プロジェクトルートから、パッチを適用します。
code language-bash php ./vendor/bin/ece-patches applyece-patches applyコマンドは、次の順序でパッチを適用します。- 必要なパッチ
- 個別のパッチ（オプション）
/m2-hotfixesディレクトリからのカスタムパッチ
-
キャッシュをクリアします。
code language-bash php ./bin/magento cache:clean -
パッチをテストし、カスタムパッチに必要な変更を加えます。
リモート環境へのパッチの適用
リモート環境にパッチを適用するには:
-
QUALITY_PATCHES変数を.magento.env.yamlファイルに追加し、その下に必要なパッチをリストします。code language-yaml stage: build: QUALITY_PATCHES: - MCTEST-1002 - MCTEST-1003note note NOTE 新しいバージョンのAdobe Commerceにアップグレードした後、パッチが新しいバージョンに含まれていない場合は、パッチを再適用する必要があります。 -
更新された
.magento.env.yamlファイルを追加、コミット、プッシュします。code language-bash git add .magento.env.yamlcode language-bash git commit -m "Apply patch"code language-bash git push origin <branch-name>
カスタムパッチの適用
デプロイ時に、ECE-Tools は、プロジェクトルートの /m2-hotfixes ディレクトリに追加されたすべてのAdobeパッチとカスタムパッチを適用します。
.patch 拡張子で終わる必要があります。クラウド環境にカスタムパッチを適用してテストするには:
-
プロジェクトルートに
m2-hotfixesというディレクトリが存在しない場合は、作成します。code language-bash mkdir m2-hotfixes -
パッチファイルを
/m2-hotfixesディレクトリにコピーします。 -
コードの変更を追加、コミットおよびプッシュします。
code language-bash git add m2-hotfixes/code language-bash git commit -m "Apply patch"code language-bash git push origin <branch-name>note note NOTE 必ず、実稼動前の環境ですべてのパッチをテストしてください。 クラウドインフラストラクチャー上のAdobe Commerceの場合は、 magento-cloud environment:branch <branch-name>CLI コマンドを使用してブランチを作成できます。
カスタムパッチを元に戻す
以前に適用したカスタムパッチを元に戻すかアンインストールするには：
-
/m2-hotfixesディレクトリからパッチファイルを削除します。 -
コードの変更を追加、コミットおよびプッシュします。
code language-bash git add m2-hotfixes/code language-bash git commit -m "Revert patch"code language-bash git push origin <branch-name>note note NOTE 必ず実稼動前の環境でテストしてください。 クラウドインフラストラクチャー上のAdobe Commerceの場合は、 magento-cloud environment:branch <branch-name>CLI コマンドを使用してブランチを作成できます。
クラウド以外のプロジェクトへのパッチの適用
Magento Open SourceプロジェクトとAdobe Commerce プロジェクトには、 品質向上パッチツールを使用します。
ローカル環境でのパッチの復帰
ece-patches CLI を使用すると、ローカル開発環境で以前に適用したすべてのパッチを元に戻すことができます。
適用したすべてのパッチを元に戻すには、次の手順に従います。
php ./vendor/bin/ece-patches revert
このコマンドは、すべてのパッチを次の順序に戻します。
- 適用されたすべてのカスタム パッチを/m2-hotfixes ディレクトリから元に戻します。
- 適用したすべてのオプションの個別パッチを元に戻します。
- 適用されたすべての必要なパッチを元に戻します。
ログ
品質向上パッチツールは、すべての操作を <Project_root>/var/log/patch.log ファイルに記録します。