Aggiorna versione Commerce

Per installare o aggiornare servizi solo negli ambienti Staging e Production, invia un ticket di supporto Adobe Commerce.

Nel ticket, specifica le modifiche del servizio richieste, includi i file aggiornati .magento.app.yaml e .magento/services.yaml e annota la versione PHP di destinazione.

La versione PHP, gli aggiornamenti del Compositore, le estensioni e le impostazioni di ambiente sono modifiche self-service. Adobe potrebbe dover aggiornare l’agente New Relic per garantire la compatibilità della versione PHP. Vedi Impostazioni PHP in Configurazione applicazione.

Confermare la pianificazione dell’aggiornamento tramite il processo in due parti di Adobe: confermare prima la data e l’ora richieste, quindi inviarle al team dell’infrastruttura per la conferma finale.

I cambiamenti di produzione (solo Pro) richiedono un preavviso di almeno due giorni lavorativi, esclusi i fine settimana. Ad esempio, il team di Cloud Infrastructure deve riconoscere un aggiornamento del lunedì entro il mercoledì precedente. Prevedere un lead time aggiuntivo durante il picco della domanda. Per evitare ritardi, rispondi alla richiesta iniziale almeno 48 ore prima della finestra. L’aggiornamento non viene considerato pianificato fino a quando non ricevi una conferma finale.

Convalidare l’aggiornamento in un ambiente di staging o integrazione prima di pianificarlo in produzione.

I problemi causati dai moduli di terze parti, dal codice personalizzato o dalla compatibilità delle dipendenze spesso emergono durante la ridistribuzione che segue un aggiornamento del servizio. Per convalidare più aggiornamenti di servizio uno alla volta, un ordine ragionevole è Valkey o Redis, quindi RabbitMQ, OpenSearch, quindi MariaDB. Questa non è una sequenza obbligatoria. Gli aggiornamenti del database hanno il massimo impatto operativo e meritano la massima cautela.

Adobe non garantisce in anticipo la durata esatta di una finestra di manutenzione di produzione, poiché la tempistica dipende dall’ambiente e dai servizi coinvolti. Utilizza il tempo impiegato dall’aggiornamento di staging come stima pratica durante la pianificazione della finestra Produzione.

Ridistribuisci l’ambiente dopo che Adobe ha completato l’aggiornamento del servizio in modo che la modifica abbia effetto, anche se la versione dell’applicazione Adobe Commerce non cambia.

Se l’aggiornamento include OpenSearch, pianificare anche una reindicizzazione completa. Adobe non può garantire tempi di inattività pari a zero per un aggiornamento del servizio, pertanto pianifica una finestra di manutenzione che consenta di ridistribuire il tempo, reindicizzare se necessario e convalidare la vetrina e l’amministratore prima di riaprire il sito.

Aggiungi allow-plugins alla sezione config:

"config": {
   "allow-plugins": {
      "dealerdirect/phpcodesniffer-composer-installer": true,
      "laminas/laminas-dependency-plugin": true,
      "magento/*": true
   }
},

Aggiungi il seguente plug-in alla sezione require:

"require": {
    "magento/composer-root-update-plugin": "^2.0.3"
},

Aggiungi il seguente componente alla sezione extra:component_paths:

"extra": {
   "component_paths": {
      "tinymce/tinymce": "lib/web/tiny_mce_5"
   },
},

Salva il file. Non eseguire ancora il commit o il push delle modifiche nel ramo.

Continuare con il processo di aggiornamento.

Creare un backup locale del database remoto.

magento-cloud db:dump

Eseguire il backup del codice e dei supporti.

php bin/magento setup:backup --code [--media]

Se si desidera, è possibile omettere [--media] se il numero di file statici che si trovano già nel controllo del codice sorgente è elevato.

Utilizza SSH per accedere all’ambiente remoto.

Crea un dump del database 🔗. Per scegliere una directory di destinazione per il dump del database, utilizzare l’opzione --dump-directory.

vendor/bin/ece-tools db-dump

L’operazione di dump crea un file di archivio dump-<timestamp>.sql.gz nella directory di progetto remota. Vedere Backup del database.

Sulla workstation locale, passa alla directory del progetto.

Impostare il vincolo di versione 🔗 per la versione di aggiornamento di destinazione. Questo passaggio è necessario solo se la versione di destinazione non rientra nel vincolo esistente.

composer require-commerce "magento/magento-cloud-metapackage":">=CURRENT_VERSION <NEXT_VERSION" --no-update

Aggiorna il file composer.json con la versione di aggiornamento di base di Commerce.

composer require-commerce magento/product-enterprise-edition 2.4.8 --no-update

Se utilizzi B2B, aggiorna il file composer.json con la versione supportata per Commerce.

composer require-commerce magento/extension-b2b 1.5.2 --no-update

Aggiornare le dipendenze del progetto.

composer update

Esaminare le patch attualmente applicate:

• Se nella directory m2-hotfixes sono installate patch, invia un ticket di supporto Adobe Commerce e collabora con il supporto Adobe Commerce per verificare quali patch possono ancora essere applicate alla nuova versione. Rimuovere le patch non applicabili dalla directory m2-hotfixes.

• Se nel file .magento.env.yaml sono state applicate [patch di qualità], verificare se è ancora possibile applicarle alla nuova versione. Rimuovere le patch non applicabili dalla sezione QUALITY_PATCHES del file .magento.env.yaml.

Metodo 1: Verificare le versioni applicabili nelle note sulla versione delle patch di qualità

Metodo 2: Visualizzare le patch e lo stato disponibili

Metodo 3: Cerca patch

Aggiungi, conferma e invia modifiche al codice.

git add -A

git commit -m "Upgrade"

git push origin <branch-name>

git add -A è necessario per aggiungere tutti i file modificati al controllo del codice sorgente a causa del modo in cui i pacchetti di base di Marshals Composer vengono eseguiti. Entrambi i file di marshalling composer install e composer update dal pacchetto di base (magento/magento2-base e magento/magento2-ee-base) nella radice del pacchetto.

I file che Composer marshalling appartengono alla nuova versione di Adobe Commerce, per sovrascrivere la versione obsoleta degli stessi file. Attualmente, il marshalling è disabilitato in Adobe Commerce, pertanto è necessario aggiungere i file marshallati al controllo del codice sorgente.

Per completare l’aggiornamento, attendi la distribuzione.

Verifica l’aggiornamento nell’ambiente di integrazione, staging o produzione utilizzando SSH per accedere e controllare la versione.

php bin/magento --version

Crea una filiale sulla workstation locale.

Disattiva le estensioni in base alle esigenze.

Se disponibile, scarica gli aggiornamenti dell’estensione.

Installa l’aggiornamento come descritto nella documentazione di terze parti.

Abilita e verifica l’estensione.

Aggiungi, esegui il commit e invia le modifiche al codice in remoto.

Effettua il push e il test nell’ambiente di integrazione.

Per eseguire il test in un ambiente di pre-produzione, invia all’ambiente di staging.

Sulla workstation locale, passa alla directory del progetto.

Utilizza SSH per accedere all’ambiente remoto.

magento-cloud ssh

Aprire il file ./app/var/report/<error number>.

Esaminare i registri e determinare l’origine del problema.

Aggiungi, conferma e invia modifiche al codice.

git add -A && git commit -m "Fixed deployment failure" && git push origin <branch-name>