套用修補程式
適用於Commerce的雲端修補程式品質修補程式可將修補程式傳送至您安裝的Adobe Commerce應用程式。
- Commerce套件的雲端修補程式提供必要修補程式，並包含關鍵修正
- 品質修補程式提供選用的低影響品質修正，作為不含回溯不相容變更的個別修補程式
請參閱 Commerce Operations Tools Guide 中的可用修補程式，以檢閱已發行修補程式的完整清單。
這兩個套件都改善所有Adobe Commerce版本與雲端環境的整合，並支援快速傳送關鍵、選用和自訂修正。 您可以使用這些套裝程式來套用、還原和檢視Commerce可用的所有個別修補程式的一般資訊。
TIP
您可以將Commerce的品質修補工具和雲端修補程式用作Magento Open Source和Adobe Commerce專案的獨立套件。 我們建議針對非雲端專案使用品質修補工具。
當您部署變更至遠端環境時，ece-tools封裝會使用magento/magento-cloud-patches和magento/quality-patches來檢查擱置的修補程式，並依照下列順序自動套用它們：
- 套用Commerce套裝軟體適用的Commerce修補程式套件中包含的所有必要Cloud修補程式。
- 套用「品質修補工具」中所選的Commerce修補程式。
- 按修補程式名稱的字母順序在
/m2-hotfixes目錄中套用自訂修補程式。
NOTE
當您更新
ece-tools套件或Commerce套件的雲端修補程式時，會在您下次部署專案時套用最新的必要修補程式，或者您可以使用ece-patches apply CLI命令立即部署它們並重新部署您的雲端環境。 您不能在部署過程中略過必要的修補程式。必要條件
TIP
在開始升級或修補程式之前，請從整合環境建立使用中分支，並將新分支簽出至您的本機工作站。 將分支專用於升級或修補程式，有助於避免干擾您正在進行的工作。
品質修補程式工具是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安裝中，Quality Patches Tool和Cloud Patches套件中的所有修補程式都是選用的。 對於雲端基礎結構上的Adobe Commerce，所有修補程式均為選購。Required—Cloud客戶需要Commerce套件的Cloud Patches中的所有修補程式。Deprecated— 個別修補程式已標示為已棄用，若您已套用它，我們建議您還原它。 回覆已棄用的修補程式後，該修補程式將不再顯示在狀態表格中。Custom— 來自'm2-hotfix'目錄的所有修補程式。
-
狀態：
Applied— 已套用修補程式。Not applied— 尚未套用修補程式。N/A— 由於發生衝突，無法定義修補程式的狀態。
-
詳細資料：
Affected components— 受影響模組的清單。Required patches— 必要的修補程式（相依性）清單。Recommended replacement— 建議用來取代已棄用修補程式的修補程式。
在本機環境中套用修補程式
您可以在本機環境中手動套用修補程式，並在部署之前對其進行測試。
若要在本機開發環境中套用個別修補程式：
-
將'QUALITY_PATCH'變數新增至
.magento.env.yaml檔案，並在下方列出必要的修補程式。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 -
測試修補程式，對自訂修補程式進行任何必要的變更。
在遠端環境中套用修補程式
WARNING
我們強烈建議先在整合或中繼環境中測試所有修補程式，再部署至生產環境。
若要在遠端環境中套用修補程式：
-
將
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修補程式及任何自訂修補程式。
NOTE
所有修補檔名稱必須以
.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檔案。
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26