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 l’infrastructure cloud.
Choisissez la méthode la plus adaptée à votre cas :
- Si vous avez prévu une activité (déploiement ou mise à niveau prévu) - Scénario 1 : activité planifiée).
- Si vous disposez d’un instantané valide - Scénario 2 : restauration d’un instantané.
- Si vous disposez d’une version stable, mais pas d’instantané valide - Scénario 3 : aucun instantané, version stable (connexion SSH disponible).
- Si la version est endommagée et que vous n’avez pas d’instantané valide - Scénario 4 : aucun instantané ; version rompue (aucune connexion SSH).
Scénario 1 : activité planifiée
Avec un déploiement ou une mise à niveau planifié, le plus simple et recommandé Rollback serait que le marchand, dans le cadre de vos préparatifs, effectue les opérations suivantes :
Cinq jours avant les activités de mise à niveau/déploiement:
- Vérifiez la taille de la base de données active.
- Vérifiez que vous disposez de suffisamment d’espace disque sur
/data/exports
pour contenir un Database Dump. Si vous ne disposez pas de suffisamment d’espace disque, supprimez les données indésirables ou créez un cas de support et demandez au disque d’être développé.
Le jour des modifications:
- Placez le site web dans Maintenance Mode.
En savoir plus sur Activer ou désactiver Maintenance Mode dans notre guide d’utilisation, et Maintenance Mode options de mise à niveau dans notre guide de mise à niveau. - Prenez un local Database Dump.
Si une Rollback est requis:
- Si des applications telles que MariaDB a été mis à niveau dans le cadre de cette activité planifiée, demandez d’abord que l’application soit réinstallée vers une version précédente.
- Rollback la base de données à l'aide de l'attribut local Database Dump, puis réimportez-les dans MariaDB.
- Rollback le code via Git à une version de travail précédente.
Utilisation Snapshots n’est pas la méthode recommandée pour l’activité de mise à niveau/planifiée rollbacks/restores, car la récupération des données par rapport à un Database Dump, comme indiqué à l’étape 2 de la Si une Rollback est requis .
Snapshots ne sont pas conservés sur le noeud/serveur, ils sont conservés sur un bloc de stockage distinct, et comme ces données doivent être transmises du stockage de bloc sur le réseau à un nouveau disque, le processus prend du temps. Ce nouveau disque est ensuite monté sur le noeud prêt à être récupéré/importé sur le disque d’origine connecté au noeud/serveur.
Lorsque vous comparez cela à l’importation d’un fichier local Database Dump, les données sont déjà récupérables sur le noeud/serveur, de sorte que beaucoup de temps est enregistré en tant que Database Import est obligatoire.
Scénario 2 : restauration d’un instantané
Lecture : Restauration d’un instantané sur Adobe Commerce sur l’infrastructure cloud dans notre documentation destinée aux développeurs.
Lecture : Création d’un instantané dans notre documentation destinée aux développeurs.
Scénario 3 : aucun instantané, version 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 :
- Désactivez la gestion de la configuration.
- Désinstallez le logiciel Adobe Commerce.
- Réinitialisez la variable git branche.
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 situés sous
var
effacé). - Votre 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
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 la variable /app/etc/
ne contient pas le répertoire config.php
fichier .
Pour supprimer le fichier de configuration, procédez comme suit :
- SSH vers votre environnement.
- Supprimez le fichier de configuration :
rm app/etc/config.php
En savoir plus sur Configuration Management :
- Réduction du temps d’arrêt du déploiement sur Adobe Commerce sur l’infrastructure cloud dans notre base de connaissances de soutien.
- Gestion des configurations pour les paramètres du magasin dans notre documentation destinée aux développeurs.
Étape 1 : désinstallation du logiciel Adobe Commerce avec la commande 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
.
Lecture : 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 :
- SSH vers votre environnement.
- Exécuter
setup:uninstall
:bin/magento setup:uninstall
- 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éinitialiser la variable git branche
Avec git réinitialiser, nous avons rétabli le code à l’état souhaité dans le passé.
- Cloner l’environnement vers votre environnement de développement local. Vous pouvez copier la commande dans la console cloud :
- Accédez à l’historique des validations. Utilisation
--reverse
pour afficher l’historique dans l’ordre inverse, afin de faciliter les opérations :git log --reverse
- 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).
- Appliquer les conditions difficiles git reset :
git reset --h <commit_hash>
- Push changes to server :
git push --force <origin> <branch>
Après avoir effectué ces étapes, nos git la branche est réinitialisée et l’intégralité de la git changelog est clair. Le dernier git push déclenche le redéploiement pour appliquer toutes les modifications et réinstaller Adobe Commerce.
Scénario 4 : aucun instantané ; version rompue (pas SSH connection)
Cette section explique comment réinitialiser 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 de travail, ce qui a pour effet de SSH connexion indisponible.
Dans ce scénario, vous devez d’abord restaurer l’état de fonctionnement de votre application Adobe Commerce à l’aide de git réinitialisez, puis désinstallez 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 3, mais l’ordre des étapes est différent et il existe une autre étape : forcer le redéploiement. Les étapes sont les suivantes :
Une fois ces étapes effectuées, les résultats seront les mêmes 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 l’installation:désinstallation, réinitialisez manuellement la base de données
Si l’exécution de la variable setup:uninstall
échoue avec une erreur et ne peut pas être effectuée, la base de données peut être effacée manuellement en procédant comme suit :
- SSH vers votre environnement.
- Connectez-vous à la base de données MySQL :
mysql -h database.internal
(Pour les environnements Pro, voir : Configuration du service MySQL). - Déposez le
main
DB :drop database main;
- Créer un champ vide
main
DB :create database main;
- Supprimez les fichiers de configuration suivants :
config.php
,config.php
,.bak,
,env.php
,env.php.bak
Après avoir réinitialisé la base de données, make a git Push vers l’environnement pour déclencher le redéploiement et installez Adobe Commerce sur une base de données nouvellement créée. Ou exécuter la commande redeploy.