Aplicar parches
Parches de nube para Commerce y el Herramienta Parches de calidad envíe parches a la aplicación de Adobe Commerce instalada.
- El paquete Cloud Patches for Commerce ofrece los parches necesarios con correcciones críticas
- Los parches de calidad ofrecen correcciones de calidad opcionales y de bajo impacto como parches individuales que no contengan cambios incompatibles con versiones anteriores
Consulte Parches disponibles en el Guía de herramientas de operaciones de Commerce para revisar una lista completa de parches publicados.
Ambos paquetes mejoran la integración de todas las versiones de Adobe Commerce con los entornos en la nube y admiten la entrega rápida de correcciones críticas, opcionales y personalizadas. Puede utilizar estos paquetes para aplicar, revertir y ver información general sobre todos los parches individuales que están disponibles para Commerce.
Al implementar cambios en el entorno remoto, la variable ece-tools
el paquete utiliza magento/magento-cloud-patches
y magento/quality-patches
para comprobar parches pendientes y aplicarlos automáticamente en el siguiente orden:
- Aplique todos los parches de Commerce necesarios incluidos en el paquete Parches de Cloud para Commerce.
- Aplicar los parches de comercio opcionales seleccionados incluidos en la herramienta Parches de calidad.
- Aplicar parches personalizados en
/m2-hotfixes
en orden alfabético por nombre de parche.
ece-tools
para el paquete de Cloud Patches for Commerce, los parches necesarios más recientes se aplican la próxima vez que implemente el proyecto o puede implementarlos inmediatamente utilizando ece-patches apply
Comando CLI y reimplementación de su entorno de nube. No puede omitir parches necesarios durante el proceso de implementación.Requisitos previos
La herramienta Parches de calidad es una dependencia de Cloud Patches para Commerce y ece-tools
paquete. Para aplicar los parches más recientes, debe tener la última versión de ECE-Tools instalado. La versión mínima requerida de ECE-Tools es 2002.1.2.
Ver parches y estado disponibles
Para ver la lista de parches individuales disponibles:
php ./vendor/bin/ece-patches status
Respuesta de ejemplo:
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
La tabla de estado contiene los siguientes tipos de información:
-
Tipo:
Optional
: todos los parches de la herramienta Parches de calidad y del paquete Parches de nube son opcionales para las instalaciones de Adobe Commerce y de Magento Open Source. Para Adobe Commerce en la infraestructura en la nube, todos los parches son opcionales.Required
: todos los parches del paquete Parches de nube para Commerce son necesarios para los clientes de Cloud.Deprecated
: el parche individual está marcado como obsoleto y se recomienda revertirlo si se ha aplicado. Después de revertir un parche obsoleto, ya no se mostrará en la tabla de estado.Custom
: todos los parches del directorio "m2-hotfixes".
-
Estado:
Applied
: se ha aplicado el parche.Not applied
: no se ha aplicado el parche.N/A
: el estado del parche no se puede definir debido a conflictos.
-
Detalles:
Affected components
: lista de módulos afectados.Required patches
: lista de parches necesarios (dependencias).Recommended replacement
: parche que se recomienda para sustituir un parche obsoleto.
Aplicación de un parche en un entorno local
Puede aplicar parches manualmente en un entorno local y probarlos antes de la implementación.
Para aplicar parches individuales en un entorno de desarrollo local:
-
Agregue la variable "QUALITY_PATCH" a
.magento.env.yaml
y enumere los parches necesarios debajo de.code language-yaml stage: build: QUALITY_PATCHES: - MCTEST-1002 - MCTEST-1003
-
Desde la raíz del proyecto, aplique los parches.
code language-bash php ./vendor/bin/ece-patches apply
El
ece-patches apply
El comando aplica parches en el siguiente orden:- Parches necesarios
- Parches individuales opcionales
- Parches personalizados del
/m2-hotfixes
directorio
-
Borre la caché.
code language-bash php ./bin/magento cache:clean
-
Pruebe los parches y realice los cambios necesarios en los parches personalizados.
Aplicación de un parche en un entorno remoto
Para aplicar parches en un entorno remoto:
-
Añada el
QUALITY_PATCHES
a la.magento.env.yaml
y enumere los parches necesarios debajo de.code language-yaml stage: build: QUALITY_PATCHES: - MCTEST-1002 - MCTEST-1003
note note NOTE Después de actualizar a una nueva versión de Adobe Commerce, debe volver a aplicar los parches si estos no están incluidos en la nueva versión. -
Añada, confirme e inserte el actualizado
.magento.env.yaml
archivo.code language-bash git add .magento.env.yaml
code language-bash git commit -m "Apply patch"
code language-bash git push origin <branch-name>
Aplicar un parche personalizado
Al implementar, ECE-Tools aplica todos los parches de Adobe y todos los parches personalizados que agregue al /m2-hotfixes
en la raíz del proyecto.
.patch
extensión.Para aplicar y probar un parche personalizado en un entorno de Cloud:
-
En la raíz del proyecto, cree un directorio llamado
m2-hotfixes
si no existe.code language-bash mkdir m2-hotfixes
-
Copie el archivo de parche en
/m2-hotfixes
directorio. -
Agregar, confirmar y enviar cambios de código.
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 Asegúrese de probar todos los parches en un entorno de preproducción. Para Adobe Commerce en la infraestructura en la nube, puede crear ramas con magento-cloud environment:branch <branch-name>
Comando CLI.
Revertir un parche personalizado
Para revertir o desinstalar un parche personalizado aplicado anteriormente:
-
Elimine el archivo de parche de la
/m2-hotfixes
directorio. -
Agregar, confirmar y enviar cambios de código.
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 Asegúrese de realizar la prueba en un entorno de preproducción. Para Adobe Commerce en la infraestructura en la nube, puede crear ramas con magento-cloud environment:branch <branch-name>
Comando CLI.
Aplicación de parches a un proyecto que no esté en la nube
Utilice el Herramienta Parches de calidad para proyectos de Magento Open Source y Adobe Commerce.
Reversión de un parche en un entorno local
Puede revertir todos los parches aplicados anteriormente en un entorno de desarrollo local utilizando ece-patches
CLI.
Para revertir todos los parches aplicados:
php ./vendor/bin/ece-patches revert
Este comando revierte todos los parches en el siguiente orden:
- Revierte todos los parches personalizados aplicados desde el directorio /m2-hotfixes.
- Revierte todos los parches individuales opcionales aplicados.
- Revierte todos los parches necesarios aplicados.
Registro
La herramienta Parches de calidad registra todas las operaciones en <Project_root>/var/log/patch.log
archivo.