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

Last update: Fri Mar 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

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 step-1

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 step-2

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.

code language-bash
`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) :

code language-bash
`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é :

code language-bash
`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 step-3

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 step-4

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 step-5

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 step-6

Code d’erreur signalé ?

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

Etape 7 - 403 Erreur Interdite step-7

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 step-8

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 step-9

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 step-10

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 step-11

_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 step-12

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 step-13

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 step-14

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 step-15

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 step-16

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 step-17

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 step-18

É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 step-19

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 step-20

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 step-21

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

8bd06ef0-b3d5-4137-b74e-d7b00485808a