Résolution des problèmes de déploiement d’Adobe Commerce

5 mai 2025

Rubriques :
Build
Déployer

Créé pour :

Développeur

Les déploiements bloqués et les déploiements ayant échoué sur Adobe Commerce peuvent être résolus à l’aide de l’outil de dépannage de déploiement. Cliquez sur chaque question pour afficher la réponse à chaque étape de l’utilitaire de dépannage.

Étape 1 : vérifier que le service est en cours d’exécution

Adobe Commerce sur le service d’infrastructure cloud est-il opérationnel ?

Déploiement bloqué - Le service d’infrastructure cloud d’Adobe Commerce est-il opérationnel ? Cochez Adobe Commerce Cloud.

a. OUI - Passer à étape 2.
b. NON - Maintenance ou pannes globales. Recherchez une estimation de la durée et des mises à jour.

Étape 2 - Vérifier les déploiements dans d’autres environnements

Existe-t-il des déploiements dans d’autres environnements qui bloquent le déploiement dans l’environnement existant ?

Pour obtenir la liste des activités en cours, exécutez la commande suivante à l’aide de l’interface de ligne de commande magento-cloud (si vous n’avez été ajouté qu’à un seul projet cloud). Remarque : vérifiez que vous disposez de la dernière version de l’interface de ligne de commande magento-cloud. Pour connaître les étapes, reportez-vous à la section Mise à jour de l’interface de ligne de commande du guide Commerce sur les infrastructures cloud.

magento-cloud --state=in_progress

Pour obtenir une liste des activités en cours, exécutez la commande suivante à l’aide de l’interface de ligne de commande magento-cloud (si vous avez été ajouté à plusieurs projets) :

magento-cloud -p <project-id or project-url> --state=in_progress

Pour obtenir des informations sur une activité de déploiement existante (voir la section Vérification du journal de déploiement si l’interface utilisateur de Cloud comporte une erreur « journal arrêté »
pour plus d’informations), vous pouvez exécuter cette commande pour obtenir un journal d’exécution de cette activité :

magento-cloud activity:log <activity-id> [OPTIONAL: <-p project-id or project-url>]

a. OUI - Résolution des problèmes de l’autre environnement qui bloque le déploiement dans l’environnement existant. Passez à étape 3.

b. NON - Résolution des problèmes liés à l’environnement actuel. Passez à étape 3.

Étape 3 : vérification de SSH sur tous les nœuds

SSH réussi sur tous les nœuds ?

a. OUI - Passer à étape 4.
b. NON - Envoyer un ticket d’assistance.

Étape 4 : vérifier tous les services en cours d’exécution

Tous les services en cours d’exécution ?

a. OUI - Passer à étape 5.
b. NON - Envoyer un ticket d’assistance.

Étape 5 - Vérification de l’exécution du Bitbucket

Utilisation de Bitbucket ?

a. OUI - Vérifiez status.bitbucket.com.
b. NON - Vérifiez les erreurs du journal de déploiement dans les journaux Créer et déployer. Passez à étape 6.

Étape 6 - Vérification des codes d’erreur

Code d’erreur signalé ?

a. OUI - Passer à étape 7.
b. NON - Passer à étape 8.

Etape 7 - 403 Erreur Interdite

403 Interdit ?

a. OUI - Passer à étape 16.
b. NON - Passer à étape 9.

Étape 8 : vérification des tâches cron en cours d’exécution

Les tâches cron sont-elles en cours d’exécution ? Connectez-vous par ssh sur la branche et exécutez ps aufxx |grep cron.

a. OUI - Connectez-vous par ssh sur la branche affectée (par exemple, principale). Tuer et déverrouiller les emplois cron. Cette action entraîne la suppression des tâches cron et la réinitialisation du statut. Exécutez php vendor/bin/ece-tools cron:kill puis php vendor/bin/ece-tools cron:unlock. Si vous étiez en train de fusionner un environnement dans un autre, vérifiez que les deux environnements exécutent crons.
b. NON - Passer à étape 17.

Etape 9 - Erreur application déployable sur le cluster distant

Erreur Impossible de charger l’application dans le cluster distant ?

