DocumentationCommerceCommerce KB

Restauration de l’environnement sans instantané du cloud

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Cet article présente deux solutions pour restaurer un environnement sans avoir un instantané de votre environnement sur Adobe Commerce sur l’infrastructure cloud.

Produits et versions concernés

Choisissez la méthode la plus adaptée à votre cas :

Scénario 1 : aucun instantané, version stable (connexion SSH disponible) scen2

Cette section explique comment restaurer un environnement lorsque vous n’avez pas créé d’instantané, mais que vous pouvez accéder à l’environnement via SSH.

Les étapes sont les suivantes :

  1. Désactivez la gestion de la configuration.
  2. Désinstallez le logiciel Adobe Commerce.
  3. Réinitialisez la branche git.

Après avoir effectué les étapes suivantes :

  • votre installation Adobe Commerce retourne à son état Vanilla (base de données restaurée ; configuration de déploiement supprimée ; répertoires supprimés sous var effacés)
  • votre branche git est réinitialisée à l’état souhaité dans le passé.

Lisez les étapes détaillées ci-dessous :

Étape 0 (condition préalable requise) : supprimez config.php pour désactiver Configuration Management disable_config_management

Nous devons désactiver Configuration Management afin qu’elle n’applique pas automatiquement les paramètres de configuration précédents lors du déploiement.

Pour désactiver Configuration Management, assurez-vous que votre répertoire /app/etc/ ne contient pas les fichiers config.php (pour Adobe Commerce 2.4.x) ou config.local.php (pour Adobe Commerce 2.1.x).

Pour supprimer le fichier de configuration, procédez comme suit :

  1. SSH à votre environnement.

  2. Supprimez le fichier de configuration :

    • Pour Adobe Commerce 2.4 :
    code language-php 
     rm app/etc/config.php
    • Pour Adobe Commerce 2.1 :
    code language-php 
      rm app/etc/config.local.php

Pour en savoir plus sur Configuration Management, consultez les sections suivantes :

Étape 1 : désinstallation du logiciel Adobe Commerce avec la commande setup:uninstall setup-uninstall

La désinstallation du logiciel Adobe Commerce supprime et restaure la base de données, supprime la configuration de déploiement et efface les répertoires sous var.

Consultez la section Désinstallation du logiciel Adobe Commerce dans notre documentation destinée aux développeurs.

Pour désinstaller le logiciel Adobe Commerce, procédez comme suit :

  1. SSH à votre environnement.

  2. Exécutez setup:uninstall :

    code language-php 
      php bin/magento setup:uninstall

  3. Confirmez la désinstallation.

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

[SUCCESS]: Magento uninstallation complete.

Cela signifie que nous avons rétabli notre installation Adobe Commerce (y compris DB) sur son état authentique (Vanilla).

Étape 2 : réinitialisation de la branche git reset-git-branch

Avec la réinitialisation de git, nous avons rétabli le code à l’état souhaité dans le passé.

  1. Cloner l’environnement vers votre environnement de développement local. Vous pouvez copier la commande dans la console cloud : copy_git_clone.png

  2. Accédez à l’historique des validations. Utilisez --reverse pour afficher l’historique dans l’ordre inverse afin de plus de commodité :

    code language-git 
      git log --reverse

  3. Sélectionnez le hachage de validation sur lequel vous avez été bon. Pour réinitialiser le code à son état authentique (Vanilla), recherchez la toute première validation qui a créé votre branche (environnement). Sélectionner un hachage de validation dans la console Git

  4. Appliquez la réinitialisation git stricte :

    code language-git 
      git reset --h <commit_hash>

  5. Push changes to server :

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

Une fois ces étapes effectuées, notre branche git est réinitialisée et l’ensemble du changement git est clair. La dernière notification push git déclenche le redéploiement pour appliquer toutes les modifications et réinstaller Adobe Commerce.

Scénario 2 : aucun instantané ; version rompue (aucune connexion SSH) scen3

Cette section explique comment restaurer un environnement lorsqu'il se trouve dans un état critique : la procédure de déploiement ne peut pas réussir à créer une application opérationnelle, rendant ainsi la connexion SSH indisponible.

Dans ce scénario, vous devez d’abord restaurer l’état de fonctionnement de votre application Adobe Commerce à l’aide de la réinitialisation de git, puis désinstaller le logiciel Adobe Commerce (pour déposer et restaurer la base de données, supprimer la configuration de déploiement, etc.). Le scénario comprend les mêmes étapes que dans le scénario 1, mais l’ordre des étapes est différent et il existe une autre étape : forcer le redéploiement. Les étapes sont les suivantes :

1. Réinitialisez la branche git.

2. Désactiver la gestion de la configuration.

3. Désinstallez le logiciel Adobe Commerce.

4&point; redéploiement de la force.

Une fois ces étapes effectuées, vous obtiendrez les mêmes résultats que dans le scénario 1.

Étape 4 : forcer le redéploiement

Effectuez une validation (il peut s’agir d’une validation vide, bien que nous ne la recommandions pas) et envoyez-la au serveur pour déclencher le redéploiement :

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

En cas d’échec de l’installation:désinstallation, réinitialisez manuellement la base de données

Si l’exécution de la commande setup:uninstall échoue avec une erreur et ne peut pas être terminée, nous pouvons effacer manuellement la base de données en procédant comme suit :

  1. SSH à votre environnement.

  2. Connectez-vous à la base de données MySQL :

    code language-sql 
    mysql -h database.internal

  3. Déposez la base de données main :

    code language-sql 
    drop database main;

  4. Créez une base de données main vide :

    code language-sql 
    create database main;

  5. Supprimer les fichiers de configuration suivants : config.php, config.php .bak, env.php et env.php.bak.

Après avoir réinitialisé la base de données, effectuez une notification push git vers l’environnement pour déclencher le redéploiementet installez Adobe Commerce sur une nouvelle base de données. Ou exécutez la commande de redéploiement.

Lecture connexe

Dans notre documentation destinée aux développeurs :

recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a