Utilizzo

Il Quality Patches Tool distribuisce singole patch sviluppate da Adobe e dalla comunità di Magenti Open Source. Consente di applicare, ripristinare e visualizzare informazioni generali su tutte le singole patch disponibili per la versione installata di Adobe Commerce o del Magento Open Source. Puoi applicare patch ai progetti Adobe Commerce e Magento Open Source indipendentemente da chi ha sviluppato la patch. Ad esempio, puoi applicare ai progetti Adobe Commerce una patch sviluppata dalla community.

Guarda questo video tecnico e scopri come utilizzare lo strumento Quality Patches per Adobe Commerce e Magento Open Source.

INFO
Consulta Applicare singole patch per istruzioni sull’applicazione di patch ai progetti Adobe Commerce o Magento Open Source. Consulta Quality Patches Tool: cerca le patch per rivedere un elenco completo delle patch rilasciate.
WARNING
Si sconsiglia di utilizzare il Quality Patches Tool per applicare un numero elevato di patch, in quanto aumenta la complessità del codice e rende più difficile l’aggiornamento a una nuova versione.

Installa

INFO
Se non è già installato, è necessario installare Git o Patch prima di installare Quality Patches Tool. Aggiungi il magento/quality-patches Pacchetto di composizione al tuo composer.json file:
composer require magento/quality-patches

Visualizzare singole patch

Per visualizzare l’elenco delle singole patch disponibili per la versione di Adobe Commerce o del Magento Open Source in uso:

./vendor/bin/magento-patches status

L’output sarà simile al seguente:

ID
Titolo
Tipo
Stato
Dettagli
MAGECLOUD-5069
FPC viene disabilitato durante le distribuzioni
Facoltativo
Non applicato
Componenti interessati:
- magento/module-page-cache
MCLOUD-5650
Mantieni la configurazione di distribuzione dopo la lettura dal file
Facoltativo
Non applicato
Componenti interessati:
- magento/framework
MCLOUD-5684
Paginazione non funzionante - product_list_limit=all
Facoltativo
Non applicato
Componenti interessati: - magento/module-elasticsearch
MCLOUD-5837
Correggi il problema del load balancer
Obsoleto
Applicato
Sostituzione consigliata: MC-1
Componenti interessati: - magento/framework
BUNDLE-2554
Imposta bug informazioni pagamento
Facoltativo
Non applicato
Componenti interessati:
- modulo amzn/amazon-pay
MC-1
Correzioni del problema 1
Facoltativo
Applicato
Componenti interessati:
- magento/module-cms
MC-2
Correzioni del problema 2
Facoltativo
Non applicato
Componenti interessati:
- magento/module-cms
MC-3
Correzioni del problema 3
Facoltativo
Non applicato
Patch richieste:
- MC-2
Componenti interessati:
- magento/module-cms
MC-3-V2
È stata aggiornata la correzione per il problema 3 e sostituisce la patch MC-3.
Facoltativo
N/D
Componenti interessati:
- magento/module-cms

Adobe Commerce 2.3.5.

La tabella di stato include:

  • Tipo:

    • Optional — Tutte le patch del Quality Patches Tool e Guida di Commerce su infrastruttura cloud > Applicazione delle patch sono facoltativi per le installazioni di Adobe Commerce e di Magento Open Source.
    • Deprecated — Adobe ha dichiarato obsoleta la singola patch. Se ha applicato la patch, si consiglia di ripristinarla. L’operazione di ripristino rimuove anche la patch dalla tabella di stato.
  • Stato:

    • Applied — Il cerotto è stato applicato.
    • Not applied — Il cerotto non è stato applicato.
    • N/A — Impossibile definire lo stato della patch a causa di conflitti.
  • Dettagli:

    • Affected components — l'elenco dei moduli interessati.
    • Required patches — l'elenco delle patch che devono essere applicate affinché una patch indicata funzioni correttamente (dipendenze).
    • Recommended replacement — Il cerotto che si consiglia di sostituire con un cerotto obsoleto.
INFO
Dopo l'aggiornamento a una nuova versione di Adobe Commerce o Magento Open Source, è necessario riapplicare le patch se non sono incluse nella nuova versione. Consulta Riapplicare le patch dopo un aggiornamento.

Applicare singole patch apply-individual-patches

WARNING
È consigliabile eseguire il test di tutte le patch in un ambiente di staging o di sviluppo prima di distribuirle in produzione. Si consiglia inoltre di eseguire il backup dei dati prima di applicare una patch. Consulta Backup e rollback del file system, dei supporti e del database.

Per applicare una singola patch, eseguire il comando seguente dove MAGETWO-XXXX è l’ID patch specificato nella tabella di stato:

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

Puoi anche applicare più patch contemporaneamente separando ogni ID patch aggiuntivo con uno spazio:

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

Per visualizzare le modifiche nell’applicazione Adobe Commerce, pulisci la cache dopo aver applicato le patch:

./bin/magento cache:clean
INFO
Prendere in considerazione la possibilità di mantenere un elenco di patch applicate in una posizione separata. Potrebbe essere necessario riapplicarne alcuni dopo l’aggiornamento a una nuova versione di Adobe Commerce o di un Magento Open Source. Consulta Riapplicare le patch dopo un aggiornamento.

Ripristinare singole patch

WARNING
È consigliabile eseguire il test di tutte le patch in un ambiente di staging o di sviluppo prima di distribuirle in produzione. Si consiglia inoltre di eseguire il backup dei dati prima di applicare una patch. Consulta Backup e rollback del file system, dei supporti e del database.

Per ripristinare una singola patch, eseguire il comando seguente dove MAGETWO-XXXX è l’ID patch specificato nella tabella di stato:

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

Inoltre, è possibile ripristinare più patch contemporaneamente separando ogni ID patch aggiuntivo con uno spazio:

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

Per ripristinare tutte le patch applicate:

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

Per visualizzare le modifiche nell’applicazione Adobe Commerce, pulisci la cache dopo il ripristino delle patch:

./bin/magento cache:clean

Ottieni aggiornamenti

Adobe Commerce rilascia periodicamente nuove patch singole. È necessario aggiornare Quality Patches Tool per ottenere nuove patch singole:

composer update magento/quality-patches

Visualizzare le patch aggiunte:

TIP
Le nuove patch di aggiunta vengono visualizzate nella parte inferiore della tabella.
./vendor/bin/magento-patches status

Riapplicare le patch dopo un aggiornamento re-apply-patches-after-an-upgrade

Quando esegui l’aggiornamento a una nuova versione di Adobe Commerce o Magento Open Source, devi riapplicare le patch se non sono incluse nella nuova versione.

Per riapplicare le patch:

  1. Aggiornare il Quality Patches Tool:

    code language-bash
    composer update magento/quality-patches.
    
  2. Aprire l'elenco delle patch applicate in precedenza, che era consigliato in Applicare singole patch.

  3. Applicare le patch:

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

    La best practice prevede l’applicazione di patch una alla volta.

  4. Pulisci la cache:

    code language-bash
    ./bin/magento cache:clean
    
    note info
    INFO
    Quando si esegue status , le patch incluse nella nuova versione non vengono più visualizzate nella tabella delle patch disponibili.

Registrazione

Il Quality Patches Tool registra tutte le operazioni in <Magento_root>/var/log/patch.log file.

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