Récupération après une panne de composant

Cette rubrique explique comment effectuer une récupération si un composant ne se déploie pas correctement. Des exemples typiques incluent des composants qui ont des dépendances qui ne sont pas satisfaites par votre environnement distant, telles que des versions PHP incompatibles.

Vous pouvez effectuer une récupération à la suite d’un déploiement ayant échoué de l’une des manières suivantes :

Nettoyer, supprimer et redéployer

Pour effectuer un nettoyage à partir du 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 répertoires var, procédez comme suit

  1. Sur votre station de travail locale, accédez au répertoire du 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 station de travail locale, accédez au répertoire du 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 d’autre :

    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 modifications de 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, au cours duquel l’application Commerce est en mode de maintenance. Pour un environnement de production, Adobe recommande d’effectuer ce travail en dehors des heures de pointe afin d’éviter toute interruption de service.

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

TIP
Pour obtenir de l’aide sur les déploiements bloqués, utilisez l’utilitaire de dépannage de déploiement Adobe Commerce dans le Centre d’aide de Commerce.
recommendation-more-help