Best practice di implementazione

Piani iniziali: per l'ambiente di integrazione, ogni ramo attivo crea e distribuisce in un ambiente completo per l'accesso e il testing. Verifica completa del codice dopo l'unione al ramo staging. Per avviare il sito, invia staging a master per la distribuzione nell'ambiente di produzione. Si dispone dell'accesso completo a tutti i rami tramite Cloud Console e i comandi CLI.

Pro plans: per l'ambiente di integrazione, ogni ramo attivo crea e distribuisce in un ambiente completo per l'accesso e il testing. Unisci il codice al ramo integration prima di unire negli ambienti di staging e produzione. È possibile eseguire l'unione negli ambienti di staging e produzione utilizzando Cloud Console o i comandi SSH e CLI magento-cloud.

Assicurarsi di eseguire la versione più recente del pacchetto ece-tools

Consulta le note sulla versione per ECE-Tools.

Segui il processo di compilazione e distribuzione

Assicurati di disporre del codice corretto in ogni ambiente per evitare la sovrascrittura delle configurazioni durante l’unione del codice tra ambienti. Ad esempio, per applicare le modifiche alla configurazione a tutti gli ambienti, modifica e verifica le modifiche nell’ambiente locale prima di distribuirle nell’ambiente di integrazione remota. Quindi, distribuisci e verifica le modifiche nell’ambiente di staging prima di implementarle nell’ambiente di produzione. Quando si esegue l’unione da un ambiente all’altro, la distribuzione sovrascrive tutto il codice dell’ambiente, ad eccezione della configurazione e delle impostazioni specifiche dell’ambiente.

Utilizza le stesse variabili in ambienti diversi

I valori di queste variabili possono variare tra gli ambienti; tuttavia, in genere sono necessarie le stesse variabili in ogni ambiente. Consulta Gestione della configurazione per le impostazioni dell'archivio.

Mantenere sensibili i valori di configurazione e i dati nelle variabili specifiche dell'ambiente

Questi valori includono le variabili specificate mediante Cloud CLI, Cloud Console o aggiunte al file env.php. Vedi Livelli variabili.

Verifica che tutto il codice sia disponibile nel ramo dell'ambiente

Il riferimento al codice da altri rami, ad esempio un ramo privato, può causare problemi durante il processo di compilazione e distribuzione. Ad esempio, se fai riferimento a un tema da un ramo privato, il tema non è accessibile e non può essere generato con il codice dell’applicazione.

Aggiungere estensioni, integrazioni e codice nei rami iterati

Apportare ed eseguire il test delle modifiche in locale, inviare il push a integration, quindi a staging e production. Verifica e risolvi i problemi in ogni ambiente prima di unire gli aggiornamenti all’ambiente successivo. Alcune estensioni e integrazioni devono essere abilitate e configurate in un ordine specifico a causa delle dipendenze. L’aggiunta e il testing in gruppi possono semplificare notevolmente il processo di generazione e distribuzione e aiutare a determinare dove si verificano i problemi.

Verificare le versioni e le relazioni del servizio e la possibilità di connettersi

Verifica i servizi disponibili per l’applicazione e assicurati di utilizzare la versione più recente e compatibile. Per le versioni consigliate, vedere Relazioni di servizio e Requisiti di sistema nella Guida all'installazione.

Eseguire il test in locale e nell'ambiente di integrazione prima di distribuire in staging e produzione

Identifica e correggi i problemi negli ambienti locali e di integrazione per evitare tempi di inattività prolungati durante l’implementazione negli ambienti di staging e produzione.

Dopo aver completato il test negli ambienti locali e di integrazione, distribuire e testare nell'ambiente di staging

Consulta Test di staging e produzione.

Verifica la configurazione dell'ambiente di produzione

Prima di implementare in produzione, completa le seguenti attività:

• Assicurati di poter connettersi a tutti e tre i nodi nell'ambiente di produzione utilizzando SSH.

• Verificare che gli indicizzatori siano impostati su Aggiorna secondo pianificazione. Consulta Modalità di indicizzazione nella Guida per gli sviluppatori dell'estensione.

• Prepara l’ambiente aggiornando eventuali variabili specifiche dell’ambiente nel codice di produzione, verificando la disponibilità e la compatibilità del servizio ed apportando eventuali altre modifiche di configurazione richieste.

Monitorare il processo di distribuzione

Rivedi i messaggi di stato della distribuzione e attenua i problemi, se necessario. Controlla i registri cloud per visualizzare i messaggi di registro dettagliati.

Se Adobe Commerce è non installato, viene installato con bin/magento setup:install, aggiorna la configurazione di distribuzione, app/etc/env.php e il database per l'ambiente specificato, ad esempio Redis e gli URL del sito Web. Importante: Quando hai completato la Prima distribuzione durante l'installazione, Adobe Commerce è stato installato e distribuito in tutti gli ambienti.

Se Adobe Commerce è installato, eseguire gli aggiornamenti necessari. Lo script di distribuzione esegue bin/magento setup:upgrade per aggiornare lo schema e i dati del database (necessario dopo gli aggiornamenti dell'estensione o del codice di base) e aggiorna anche la configurazione di distribuzione, app/etc/env.php e il database per l'ambiente. Infine, lo script di distribuzione cancella la cache di Adobe Commerce.

Lo script genera facoltativamente contenuto Web statico utilizzando il comando magento setup:static-content:deploy.

Utilizza gli ambiti (-s flag negli script di compilazione) con impostazione predefinita quick per la strategia di distribuzione del contenuto statico. È possibile personalizzare la strategia utilizzando la variabile di ambiente SCD_STRATEGY. Per informazioni dettagliate su queste opzioni e funzionalità, vedere Strategie di distribuzione file statici e il flag -s per Distribuire file di visualizzazione statici.