[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Réinitialisation de l’environnement sur Adobe Commerce sur l’infrastructure cloud

Cet article présente différents scénarios de restauration d’un environnement sur Adobe Commerce sur une infrastructure cloud.

Choisissez la solution la plus adaptée à votre cas :

Scénario 1 : Activité prévue

Dans le cadre d'un déploiement ou d'une mise à niveau planifiés, la Rollback la plus simple et recommandée serait que le commerçant, dans le cadre de vos préparatifs, effectue les opérations suivantes :

Cinq jours avant les activités de mise à niveau/déploiement :

Le jour des modifications :

Si une Rollback est requise :

L’utilisation de Snapshots n’est pas recommandée pour les rollbacks/restores de mise à niveau/d’activité planifiée, car la récupération des données prend beaucoup plus de temps qu’une Database Dump locale, comme indiqué ci-dessus à l’étape 2 de la section Si une Rollback est requise.

Les Snapshots ne sont pas conservées sur le nœud/serveur, elles sont conservées sur un bloc de stockage distinct, et comme ces données doivent être transmises du bloc de stockage sur le réseau à un nouveau disque, cela prend du temps dans le processus. Ce nouveau disque est ensuite monté sur le nœud prêt à être récupéré/importé sur le disque d’origine connecté au nœud/serveur.

Si vous le comparez à l’importation d’un Database Dump local, les données peuvent déjà être récupérées sur le nœud/serveur, ce qui permet de gagner beaucoup de temps, car seul un Database Import est nécessaire.

Scénario 2 : restauration d’un instantané

Lire : Restaurez un instantané sur Adobe Commerce sur l’infrastructure cloud dans notre documentation destinée aux développeurs.

Lire : Créer un instantané dans notre documentation destinée aux développeurs.

Scénario 3 : aucun instantané, build stable (connexion SSH disponible)

Cette section explique comment réinitialiser 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 :

Après avoir effectué les étapes suivantes :

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

Étape 0 (Prérequis) : Supprimer config.php pour désactiver Configuration Management

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

Pour désactiver la gestion de la configuration, assurez-vous que votre répertoire /app/etc/ ne contient pas le fichier config.php.

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

En savoir plus sur la gestion de la configuration :

Étape 1 : désinstaller le logiciel Adobe Commerce avec la commande setup:uninstall

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

Lire : Désinstaller le logiciel Adobe Commerce dans notre documentation destinée aux développeurs.

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

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

[SUCCESS]: Magento uninstallation complete.

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

Étape 2 : réinitialiser la branche git

Avec git réinitialisé, nous rétablissons l’état souhaité du code dans le passé.

Après avoir effectué ces étapes, notre branche git est réinitialisée et l’ensemble du journal des modifications 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 4 : aucun instantané ; version rompue (aucune connexion SSH)

Cette section explique comment réinitialiser un environnement lorsqu’il est dans un état critique : la procédure de déploiement ne peut pas réussir à créer une application en cours d’exécution, ce qui rend 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 git réinitialisation, puis désinstaller le logiciel Adobe Commerce (pour supprimer et restaurer la base de données, supprimer la configuration de déploiement, etc.). Le scénario implique les mêmes étapes que dans le scénario 3, mais l’ordre des étapes est différent et il existe une étape supplémentaire : forcer le redéploiement. Les étapes sont les suivantes :

Après avoir effectué ces étapes, vous obtiendrez les mêmes résultats que dans le scénario 3.

É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 la configuration : désinstallation, réinitialisation manuelle de la base de données

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

Après la réinitialisation de la base de données, effectuez une push git vers l’environnement pour déclencher le redéploiement et installez Adobe Commerce sur une base de données nouvellement créée. Ou exécutez la commande redeploy.