Documentazione Commerce Guida di Commerce su infrastruttura Cloud

Aggiornamento del progetto per l’utilizzo del pacchetto ECE-Tools

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Cloud

Creato per:

Amministratore
Sviluppatore

L'Adobe ha dichiarato obsoleti i pacchetti magento/magento-cloud-configuration e magento/ece-patches a favore del pacchetto ece-tools, semplificando così molti processi cloud. Se utilizzi un progetto Adobe Commerce on Cloud Infrastructure precedente che non contiene il pacchetto ece-tools, devi eseguire un processo aggiornamento manuale e una tantum al tuo progetto.

WARNING

Se il progetto contiene il pacchetto ece-tools, è possibile saltare il seguente aggiornamento. Per verificare il problema, recuperare la versione Commerce utilizzando il comando php vendor/bin/ece-tools -V nella directory principale del progetto locale.

Questo processo di aggiornamento del progetto richiede l'aggiornamento del vincolo di versione magento/magento-cloud-metapackage nel file composer.json nella directory radice. Questo vincolo consente di aggiornare i metapacchetti per l’infrastruttura cloud di Adobe Commerce, inclusa la rimozione dei pacchetti obsoleti, senza dover aggiornare la versione Adobe Commerce corrente.

TIP

Prima di iniziare un aggiornamento o un processo di applicazione di patch, crea un ramo attivo dall’ambiente di integrazione ed estrai il nuovo ramo sulla workstation locale. La destinazione di un ramo all’aggiornamento o al processo di patch consente di evitare interferenze con il lavoro in corso.

Rimuovi pacchetti obsoleti

Prima di eseguire un aggiornamento per utilizzare il pacchetto ece-tools, controllare il file composer.lock per i seguenti pacchetti obsoleti:

magento/magento-cloud-configuration
magento/ece-patches

Aggiornare il metapacchetto

Ogni versione di Adobe Commerce richiede un vincolo diverso in base ai seguenti elementi:

>=current_version <next_version

Per current_version, specificare la versione di Adobe Commerce da installare.
Per next_version, specificare la versione successiva della patch dopo il valore specificato in current_version.

Per installare Adobe Commerce 2.3.5-p2, impostare current_version su 2.3.5 e next_version su 2.3.6. Il vincolo ">=2.3.5 <2.3.6" installa l'ultimo pacchetto disponibile per la versione 2.3.5.

È sempre possibile trovare il vincolo di metapackage più recente nel modello magento-cloud.

Nell’esempio seguente viene impostato un vincolo per il metapackage di Adobe Commerce on cloud infrastructure su qualsiasi versione maggiore o uguale alla versione corrente 2.4.7 e minore della versione successiva 2.4.8:

"require": {
    "magento/magento-cloud-metapackage": ">=2.4.7 <2.4.8"
},

Aggiornare il progetto

Per aggiornare il progetto in modo da utilizzare il pacchetto ece-tools, è necessario aggiornare il metapackage e le proprietà degli hook .magento.app.yaml ed eseguire un aggiornamento del Compositore.

Per aggiornare il progetto in modo da utilizzare gli strumenti ece:

Aggiornare il vincolo di versione magento/magento-cloud-metapackage nel file composer.json.

code language-bash
`composer require "magento/magento-cloud-metapackage":">=2.4.7 <2.4.8" --no-update`

Aggiorna il metapacchetto.

code language-bash
`composer update magento/magento-cloud-metapackage`

Modificare i comandi hook nel file magento.app.yaml.

code language-yaml

code language-yaml
hooks: # We run build hooks before your application has been packaged. build: \| set -e 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

hooks:
    # We run build hooks before your application has been packaged.
    build: |
        set -e
        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

Controllare e rimuovere i pacchetti obsoleti. I pacchetti obsoleti possono impedire un aggiornamento corretto.

code language-bash
`composer remove magento/magento-cloud-configuration`

code language-bash
`composer remove magento/ece-patches`

Potrebbe essere necessario aggiornare il pacchetto ece-tools.

code language-bash
`composer update magento/ece-tools`

Aggiungi e conferma le modifiche al codice. In questo esempio sono stati aggiornati i seguenti file:

code language-none
`.magento.app.yaml composer.json composer.lock`

Invia le modifiche al codice al server remoto e unisci il ramo con il ramo integration.

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

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26