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:buildper 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 freeper 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.yamlsia allocato spazio su disco sufficiente. -
Liberare spazio su disco. Cancellare la cache e pulire le directory
/loge/tmpprima 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
crone la tabellacron_schedulenel 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-issuesper 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.