DocumentationCommerceGuide de Commerce sur les infrastructures cloud

Restaurer un environnement

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Développeur

Si vous rencontrez des problèmes dans l’environnement d’intégration et que vous ne disposez pas d’une sauvegarde valide, essayez de restaurer votre environnement à l’aide de l’une des méthodes suivantes :

  • Réinitialiser ou rétablir le code dans la branche Git
  • Désinstallation de l’application Commerce
  • Forcer un redéploiement
  • Réinitialisation manuelle de la base de données
TIP
Pour obtenir de l’aide sur les déploiements bloqués, utilisez l’outil de dépannage du déploiement Adobe Commerce dans le Centre d’aide de Commerce.

Réinitialisation de la branche Git

La réinitialisation de votre branche Git rétablit l’état stable du code par le passé.

Pour réinitialiser votre branche :

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

  2. Examinez l’historique de validation Git. Utilisez --oneline pour afficher les validations abrégées sur une ligne :

    code language-bash 
    git log --oneline

    Exemple de réponse :

    code language-none 
    6bf9f45 (HEAD -> master, magento/master, magento/develop, magento/HEAD, develop) Create composer.lock
34d7434 2.4.6 upgrade
b69803c Update composer.lock
c1bca24 Add sample data
ec604c3 Update magento/ece-tools
...

  3. Choisissez un hachage de validation qui représente le dernier état stable connu de votre code.

    Pour réinitialiser votre branche à son état initialisé d’origine, recherchez la première validation qui a créé votre branche. Vous pouvez utiliser --reverse pour afficher l’historique dans l’ordre chronologique inverse.

  4. Utilisez l’option hard reset pour réinitialiser votre branche. Faites attention en utilisant cette commande, car elle ignore toutes les modifications depuis la validation choisie.

    code language-bash 
    git reset --hard <commit>

  5. Envoyez vos modifications pour déclencher un redéploiement qui réinstalle Adobe Commerce.

    code language-bash 
    git push --force <origin> <branch>

Désinstallation de Commerce

La désinstallation de l’application Commerce renvoie votre environnement à l’état d’origine en restaurant la base de données, en supprimant la configuration de déploiement et en effaçant les sous-répertoires var/. Cette directive réinitialise également votre branche git à un état stable antérieur. Si vous ne disposez pas d’une sauvegarde récente, mais que vous pouvez accéder à l’environnement distant à l’aide de SSH, procédez comme suit pour restaurer votre environnement :

  • Désactivation de la gestion de la configuration
  • Désinstallation d’Adobe Commerce
  • Réinitialisation de la branche git

La désinstallation du logiciel Adobe Commerce supprime et restaure la base de données, supprime la configuration de déploiement et efface les sous-répertoires var/. Il est important de désactiver la gestion de la configuration afin qu’elle n’applique pas automatiquement les paramètres de configuration précédents lors du prochain déploiement. Assurez-vous que votre répertoire app/etc/ ne contient pas le fichier config.php.

Pour désinstaller le logiciel Adobe Commerce :

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

  2. Utilisez SSH pour vous connecter à l’environnement distant.

    code language-bash 
    magento-cloud ssh

  3. Supprimez le fichier de configuration.

    • Pour Adobe Commerce 2.2 et versions ultérieures :

      code language-bash 
      rm app/etc/config.php

    • Pour Adobe Commerce 2.1 :

      code language-bash 
      rm app/etc/config.local.php

  4. Désinstallez l’application Adobe Commerce.

    code language-bash 
    php bin/magento setup:uninstall -n

  5. Vérifiez que Adobe Commerce a bien été désinstallé.

    Le message suivant s’affiche pour confirmer la désinstallation :

    code language-none 
    [SUCCESS]: Magento uninstallation complete.

  6. Effacez les sous-répertoires var/.

    code language-bash 
    rm -rf var/*

  7. Déconnectez-vous.

TIP
En option, il est recommandé de nettoyer les caches de version.
code language-bash 
magento-cloud project:clear-build-cache

Forcer un redéploiement

Si vous avez tenté de désinstaller Adobe Commerce et que votre déploiement continue d’échouer, vous pouvez essayer de forcer manuellement un redéploiement.

git commit --allow-empty -m "<message>" && git push <origin> <branch>

Réinitialiser la base de données

Si vous avez tenté de désinstaller Adobe Commerce et que la commande a échoué ou n’a pas pu être effectuée, vous pouvez réinitialiser manuellement la base de données.

Pour réinitialiser la base de données :

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

  2. Utilisez SSH pour vous connecter à l’environnement distant.

    code language-bash 
    magento-cloud ssh

  3. Connexion à la base de données.

    code language-bash 
    mysql -h database.internal

  4. Déposez la base de données main.

    code language-shell 
    drop database main;

  5. Créez une base de données main vide.

    code language-shell 
    create database main;

  6. Supprimez les fichiers de configuration suivants.

    • config.php
    • config.php.bak
    • env.php
    • env.php.bak

  7. Déconnectez-vous et déclenchez un redéploiement.

    code language-bash 
    magento-cloud environment:redeploy
WARNING
Le processus de déploiement commence lorsque vous effectuez une fusion, une notification push ou une synchronisation de votre environnement, ou lorsque vous déclenchez un redéploiement manuel, pendant lequel l’application Commerce est en mode de maintenance. Pour un environnement de production, Adobe recommande d’effectuer ce travail aux heures creuses afin d’éviter les interruptions de service.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26