Mettre à niveau la version de Commerce

Créez une copie du fichier config.local.php et nommez-la config.php.

Ajoutez ce fichier au dossier app/etc de votre projet.

Ajoutez et validez le fichier dans votre branche.

Envoyez le fichier à votre branche d’intégration.

Passez à la procédure de mise à niveau.

Sur votre poste de travail local, modifiez le répertoire de votre projet.

Extrayez votre branche d’intégration.

Ouvrez le fichier composer.json dans un éditeur de texte.

Consultez la section autoload:psr-4 de l’implémentation du gestionnaire de modules externes Zend pour connaître la dépendance des contrôleurs.

 "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/"
    },
}

Si la dépendance Zend est manquante, mettez à jour le fichier composer.json :

• Ajoutez la ligne suivante à la section autoload:psr-4 .

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

• Mettez à jour les dépendances du projet.

  code language-bash
  composer update

• Ajout, validation et modification du code push.

  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>

• Fusionnez les modifications dans l’environnement d’évaluation, puis dans l’environnement de production.

Sur votre poste de travail local, modifiez le répertoire de votre projet.

Ouvrez et modifiez le fichier magento.app.yaml.

Mettez à jour les options PHP.

type: php:8.3

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

Modifiez les commandes hooks property build et 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

Ajoutez les variables d’environnement suivantes à la fin du fichier.

Pour Adobe Commerce 2.2.x à 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'

Pour 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'

Enregistrez le fichier. Ne validez ou n’envoyez pas encore de modifications à l’environnement distant.

Passez à la procédure de mise à niveau.

Ajoutez le allow-plugins suivant à la section config :

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

Ajoutez le module externe suivant à la section require :

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

Ajoutez le composant suivant à la section extra:component_paths :

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

Enregistrez le fichier. Ne validez ou n’envoyez pas encore de modifications à votre branche.

Passez à la procédure de mise à niveau.

Créez une sauvegarde locale de la base distante.

magento-cloud db:dump

Sauvegardez le code et le média.

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

Vous pouvez éventuellement omettre [--media] si vous disposez d’un grand nombre de fichiers statiques qui sont déjà dans le contrôle de code source.

Utilisez SSH pour vous connecter à l’environnement distant.

Créez un vidage de base de données. Pour choisir un répertoire cible pour le vidage DB, utilisez l’option --dump-directory.

vendor/bin/ece-tools db-dump

L’opération de vidage crée un fichier d’archive dump-<timestamp>.sql.gz dans votre répertoire de projet distant. Voir Sauvegarde de la base de données.

Sur votre poste de travail local, modifiez le répertoire de votre projet.

Définissez la version de mise à niveau à l’aide de la syntaxe de contrainte de version.

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

Mettez à jour le projet.

composer update

Examinez les correctifs actuellement appliqués :

• Si des correctifs sont installés dans le répertoire m2-hotfixes, envoyez un ticket d’assistance Adobe Commerce et travaillez avec l’assistance Adobe Commerce pour vérifier quels correctifs peuvent encore être appliqués à la nouvelle version. Supprimez le ou les correctifs non applicables du répertoire m2-hotfixes.

• Si des [ correctifs de qualité ] sont appliqués dans le fichier .magento.env.yaml, vérifiez s’ils peuvent toujours être appliqués à la nouvelle version. Supprimez le ou les correctifs non applicables de la section QUALITY_PATCHES du fichier .magento.env.yaml.

Méthode 1 : Vérifiez les versions applicables dans les notes de mise à jour des correctifs de qualité

Méthode 2 : afficher les correctifs disponibles et l’état

Méthode 3 : Recherche de correctifs

Ajout, validation et modification du code push.

git add -A

git commit -m "Upgrade"

git push origin <branch-name>

git add -A est nécessaire pour ajouter tous les fichiers modifiés au contrôle de code source en raison de la manière dont le compositeur d’expérience associe les packages de base. composer install et composer update stockent les fichiers du package de base (magento/magento2-base et magento/magento2-ee-base) dans la racine du package.

Les fichiers marshals du compositeur appartiennent à la nouvelle version d’Adobe Commerce, pour remplacer la version obsolète de ces mêmes fichiers. Actuellement, la mise en grappe est désactivée dans Adobe Commerce. Vous devez donc ajouter les fichiers mis en grappe au contrôle source.

Attendez que le déploiement soit terminé.

Vérifiez la mise à niveau dans votre environnement d’intégration, d’évaluation ou de production en utilisant SSH pour vous connecter et vérifier la version.

php bin/magento --version

Depuis le terminal, utilisez une commande SSH pour générer le fichier /app/etc/config.php pour l’environnement.

ssh <SSH-URL> "<Command>"

Par exemple, pour Pro, exécutez scd-dump sur la branche integration :

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

Transférez le fichier config.php vers vos postes de travail locaux à l’aide de rsync ou scp. Vous pouvez uniquement ajouter ce fichier à la branche localement.

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

Ajout, validation et modification du code push.

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

Cela génère un fichier /app/etc/config.php mis à jour avec une liste de modules et des paramètres de configuration.

Créez une branche sur votre poste de travail local.

Désactivez vos extensions selon vos besoins.

Lorsque disponible, téléchargez les mises à niveau d’extension.

Installez la mise à niveau comme indiqué dans la documentation tierce.

Activez et testez l’extension .

Ajoutez, validez et poussez les modifications de code sur la télécommande.

Poussez vers et testez dans votre environnement d’intégration.

Poussez vers l’environnement d’évaluation pour effectuer un test dans un environnement de pré-production.

Sur votre poste de travail local, modifiez le répertoire de votre projet.

Utilisez SSH pour vous connecter à l’environnement distant.

magento-cloud ssh

Ouvrez le fichier ./app/var/report/<error number>.

Examinez les journaux et déterminez la source du problème.

Ajout, validation et modification du code push.

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