Mettre à niveau le projet pour utiliser le package CEE-Outils

Adobe obsolète magento/magento-cloud-configuration et magento/ece-patches les modules en faveur de ece-tools qui simplifie de nombreux processus cloud. Si vous utilisez un projet d’infrastructure de cloud Adobe Commerce plus ancien qui : not contain the ece-tools module, puis vous devez effectuer une opération manuelle ponctuelle upgrade processus de votre projet.

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

Ce processus de mise à niveau de projet nécessite que vous mettiez à jour la variable magento/magento-cloud-metapackage contrainte de version dans la variable composer.json dans le répertoire racine. Cette contrainte active les mises à jour d’Adobe Commerce sur les modules d’infrastructure cloud (notamment la suppression des modules obsolètes) sans mettre à niveau votre version Adobe Commerce actuelle.

TIP
Avant de commencer une mise à niveau ou un processus de correction, créez une branche active à partir de l’environnement d’intégration et extrayez la nouvelle branche vers votre poste de travail local. Le fait de dédier une branche à la mise à niveau ou au processus de correctif permet d’éviter toute interférence avec votre travail en cours.

Suppression de modules obsolètes

Avant d’effectuer une mise à niveau pour utiliser la variable ece-tools , vérifiez la variable composer.lock pour les modules obsolètes suivants :

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

Mettre à jour le métappackage

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

>=current_version <next_version
  • Pour current_version, spécifiez la version Adobe Commerce à installer.
  • Pour 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éfinit current_version to 2.3.5 et la variable next_version to 2.3.6. 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étapackage dans la variable magento-cloud modèle.

L’exemple suivant place une contrainte pour Adobe Commerce sur le métappackage d’infrastructure cloud à toute version supérieure ou égale à la version actuelle 2.4.5 et inférieure à la version suivante 2.4.6 :

"require": {
    "magento/magento-cloud-metapackage": ">=2.4.5 <2.4.6"
},

Mettre à niveau le projet

Pour mettre à niveau votre projet afin d’utiliser la variable ece-tools , vous devez mettre à jour le métappackage et la variable .magento.app.yaml Hooks les propriétés et effectuez une mise à jour du compositeur.

Pour mettre à niveau un projet afin d’utiliser des outils de texte:

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

    code language-bash
    composer require "magento/magento-cloud-metapackage":">=2.4.5 <2.4.6" --no-update
    
  2. Mettez à jour le métapaquet.

    code language-bash
    composer update magento/magento-cloud-metapackage
    
  3. Modifiez les commandes du point d’extension dans le magento.app.yaml fichier .

    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
    
  4. Recherchez et supprimez le modules 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
    
  5. Il peut être nécessaire de mettre à jour le ece-tools module.

    code language-bash
    composer update magento/ece-tools
    
  6. Ajoutez et validez les modifications du code. Dans cet exemple, les fichiers suivants ont été mis à jour :

    code language-terminal
    .magento.app.yaml
    composer.json
    composer.lock
    
  7. Poussez vos modifications de code sur le serveur distant et fusionnez cette branche avec le integration branche.

    code language-bash
    git push origin <branch-name>
    
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26