DocumentaciónCommerceHerramientas

Uso

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

Creado para:

  • Experienced
  • Admin
  • Developer

El Quality Patches Tool ofrece parches individuales desarrollados por Adobe y la comunidad de Magento Open Source. Permite aplicar, revertir y ver información general sobre todos los parches individuales disponibles para la versión instalada de Adobe Commerce. Puede aplicar parches a proyectos de Adobe Commerce independientemente de quién lo haya desarrollado. Por ejemplo, puede aplicar un parche desarrollado por la comunidad a proyectos de Adobe Commerce.

Ver esto vídeo técnico y aprenda a utilizar la herramienta Parches de calidad para Adobe Commerce.

INFO
Consulte Aplicar parches individuales para obtener instrucciones sobre cómo aplicar parches a los proyectos de Adobe Commerce. Consulte Quality Patches Tool: Buscar parches para revisar una lista completa de parches publicados.
WARNING
No se recomienda utilizar la variable Quality Patches Tool para aplicar una gran cantidad de parches porque aumenta la complejidad de su código y dificulta la actualización a una nueva versión.

Instalar

INFO
Si aún no está instalado, debe instalar Git o Parche antes de instalar el Quality Patches Tool. Añada el magento/quality-patches Paquete de Compositor para su composer.json archivo:
composer require magento/quality-patches

Ver parches individuales

Para ver la lista de parches individuales disponibles para su versión de Adobe Commerce:

./vendor/bin/magento-patches status

Verá un resultado similar al siguiente:

Id
Título
Tipo
Estado
Detalles
MAGECLOUD-5069
FPC se desactiva durante las implementaciones
Opcional
No aplicado
Componentes afectados:
- magento/module-page-cache
MCLOUD-5650
Mantener la configuración de implementación después de leer el archivo
Opcional
No aplicado
Componentes afectados:
- magento/framework
MCLOUD-5684
La paginación no funciona - product_list_limit=all
Opcional
No aplicado
Componentes afectados: - magento/module-elasticsearch
MCLOUD-5837
Corregir problema del equilibrador de carga
Obsoleto
Aplicado
Reemplazo recomendado: MC-1
Componentes afectados: - magento/framework
PAQUETE-2554
Establecer error de información de pago
Opcional
No aplicado
Componentes afectados:
- amzn/amazon-pay-module
MC-1
Soluciona el problema 1
Opcional
Aplicado
Componentes afectados:
- magento/module-cms
MC-2
Soluciona el problema 2
Opcional
No aplicado
Componentes afectados:
- magento/module-cms
MC-3
Correcciones del problema 3
Opcional
No aplicado
Parches necesarios:
- MC-2
Componentes afectados:
- magento/module-cms
MC-3-V2
Se ha actualizado la corrección del problema 3, que sustituye al parche de MC-3
Opcional
N/D
Componentes afectados:
- magento/module-cms

Adobe Commerce 2.3.5.

La tabla de estado incluye:

  • Tipo:

    • Optional — Todos los parches del Quality Patches Tool y el Guía de Commerce en la infraestructura de la nube > Aplicar parches son opcionales para las instalaciones de Adobe Commerce.
    • Deprecated — el Adobe ha desaprobado el parche individual. Si ha aplicado el parche, le recomendamos que lo revierta. La operación de reversión también elimina el parche de la tabla de estado.

  • 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 varios conflictos.

  • Detalles:

    • Affected components — La lista de módulos afectados.
    • Required patches — La lista de parches que deben aplicarse para que un parche indicado funcione correctamente (dependencias).
    • Recommended replacement — El parche que se recomienda para sustituir un parche obsoleto.
INFO
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. Consulte Volver a aplicar parches después de una actualización.

Aplicar parches individuales apply-individual-patches

WARNING
Se recomienda probar todos los parches en un entorno de ensayo o desarrollo antes de implementarlos en producción. También se recomienda realizar una copia de seguridad de los datos antes de aplicar un parche. Consulte Realizar una copia de seguridad y una reversión del sistema de archivos, medios y base de datos.

Para aplicar un solo parche, ejecute el siguiente comando donde MAGETWO-XXXX es el ID de parche especificado en la tabla de estado:

./vendor/bin/magento-patches apply MAGETWO-XXXX

También puede aplicar varios parches al mismo tiempo separando cada ID de parche adicional con un espacio:

./vendor/bin/magento-patches apply MAGETWO-XXXX MAGETWO-YYYY

Debe limpiar la caché después de aplicar los parches para ver los cambios en la aplicación de Adobe Commerce:

./bin/magento cache:clean
INFO
Considere la posibilidad de mantener una lista de parches aplicados en una ubicación diferente. Es posible que tenga que volver a aplicar algunos de ellos después de actualizar a una nueva versión de Adobe Commerce. Consulte Volver a aplicar parches después de una actualización.

Reversión de parches individuales

WARNING
Se recomienda probar todos los parches en un entorno de ensayo o desarrollo antes de implementarlos en producción. También se recomienda realizar una copia de seguridad de los datos antes de aplicar un parche. Consulte Realizar una copia de seguridad y una reversión del sistema de archivos, medios y base de datos.

Para revertir un solo parche, ejecute el siguiente comando donde MAGETWO-XXXX es el ID de parche especificado en la tabla de estado:

./vendor/bin/magento-patches revert MAGETWO-XXXX

Además, puede revertir varios parches al mismo tiempo separando cada ID de parche adicional con un espacio:

./vendor/bin/magento-patches revert MAGETWO-XXXX MAGETWO-YYYY

Para revertir todos los parches aplicados:

./vendor/bin/magento-patches revert --all

Debe limpiar la caché después de revertir los parches para ver los cambios en la aplicación de Adobe Commerce:

./bin/magento cache:clean

Obtener actualizaciones

Adobe Commerce publica periódicamente nuevos parches individuales. Debe actualizar el Quality Patches Tool para obtener nuevos parches individuales:

composer update magento/quality-patches

Ver los parches añadidos:

TIP
Los nuevos parches de adición se muestran en la parte inferior de la tabla.
./vendor/bin/magento-patches status

Volver a aplicar parches después de una actualización re-apply-patches-after-an-upgrade

Al actualizar a una nueva versión de Adobe Commerce, debe volver a aplicar los parches si estos no se incluyen en la nueva versión.

Para volver a aplicar parches:

  1. Actualice el Quality Patches Tool:

    code language-bash 
    composer update magento/quality-patches.

  2. Abra la lista de parches aplicados anteriormente, que se recomendó en Aplicar parches individuales.

  3. Aplique los parches:

    code language-bash 
    ./vendor/bin/magento-patches apply MAGETWO-XXXX

    La práctica recomendada es aplicar los parches de uno en uno.

  4. Limpie la caché:

    code language-bash 
    ./bin/magento cache:clean
    note info
    INFO
    Cuando ejecute el status , los parches que se incluyeron en la nueva versión ya no se muestran en la tabla de parches disponibles.

Registro

El Quality Patches Tool registra todas las operaciones en <Magento_root>/var/log/patch.log archivo.

recommendation-more-help
c2d96e17-5179-455c-ad3a-e1697bb4e8c3