Mettre à niveau la version de Commerce

Créez une copie config.local.php fichier et nommez-le 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.

Poursuivez le processus de mise à niveau.

Sur votre station de travail locale, accédez au répertoire du projet.

Consultez votre branche d’intégration.

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

Consultez la section autoload:psr-4 pour la mise en œuvre du gestionnaire de plug-ins Zend pour 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 modifications de 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 apportées à l’environnement d’évaluation, puis à la production.

Sur votre station de travail locale, accédez au répertoire du 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 build de propriété hooks et les commandes 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 pas et n’envoyez pas encore les modifications à l’environnement distant.

Poursuivez le processus de mise à niveau.

Ajoutez les allow-plugins suivantes à 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 pas et n’envoyez pas encore de modifications à votre branche.

Poursuivez le processus 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 se trouvent déjà dans le contrôle de code source.

Utilisez SSH pour vous connecter à l’environnement distant.

Créez une image mémoire de la base de données. Pour choisir un répertoire cible pour l’image mémoire de la base de données, 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 station de travail locale, accédez au répertoire du 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 contactez l’assistance Adobe Commerce pour vérifier quels correctifs peuvent toujours ê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 : affichage des correctifs et de l’état disponibles

Méthode 3 : Rechercher des correctifs

Ajout, validation et modifications de 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 marshale les packages de base. composer install et composer update marshalent les fichiers du package de base (magento/magento2-base et magento/magento2-ee-base) dans la racine du package.

Les fichiers que le compositeur marshale appartiennent à la nouvelle version d’Adobe Commerce, afin de remplacer la version obsolète de ces mêmes fichiers. Actuellement, le marshalling est désactivé dans Adobe Commerce, vous devez donc ajouter les fichiers marshalés au contrôle de code source.

Attendez la fin du déploiement.

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

php bin/magento --version

À partir du 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, pour exécuter le 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 stations de travail locales à 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 modifications de 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 station de travail locale.

Désactivez vos extensions selon vos besoins.

Lorsqu’elles sont disponibles, 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 envoyez les modifications de code à la télécommande.

Envoyez et testez dans votre environnement d’intégration.

Push vers l’environnement d’évaluation pour effectuer des tests dans un environnement de pré-production.

Sur votre station de travail locale, accédez au répertoire du 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 modifications de code push.

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