DocumentationCommerceGuide de Commerce sur Cloud

Restaurer un environnement

Last update: Fri Jan 31 2025 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, ou si vous souhaitez réinitialiser l’environnement à zéro, vous pouvez restaurer/réinitialiser 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éinitialiser manuellement la base de données
TIP
Pour obtenir de l’aide sur les déploiements bloqués, utilisez l’utilitaire de dépannage de déploiement Adobe Commerce dans le Centre d’aide de Commerce.

Réinitialiser la branche Git

La réinitialisation de votre branche Git rétablit le code à un état stable dans le passé.

Pour réinitialiser la branche :

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

  2. Consultez l’historique de validation Git. Utilisez --oneline pour afficher des 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 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 de réinitialisation matérielle pour réinitialiser votre branche. Veillez à utiliser 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 rétablit l’état d’origine de votre environnement en restaurant la base de données, en supprimant la configuration de déploiement et en effaçant les sous-répertoires var/. Ces conseils réinitialisent é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éinitialiser la branche Git

La désinstallation du logiciel Adobe Commerce interrompt 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 des configurations 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 station de travail locale, accédez au répertoire du 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 qu’Adobe Commerce a bien été désinstallé.

    Le message suivant s’affiche pour confirmer la réussite de 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
Il est également recommandé de nettoyer les caches.
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 tenter 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 se terminer, vous pouvez réinitialiser manuellement la base de données.

Pour réinitialiser la base de données :

  1. Sur votre station de travail locale, accédez au répertoire du 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, au cours duquel l’application Commerce est en mode de maintenance. Pour un environnement de production, Adobe recommande d’effectuer ce travail en dehors des heures de pointe afin d’éviter toute interruption de service.
recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938