Récupération de l’échec du composant

Cette rubrique explique comment récupérer si le déploiement d’un composant échoue. Les exemples types incluent les composants dont les dépendances ne sont pas satisfaites par votre environnement distant, comme les versions PHP incompatibles.

Vous pouvez récupérer d’un déploiement en échec de l’une des manières suivantes :

Nettoyer, supprimer et redéployer

Pour nettoyer le déploiement précédent, identifiez le composant qui a été ajouté ou mis à jour, puis supprimez-le. Tout d’abord, connectez-vous à l’environnement distant et effacez manuellement le contenu du répertoire var. Supprimez ensuite le composant du fichier composer.json et redéployez l’environnement.

Pour nettoyer les var répertoires :

  1. Sur votre poste de travail local, modifiez le répertoire de votre projet.

  2. Utilisez SSH pour vous connecter à l’environnement distant.

    code language-bash
    magento-cloud ssh
    
  3. Effacez les répertoires var.

    code language-shell
    rm -rf var/*
    
  4. Déconnectez-vous.

Pour supprimer le composant :

  1. Sur votre poste de travail local, modifiez le répertoire de votre projet.

  2. Effacez le cache.

    code language-bash
    composer clear-cache
    
  3. Supprimez le composant du fichier composer.json.

    code language-bash
    composer remove <component-name>:<version>
    

    Si le message suivant s’affiche, vous n’avez rien à faire de plus :

    code language-none
    Package "<name>:<version>" listed for update is not installed. Ignoring.
    
  4. Patientez pendant la mise à jour des dépendances.

  5. Ajout, validation et modification du code push.

    code language-bash
    git add -A
    
    code language-bash
    git commit -m "<message>"
    
    code language-bash
    git push origin <environment-ID>
    
WARNING
Le processus de déploiement commence lorsque vous effectuez une fusion, une notification push ou une synchronisation de votre environnement, ou lorsque vous déclenchez un redéploiement manuel, pendant lequel l’application Commerce est en mode de maintenance. Pour un environnement de production, Adobe recommande d’effectuer ce travail aux heures creuses afin d’éviter les interruptions de service.

Pour en savoir plus sur la restauration d’un environnement sans sauvegarde, voir Restaurer un environnement.

TIP
Pour obtenir de l’aide sur les déploiements bloqués, utilisez l’outil de dépannage du déploiement Adobe Commerce dans le Centre d’aide de Commerce.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26