[Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe) e ai progetti on-premise."}

Best practice per l’aggiornamento del progetto

Segui le best practice per le build e la distribuzione e utilizza il flusso di lavoro Aggiornamenti e patch per aggiornare l'applicazione. Per pianificare il lavoro di aggiornamento e post-aggiornamento, attenersi alle seguenti linee guida:

  • Esegui il backup del progetto-Prima di aggiornare Adobe Commerce ed eventuali estensioni di terze parti o personalizzate, esegui il backup del database negli ambienti di integrazione, staging e produzione. Vedere Backup del database.

  • Verifica la presenza di problemi di compatibilità-

    • Assicurati che tutti i temi personalizzati siano compatibili con la nuova versione di Adobe Commerce

    • Dopo l'aggiornamento di estensioni di terze parti e personalizzate, utilizzare il comando magento-cloud local:build per convalidare le dipendenze del Compositore prima della distribuzione ed eseguire Upgrade Compatibility Tool per identificare le incompatibilità a livello di codice tra la versione corrente e quella di destinazione. Quindi utilizzare lo strumento di compatibilità per l'aggiornamento per identificare e assegnare la priorità alle incompatibilità a livello di codice prima di distribuirle in Integration, Staging o Production.

    • Consulta le note sulla versione e la documentazione dell’estensione di Adobe Commerce per assicurarti di aver implementato tutte le soluzioni alternative o le modifiche alla configurazione necessarie per risolvere problemi funzionali noti e bug correlati all’aggiornamento della versione e delle estensioni di Adobe Commerce.

    • Assicurati che le versioni del servizio installate siano compatibili con la nuova versione di Adobe Commerce e aggiorna i servizi secondo necessità. Vedi Servizi.

    • Verifica il database per risolvere eventuali problemi introdotti dagli aggiornamenti della versione e delle estensioni di Adobe Commerce.

    • Apporta gli aggiornamenti necessari alle impostazioni specifiche dell’ambiente prima di distribuirle nell’ambiente remoto.

    • Verificare che la versione del servizio di ricerca sia compatibile con la versione del client PHP. Consulta Configurare Elasticsearch o Configurare OpenSearch.

  • Verifica la connettività del database e l'archiviazione disponibile negli ambienti remoti-

    • Utilizzare SSH per accedere al server remoto e verificare la connessione al database MySQL. Vedi Connetti al database.

    • Verificare l'archiviazione disponibile nell'ambiente remoto. Utilizzare il comando disk free per visualizzare e gestire lo spazio su disco disponibile negli ambienti cloud. Vedere Gestione spazio su disco.

      • Controllare le dimensioni del database aggiornato e verificare che nel file services.yaml sia allocato spazio su disco sufficiente.

      • Liberare spazio su disco. Cancellare la cache e pulire le directory /log e /tmp prima della distribuzione.

  • Pianifica ed esegui un aggiornamento riuscito negli ambienti locali e di integrazione, prima di implementarlo nell'ambiente di staging-Dopo l'aggiornamento, verifica l'implementazione e risolvi eventuali problemi.

  • Unisci il codice nell'ambiente di staging, quindi nell'ambiente di produzione-verifica e risolvi eventuali problemi nell'ambiente di staging prima di inviare le modifiche all'ambiente di produzione.

  • Completare le attività post aggiornamento-

    • Utilizzare SSH per accedere al server remoto e verificare quanto segue:

      • Controlla lo stato dell’indicizzatore e reindicizza in base alle esigenze. Vedi Gestione degli indicizzatori nella Guida alla configurazione.

      • Controllare i registri cron e la tabella cron_schedule nel database di Adobe Commerce per verificare lo stato cron ed eseguire nuovamente i processi cron in base alle esigenze.
        Vedi Registrazione nella Guida alla configurazione.

    • Completa il test di accettazione utente post-aggiornamento sugli ambienti di staging e produzione e risolve eventuali problemi relativi agli aggiornamenti di estensioni di terze parti e personalizzati.

Utilizzare Upgrade Compatibility Tool

Esegui Upgrade Compatibility Tool (UCT) come parte dell’analisi pre-aggiornamento per comprendere l’ambito e l’impatto di un aggiornamento.

  • La funzione UCT confronta l’istanza corrente con una versione di Adobe Commerce di destinazione, restituendo un elenco di problemi critici, errori e avvisi che devono essere corretti prima dell’aggiornamento.
  • Utilizza --coming-version (-c) per eseguire il confronto con la versione di destinazione pianificata e --ignore-current-version-compatibility-issues per concentrarti solo sui nuovi problemi introdotti dall'aggiornamento.
  • Considera il rapporto HTML UCT come un input per l’elenco di controllo per l’aggiornamento, insieme alla compatibilità delle estensioni, alle versioni del servizio e ai controlli del database.

Per informazioni dettagliate sulla configurazione e sull’utilizzo, consulta:

Per i commercianti di Cloud che utilizzano lo strumento di analisi a livello di sito, puoi anche attivare l’UCT dalla dashboard e scaricare il rapporto HTML direttamente dal widget. Consulta Integrare lo strumento di analisi a livello di sito.

recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938