Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# AWS CodeDeploy
<a name="automation-ref-acd"></a>

 AWS Systems Manager L'automatisation fournit des runbooks prédéfinis pour AWS CodeDeploy. Pour plus d’informations sur les runbooks, consultez [Travailler avec des runbooks](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html). Pour plus d'informations sur l'affichage du contenu du runbook, consultez[Afficher le contenu du runbook](automation-runbook-reference.md#view-automation-json). 

**Topics**
+ [`AWSSupport-TroubleshootCodeDeploy`](automation-awssupport-troubleshootcodedeploy.md)

# `AWSSupport-TroubleshootCodeDeploy`
<a name="automation-awssupport-troubleshootcodedeploy"></a>

 **Description** 

 Le `AWSSupport-TroubleshootCodeDeploy` runbook permet de diagnostiquer les raisons de l'échec d'un AWS CodeDeploy déploiement sur une instance Amazon Elastic Compute Cloud (Amazon EC2). Le runbook affiche les étapes à suivre pour vous aider à résoudre le problème ou à poursuivre le dépannage. Les meilleures pratiques CodeDeploy sont également fournies pour vous aider à éviter des problèmes similaires à l'avenir. 

Ce runbook peut vous aider à résoudre les problèmes suivants :
+ L' CodeDeploy agent n'est pas installé ou ne fonctionne pas sur l' EC2instance Amazon
+ Aucun profil d' EC2 instance Gestion des identités et des accès AWS (IAM) n'est attaché à l'instance Amazon
+ Le profil d'instance IAM attaché à l' EC2 instance Amazon ne dispose pas des autorisations Amazon Simple Storage Service (Amazon S3) requises
+ Une révision stockée dans Amazon S3 est manquante ou le compartiment Amazon S3 utilisé se trouve dans un Région AWS compartiment différent de celui de l' EC2 instance Amazon
+ Problèmes liés au fichier de spécification de l'application (AppSpec)
+ Erreurs « Le fichier existe déjà à l'emplacement »
+ Hooks d'événements du cycle de vie CodeDeploy gérés ayant échoué
+ Hooks d'événements liés au cycle de vie gérés par le client
+ Événements d'extension pendant le déploiement

 [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootCodeDeploy) 

**Type de document**

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

Linux, macOS, Windows

**Paramètres**
+ AutomationAssumeRole

  Type : String

  Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.
+ DeploymentId

  Type : String

  Description : (Obligatoire) L'ID du déploiement qui a échoué.
+ InstanceId

  Type : String

  Description : (Obligatoire) L'ID de l' EC2 instance Amazon sur laquelle le déploiement a échoué.

**Autorisations IAM requises**

Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook.
+  `codedeploy:GetDeployment` 
+  `codedeploy:GetDeploymentTarget` 
+  `ec2:DescribeInstances` 

 **Étapes de document** 
+  `aws:executeAwsApi`- Vérifie les valeurs fournies pour les `InstanceId` paramètres `DeploymentId` et. 
+  `aws:executeScript`- Collecte des informations à partir de l' EC2instance Amazon, telles que l'état de l'instance et les détails du profil de l'instance IAM. 
+  `aws:executeScript`- Vérifie le déploiement spécifié et renvoie une analyse expliquant pourquoi le déploiement a échoué.