Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

 **Descrizione** 

 Il `AWSSupport-TroubleshootCodeDeploy` runbook aiuta a diagnosticare il motivo per cui una AWS CodeDeploy distribuzione non è riuscita su un'istanza Amazon Elastic Compute Cloud (Amazon EC2). Il runbook riporta i passaggi per aiutarti a risolvere il problema o a risolverlo ulteriormente. CodeDeploy Vengono inoltre fornite le migliori pratiche per aiutarti a evitare problemi simili in futuro. 

Questo runbook può aiutarti a risolvere i seguenti problemi:
+ L' CodeDeploy agente non è installato o non è in esecuzione sull' EC2istanza Amazon
+ L' EC2 istanza Amazon non ha un profilo di istanza AWS Identity and Access Management (IAM) collegato
+ Il profilo dell'istanza IAM collegato all' EC2 istanza Amazon non dispone delle autorizzazioni Amazon Simple Storage Service (Amazon S3) richieste
+ Manca una revisione archiviata in Amazon S3 oppure il bucket Amazon S3 utilizzato si trova in Regione AWS un'istanza diversa dall'istanza Amazon EC2 
+ Problemi relativi ai file delle specifiche dell'applicazione () AppSpec
+ Errori «Il file esiste già nella posizione»
+ Hook di eventi del ciclo di vita CodeDeploy gestiti non riusciti
+ Hook per eventi del ciclo di vita gestiti dal cliente non riusciti
+ Eventi di scalabilità durante l'implementazione

 [Esegui questa automazione (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootCodeDeploy) 

**Tipo di documento**

Automazione

**Proprietario**

Amazon

**Piattaforme**

Linux, macOS, Windows

**Parametri**
+ AutomationAssumeRole

  Tipo: stringa

  Descrizione: (Facoltativo) L'Amazon Resource Name (ARN) del ruolo AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.
+ DeploymentId

  Tipo: stringa

  Descrizione: (Obbligatorio) L'ID della distribuzione che non è riuscita.
+ InstanceId

  Tipo: stringa

  Descrizione: (Obbligatorio) L'ID dell' EC2 istanza Amazon in cui la distribuzione non è riuscita.

**Autorizzazioni IAM richieste**

Il `AutomationAssumeRole` parametro richiede le seguenti azioni per utilizzare correttamente il runbook.
+  `codedeploy:GetDeployment` 
+  `codedeploy:GetDeploymentTarget` 
+  `ec2:DescribeInstances` 

 **Fasi del documento** 
+  `aws:executeAwsApi`- Verifica i valori forniti per i parametri `DeploymentId` and`InstanceId`. 
+  `aws:executeScript`- Raccoglie informazioni dall' EC2istanza Amazon come lo stato dell'istanza e i dettagli del profilo dell'istanza IAM. 
+  `aws:executeScript`- Esamina la distribuzione specificata e restituisce un'analisi del motivo per cui l'implementazione non è riuscita.