Aggiorna versione Commerce

Creare una copia del file config.local.php e denominarlo config.php.

Aggiungi il file alla cartella app/etc del progetto.

Aggiungi e invia il file al tuo ramo.

Invia il file al ramo di integrazione.

Continuare con il processo di aggiornamento.

Sulla workstation locale, passa alla directory del progetto.

Consulta il ramo dell’integrazione.

Aprire il file composer.json in un editor di testo.

Controllare la sezione autoload:psr-4 per l'implementazione del gestore del plug-in Zend per la dipendenza dei controller.

 "autoload": {
    "psr-4": {
       "Magento\\Framework\\": "lib/internal/Magento/Framework/",
       "Magento\\Setup\\": "setup/src/Magento/Setup/",
       "Magento\\": "app/code/Magento/",
       "Zend\\Mvc\\Controller\\": "setup/src/Zend/Mvc/Controller/"
    },
}

Se manca la dipendenza Zend, aggiornare il file composer.json:

• Aggiungere la riga seguente alla sezione autoload:psr-4.

  code language-json
  "Zend\\Mvc\\Controller\\": "setup/src/Zend/Mvc/Controller/"

• Aggiornare le dipendenze del progetto.

  code language-bash
  composer update

• Aggiungi, conferma e invia modifiche al codice.

  code language-bash
  git add -A

  code language-bash
  git commit -m "Add Zend plugin manager implementation for controllers dependency for Laminas support"

  code language-bash
  git push origin <branch-name>

• Unisci le modifiche apportate all’ambiente di staging e quindi a Produzione.

Sulla workstation locale, passa alla directory del progetto.

Aprire e modificare il file magento.app.yaml.

Aggiornare le opzioni PHP.

type: php:8.3

build:
    flavor: none
dependencies:
    php:
        composer/composer: '2.7.2'

Modificare la proprietà hooks build e i comandi deploy.

hooks:
    # We run build hooks before your application has been packaged.
    build: |
        set -e
        composer install
        php ./vendor/bin/ece-tools run scenario/build/generate.xml
        php ./vendor/bin/ece-tools run scenario/build/transfer.xml
    # We run deploy hook after your application has been deployed and started.
    deploy: |
        php ./vendor/bin/ece-tools run scenario/deploy.xml
    # We run post deploy hook to clean and warm the cache. Available with ECE-Tools 2002.0.10.
    post_deploy: |
        php ./vendor/bin/ece-tools run scenario/post-deploy.xml

Aggiungi le seguenti variabili di ambiente alla fine del file.

Per Adobe Commerce da 2.2.x a 2.3.x-

variables:
    env:
        CONFIG__DEFAULT__PAYPAL_ONBOARDING__MIDDLEMAN_DOMAIN: 'payment-broker.magento.com'
        CONFIG__STORES__DEFAULT__PAYMENT__BRAINTREE__CHANNEL: 'Magento_Enterprise_Cloud_BT'
        CONFIG__STORES__DEFAULT__PAYPAL__NOTATION_CODE: 'Magento_Enterprise_Cloud'

Per Adobe Commerce 2.4.x-

variables:
    env:
        CONFIG__DEFAULT__PAYPAL_ONBOARDING__MIDDLEMAN_DOMAIN: 'payment-broker.magento.com'
        CONFIG__STORES__DEFAULT__PAYPAL__NOTATION_CODE: 'Magento_Enterprise_Cloud'

Salva il file. Non eseguire ancora il commit o il push delle modifiche nell'ambiente remoto.

Continuare con il processo di aggiornamento.

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 la versione di aggiornamento utilizzando la sintassi version constraint.

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

Aggiorna il 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.

Attendere il completamento della distribuzione.

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

php bin/magento --version

Dal terminale, utilizzare un comando SSH per generare il file /app/etc/config.php per l'ambiente.

ssh <SSH-URL> "<Command>"

Ad esempio, per Pro, per eseguire scd-dump sul ramo integration:

ssh <project-id-integration>@ssh.us.magentosite.cloud "php vendor/bin/ece-tools config:dump"

Trasferire il file config.php nelle workstation locali utilizzando rsync o scp. Puoi aggiungere questo file al ramo solo localmente.

rsync <SSH-URL>:app/etc/config.php ./app/etc/config.php

Aggiungi, conferma e invia modifiche al codice.

git add app/etc/config.php && git commit -m "Add system-specific configuration" && git push origin master

Viene generato un file /app/etc/config.php aggiornato con un elenco di moduli e impostazioni di configurazione.

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.

Effettua il push all’ambiente di staging per il test in un ambiente di pre-produzione.

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>