Documentation Commerce Guide de Commerce sur Cloud

Projet de mise à niveau pour utiliser le module ECE-Tools

Last update: Fri Jan 31 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Cloud

Créé pour :

Administration
Développeur

L’Adobe a abandonné les packages magento/magento-cloud-configuration et magento/ece-patches au profit du package ece-tools, ce qui simplifie de nombreux processus cloud. Si vous utilisez un ancien projet d’infrastructure Adobe Commerce on cloud qui ne contient pas le package ece-tools, vous devez effectuer une opération manuelle unique mise à niveau sur votre projet.

WARNING

Si votre projet contient le package ece-tools, vous pouvez ignorer la mise à niveau suivante. Pour vérifier, récupérez la version Commerce à l’aide de la commande php vendor/bin/ece-tools -V dans le répertoire racine de votre projet local.

Ce processus de mise à niveau du projet nécessite que vous mettiez à jour la contrainte de version magento/magento-cloud-metapackage dans le fichier composer.json du répertoire racine. Cette contrainte permet de mettre à jour Adobe Commerce sur les métapaquets d’infrastructure cloud (y compris la suppression des packages obsolètes) sans mettre à niveau votre version actuelle d’Adobe Commerce.

TIP

Avant de commencer une mise à niveau ou un processus d’application de correctifs, créez une branche active à partir de l’environnement d’intégration et extrayez la nouvelle branche sur votre station de travail locale. Dédier une branche à la mise à niveau ou au processus de correctif permet d’éviter toute interférence avec votre travail en cours.

Supprimer les packages obsolètes

Avant d’effectuer une mise à niveau pour utiliser le package ece-tools, recherchez les packages obsolètes suivants dans le fichier composer.lock :

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

Mettre à jour le métapaquet

Chaque version d’Adobe Commerce nécessite une contrainte différente basée sur les éléments suivants :

>=current_version <next_version

Par current_version, spécifiez la version d’Adobe Commerce à installer.
Par next_version, spécifiez la version de correctif suivante après la valeur spécifiée dans current_version.

Si vous souhaitez installer Adobe Commerce 2.3.5-p2, définissez current_version sur 2.3.5 et le next_version sur 2.3.6. La contrainte ">=2.3.5 <2.3.6" installe le dernier package disponible pour la version 2.3.5.

Vous pouvez toujours trouver la dernière contrainte de métapaquet dans le modèle de magento-cloud.

L’exemple suivant place une contrainte pour le métapaquet Adobe Commerce sur l’infrastructure cloud sur toute version supérieure ou égale à la version actuelle 2.4.7 et inférieure à la version suivante 2.4.8 :

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

Mettre à niveau le projet

Pour mettre à niveau votre projet afin d’utiliser le package ece-tools, vous devez mettre à jour le métapaquet et les propriétés des points d’extension .magento.app.yaml, puis effectuer une mise à jour du compositeur.

Pour mettre à niveau le projet afin d'utiliser ece-tools :

Mettez à jour la contrainte de version magento/magento-cloud-metapackage dans le fichier composer.json.

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

Mettez à jour le métapaquet .

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

Modifiez les commandes de hook dans le fichier 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

Recherchez et supprimez les packages obsolètes. Les packages obsolètes peuvent empêcher une mise à niveau réussie.

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

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

Il peut être nécessaire de mettre à jour le package ece-tools.

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

Ajoutez et validez les modifications de code. Dans cet exemple, les fichiers suivants ont été mis à jour :

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

Envoyez vos modifications de code au serveur distant et fusionnez cette branche avec la branche integration.

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

recommendation-more-help

7c2b03ac-000c-497d-aba3-2c6dc720a938