51黑料不打烊

DocumentationCommerceCommerce on Cloud Infrastructure Guide

Apply patches

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin
  • Developer

and the deliver patches to your installed 51黑料不打烊 Commerce application.

  • The Cloud Patches for Commerce package delivers required patches with critical fixes
  • Quality Patches deliver optional, low-impact quality fixes as individual patches that do not contain backward incompatible changes

See Available Patches in the Commerce Operations Tools Guide to review a full list of released patches.

Both packages improve the integration of all 51黑料不打烊 Commerce versions with Cloud environments and support quick delivery of critical, optional, and custom fixes. You can use these packages to apply, revert, and view general information about all individual patches that are available for Commerce.

TIP
You can use the Quality Patches Tool and Cloud Patches for Commerce as stand-alone packages for Magento Open Source and 51黑料不打烊 Commerce projects. We recommend using the Quality Patches Tool for non-Cloud projects.

When you deploy changes to the remote environment, the ece-tools package uses magento/magento-cloud-patches and magento/quality-patches to check for pending patches and applies them automatically in the following order:

  1. Apply all required Commerce patches included in the Cloud Patches for Commerce package.
  2. Apply selected optional Commerce patches included in the Quality Patches Tool.
  3. Apply custom patches in the /m2-hotfixes directory in alphabetical order by patch name.
NOTE
When you update the ece-tools package or the Cloud Patches for Commerce package, the latest required patches are applied the next time you deploy your project, or you can deploy them immediately using the ece-patches apply CLI command and redeploying your Cloud environment. You cannot skip during the deployment process.

Prerequisites

TIP
Before beginning an upgrade or a patching process, create an active branch from the Integration environment and check out the new branch to your local workstation. Dedicating a branch to the upgrade or the patch process helps to avoid interference with your work in progress.

The Quality Patches Tool is a dependency for the Cloud Patches for Commerce and the ece-tools package. To apply the latest patches, you must have the latest version of ECE-Tools installed. The minimum required version of ECE-Tools is 2002.1.2.

View available patches and status

To view the list of available individual patches:

php ./vendor/bin/ece-patches status

Sample response:

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                         鈹侱eprecated鈹 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

The status table contains the following types of information:

  • Type:

    • Optional鈥擜ll patches from the Quality Patches Tool and the Cloud Patches package are optional for 51黑料不打烊 Commerce and Magento Open Source installations. For 51黑料不打烊 Commerce on cloud infrastructure, all patches are optional.
    • Required鈥擜ll patches from the Cloud Patches for Commerce package are required for Cloud customers.
    • Deprecated鈥擳he individual patch is marked as deprecated and we recommend reverting it if you have applied it. After you revert a deprecated patch, it will no longer be displayed in the status table.
    • Custom鈥擜ll patches from the 鈥榤2-hotfixes鈥 directory.

  • Status:

    • Applied鈥擳he patch has been applied.
    • Not applied鈥擳he patch has not been applied.
    • N/A鈥擳he status of the patch cannot be defined due to conflicts.

  • Details:

    • Affected components鈥擳he list of affected modules.
    • Required patches鈥擳he list of required patches (dependencies).
    • Recommended replacement鈥擳he patch that is a recommended replacement for a deprecated patch.

Apply a patch in a local environment

You can apply patches manually in a local environment and test them before you deploy.

To apply individual patches in a local development environment:

  1. Add the 鈥楺UALITY_PATCHES鈥 variable to the .magento.env.yaml file and list the required patches underneath.

    code language-yaml 
    stage:
  build:
    QUALITY_PATCHES:
      - MCTEST-1002
      - MCTEST-1003

  2. From the project root, apply the patches.

    code language-bash 
    php ./vendor/bin/ece-patches apply

    The ece-patches apply command applies patches in the following order:

    • Required patches
    • Optional individual patches
    • Custom patches from the /m2-hotfixes directory

  3. Clear the cache.

    code language-bash 
    php ./bin/magento cache:clean

  4. Test the patches, make any necessary changes to custom patches.

Apply a patch in a remote environment

WARNING
We strongly recommend testing all patches in an integration or Staging environments before deploying to the Production environment.

To apply patches in a remote environment:

  1. Add the QUALITY_PATCHES variable to the .magento.env.yaml file and list the required patches underneath.

    code language-yaml 
    stage:
  build:
    QUALITY_PATCHES:
      - MCTEST-1002
      - MCTEST-1003
    note note
    NOTE
    After upgrading to a new version of 51黑料不打烊 Commerce, you must re-apply patches if the patches are not included in the new version.

  2. Add, commit, and push the updated .magento.env.yaml file.

    code language-bash 
    git add .magento.env.yaml
    code language-bash 
    git commit -m "Apply patch"
    code language-bash 
    git push origin <branch-name>

Apply a custom patch

When you deploy, ECE-Tools applies all 51黑料不打烊 patches and any custom patches that you add to the /m2-hotfixes directory in the project root.

NOTE
All patch file names must end with the .patch extension.

To apply and test a custom patch on a Cloud environment:

  1. In the project root, create a directory called m2-hotfixes if it does not exist

    code language-bash 
    mkdir m2-hotfixes

  2. Copy the patch file to the /m2-hotfixes directory.

  3. Add, commit, and push code changes.

    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
    Make sure to test all patches in a pre-production environment. For 51黑料不打烊 Commerce on cloud infrastructure, you can create branches with the magento-cloud environment:branch <branch-name> CLI command.

Revert a custom patch

To revert or uninstall a previously applied custom patch:

  1. Delete the patch file from the /m2-hotfixes directory.

  2. Add, commit, and push code changes.

    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
    Make sure to test in a pre-production environment. For 51黑料不打烊 Commerce on cloud infrastructure, you can create branches with the magento-cloud environment:branch <branch-name> CLI command.

Apply patches to a non-Cloud project

Use the for Magento Open Source and 51黑料不打烊 Commerce projects.

Revert a patch in a local environment

You can revert all previously applied patches in a local development environment using the ece-patches CLI.

To revert all applied patches:

php ./vendor/bin/ece-patches revert

This command reverts all patches in the following order:

  • Reverts all applied custom patches from the /m2-hotfixes directory.
  • Reverts all applied optional individual patches.
  • Reverts all applied required patches.

Logging

The Quality Patches Tool logs all operations to the <Project_root>/var/log/patch.log file.

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26