DocumentazioneCommerceStrumenti

Utilizzo

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Esperto
  • Amministratore
  • Sviluppatore

Quality Patches Tool distribuisce singole patch sviluppate da Adobe e dalla community di Magento Open Source. Consente di applicare, ripristinare e visualizzare informazioni generali su tutte le singole patch disponibili per la versione installata di Adobe Commerce. Puoi applicare le patch ai progetti Adobe Commerce indipendentemente da chi l’ha sviluppata. 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.

INFO
Consulta Applicare singole patch per istruzioni sull'applicazione delle patch ai progetti Adobe Commerce. Vedere Quality Patches Tool: Cercare le patch per esaminare un elenco completo delle patch rilasciate.
WARNING
Si consiglia di non utilizzare 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, installare Git o Patch prima di installare Quality Patches Tool. Aggiungere il pacchetto Compositore magento/quality-patches al file composer.json:
composer require magento/quality-patches

Visualizzare singole patch

Per visualizzare l’elenco delle singole patch disponibili per la tua versione di Adobe Commerce:

./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:
- amzn/amazon-pay-module
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 pacchetto Quality Patches Tool e del pacchetto Commerce on Cloud Infrastructure Guide > Apply patches sono facoltative per le installazioni di Adobe Commerce.
    • 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 - La patch è stata applicata.
    • Not applied - La patch non è stata applicata.
    • N/A - Impossibile definire lo stato della patch a causa di conflitti.

  • Dettagli:

    • Affected components — Elenco dei moduli interessati.
    • Required patches — Elenco di patch che devono essere applicate affinché una patch indicata funzioni correttamente (dipendenze).
    • Recommended replacement — La patch che si consiglia di sostituire con una patch obsoleta.
INFO
Dopo l'aggiornamento a una nuova versione di Adobe Commerce, è necessario riapplicare le patch se non sono incluse nella nuova versione. Vedi 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 Eseguire il backup e il rollback del file system, del supporto 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. Vedi 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 Eseguire il backup e il rollback del file system, del supporto 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, devi riapplicare le patch se non sono incluse nella nuova versione.

Per riapplicare le patch:

  1. Aggiorna Quality Patches Tool:

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

  2. Aprire l'elenco delle patch applicate in precedenza, 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 il comando status, le patch incluse nella nuova versione non vengono più visualizzate nella tabella delle patch disponibili.

Registrazione

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

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