a. OUI - Passer à étape 10.
b. NON - Passer à étape 11.

Étape 10 - Vérifier que le stockage est suffisant

Stockage disponible correct ?

a. OUI - Procédez à l’étape 11.
b. NON - Vérifiez Gérer l’espace disque.

Étape 11 - Vérification de l’espace disque

_fichier n<>a pas pu être écrit Avertissement _?

a. OUI - Veuillez augmenter la valeur du disque en .magento.app.yaml et redéployer. Si cela ne fonctionne pas, envoyez un ticket d’assistance.
b. NON - Procédez à étape 12.

Étape 12 - Échec du redéploiement de l’environnement

Erreur d’échec du redéploiement de l’environnement ?

a. OUI - Procédez à l’étape 13.
b. NON - Procédez à étape 8.

Étape 13 - Vérification de l’échec de la mise à niveau d’Elasticsearch

Elasticsearch en cours de mise à niveau ou de déploiement ?

a. OUI - Les étapes de mise à niveau d’Elasticsearch ont échoué. Pour plus d'informations, consultez la section Compatibilité logicielle Elasticsearch. Si la mise à niveau d’Elasticsearch ne fonctionne toujours pas, envoyez un ticket d’assistance. Remarque : sur Adobe Commerce sur les infrastructures cloud, sachez que les mises à niveau de service ne peuvent pas être envoyées à l’environnement de production sans avis de 48 heures ouvrables à notre équipe en charge de l’infrastructure. Cela est nécessaire car nous devons nous assurer qu’un ingénieur du support à l’infrastructure est disponible pour mettre à jour votre configuration dans le délai souhaité avec un temps d’arrêt minimal pour votre environnement de production. Ainsi, 48 heures avant le moment où vos modifications doivent être mises en production, soumettez un ticket d’assistance détaillant la mise à niveau de service requise et indiquant l’heure à laquelle vous souhaitez que le processus de mise à niveau démarre.
b. NON - Passer à étape 14.

Étape 14 - Vérifier les limites d'espace

Le système de fichiers manque d’inodes ou d’espace ?

a. OUI - Voir Gérer l’espace disque.
b. NON - Passer à étape 15.

Étape 15 - Erreur de version Elasticsearch

Erreur sur les versions d’Elasticseach ?

a. OUI - Passer à étape 16.
b. NON - Passer à étape 21.

Étape 16 - Vérification de la configuration du compositeur

La configuration du compositeur est-elle correcte ?

a. OUI - Passer à étape 10.
b. NON - Consultez page web du dépanneur du compositeur.

Étape 17 - Rechercher les processus à long terme

Processus à long terme ?

a. OUI - Identifier les processus à long terme, puis supprimer les processus :

Exécutez la commande suivante dans le terminal : ps aufx.
Recherchez le PID du processus en cours d’exécution.
Terminez le processus à l’aide de kill -9 <PID>.

Surveillez les déploiements pour la récurrence.

b. NON - Passer à étape 18.

Étape 18 - Vérifier la défaillance du crochet de poteau

Échec/blocage du crochet de publication ?

a. OUI - Base de données : Espace disque disponible, corruption, tables incomplètes/corrompues.
b. NON - Passer à étape 19.

Étape 19 - Vérifier si les extensions tierces bloquent le déploiement

Utilisation d’extensions tierces ?

a. OUI - Essayez de désactiver les extensions tierces et d’exécuter le déploiement (pour voir si elles sont à l’origine du problème), en particulier si des noms d’extension figurent dans des erreurs.
b. NON - Passer à étape 20.

Étape 20 - Rechercher les requêtes lentes

Requêtes de longue durée ?

Vérifiez le journal des requêtes lentes et MySQL show processlist.

a. OUI - Interrompt toutes les requêtes longues. Vérifiez Syntaxe de MySQL Kill.
b. NON - Envoyer un ticket d’assistance.

Étape 21 - Rétrogradation de la version d’Elasticsearch

Mise à niveau des versions d’Elasticsearch ?

a. OUI - Impossible d’effectuer la configuration. Envoyez un ticket d’assistance.
b. NON - Envoyer un ticket d’assistance.

Retour à l’étape 1

recommendation-more-help