Documentation

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

Last update: Thu Dec 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Description description

Environnement

Adobe Commerce sur les infrastructures cloud

Problème/Symptômes

  • Déploiement bloqué ou en échec dans un environnement
  • Déploiements bloqués en raison d’activités en cours dans d’autres environnements
  • Problèmes d’accès SSH aux nœuds
  • Services non exécutés (par exemple, Elasticsearch, cron, liés au compositeur)
  • Espace disque insuffisant ou limites inode insuffisantes
  • Erreurs de configuration/version 403/Elasticsearch
  • Échecs de chargement ou erreurs de redéploiement du cluster distant
  • Processus à long terme, échecs de post-hook ou conflits d’extensions tierces
  • Requêtes lentes et problèmes côté base de données (MySQL)
  • Problèmes de configuration du compositeur ou contraintes d’application de correctifs

Résolution resolution

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

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

Déploiement bloqué - Le service d’infrastructure cloud d’Adobe Commerce est-il opérationnel ? Vérifiez Adobe Commerce Cloud (sous Experience Cloud sur la page Statut Adobe).

  • OUI - Passer à l’étape 2.
  • 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 le cloud .

code language-none 
magento-cloud --state=in_progress

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

code language-none 
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 en cas d’erreur de type « Journal envoyé » de l’interface utilisateur de Cloud), vous pouvez exécuter cette commande afin d’obtenir un journal opérationnel de cette activité.

code language-none 
magento-cloud activity:log <activity-id>[ OPTIONAL: <-p project-id or project-url>]
  • OUI - Dépannage de l’autre environnement bloquant le déploiement. Passez à l’étape 3.
  • NON - Résolution des problèmes liés à l’environnement actuel. Passez à l’étape 3.

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

SSH réussi sur tous les nœuds ?

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

Tous les services en cours d’exécution ?

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

Vous utilisez Bitbucket ?

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

Code d<>erreur signalé ?
  • OUI - Passer à l’étape 7.
  • NON - Passer à l’étape 8.

Etape 7 - 403 Erreur Interdite

403 Interdit ?
  • OUI - Passer à l'étape 16.
  • NON - Passer à l’é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 ?
code language-none 
ps aufxx | grep cron

  • OUI - Tuer et déverrouiller les emplois cron :

    code language-none 
    php vendor/bin/ece-tools cron:kill

    php vendor/bin/ece-tools cron:unlock

  • NON - Passer à l'étape 17.

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

Impossible de charger l’application dans le cluster distant ?
  • OUI - Passer à l’étape 10.
  • NON - Passer à l'étape 11.

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

Stockage disponible correct ?

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

Impossible d<>écrire le fichier Avertissement ?

  • OUI -

    • Pour les environnements d’intégration/de démarrage : augmentez la valeur du disque dans .magento.app.yaml et redéployez. Si cela ne fonctionne pas, envoyez un ticket d’assistance. Vous pouvez également supprimer les fichiers journaux volumineux :
    code language-none 
    ls -la var/log

  • NON - Procédez à l’étape 12.

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

Erreur d’échec du redéploiement de l’environnement ?
  • OUI - Procédez à l’étape 13.
  • NON - Procédez à l’é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 ?
  • OUI - Échec des étapes de mise à niveau d’Elasticsearch. 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 : dans le cas d’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, envoyez 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.
  • NON - Passer à l'étape 14.

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

Système de fichiers manquant d’inodes ou d’espace

Étape 15 - Erreur de version Elasticsearch

Erreur au sujet des versions d’Elasticsearch ?
  • OUI - Passer à l'étape 16.
  • NON - Passer à l'étape 21.

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

La configuration du compositeur est-elle correcte ?

Étape 17 - Rechercher les processus à long terme

Processus à long terme ?

  • OUI - Tuer les processus :

    1. Exécuter : ps aufx
    2. Localisation du PID
    3. Terminer : kill -9 <PID>

  • NON - Passer à l'étape 18.

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

Défaillance/blocage du crochet de publication ?
  • OUI - Base de données : libre espace disque, corruption, tables incomplètes/corrompues.
  • NON - Passer à l'étape 19.

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

Vous utilisez des extensions tierces ?

É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.

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

Vous rétrogradez des versions d’Elasticsearch ?
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f