As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

 **Descrição** 

 O `AWSSupport-TroubleshootCodeDeploy` runbook ajuda a diagnosticar por que uma AWS CodeDeploy implantação falhou em uma instância do Amazon Elastic Compute Cloud (Amazon EC2). O runbook fornece etapas para ajudar você a resolver o problema ou resolver problemas adicionais. As melhores práticas para também CodeDeploy são fornecidas para ajudá-lo a evitar problemas semelhantes no futuro. 

Este runbook pode ajudá-lo a resolver os seguintes problemas:
+ O CodeDeploy agente não está instalado ou não está em execução na EC2 instância da Amazon
+ A EC2 instância da Amazon não tem um perfil de instância AWS Identity and Access Management (IAM) anexado
+ O perfil da instância do IAM anexado à EC2 instância da Amazon não tem as permissões necessárias do Amazon Simple Storage Service (Amazon S3)
+ Uma revisão armazenada no Amazon S3 está ausente ou o bucket do Amazon S3 usado está em Região da AWS uma que é diferente da instância da Amazon EC2 
+ Problemas com o arquivo de especificação do aplicativo (AppSpec)
+ Erros “O arquivo já existe no local”
+ Ganchos de eventos de ciclo de vida CodeDeploy gerenciado com falha
+ Falha nos hooks de eventos do ciclo de vida gerenciado do cliente
+ Eventos de escalonamento durante a implantação

 [Execute esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootCodeDeploy) 

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux, macOS, Windows

**Parâmetros**
+ AutomationAssumeRole

  Tipo: String

  Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.
+ DeploymentId

  Tipo: string

  Descrição: (obrigatório) o ID da implantação que falhou.
+ InstanceId

  Tipo: string

  Descrição: (Obrigatório) O ID da EC2 instância da Amazon em que a implantação falhou.

**Permissões obrigatórias do IAM**

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+  `codedeploy:GetDeployment` 
+  `codedeploy:GetDeploymentTarget` 
+  `ec2:DescribeInstances` 

 **Etapas do documento** 
+  `aws:executeAwsApi`: verifica os valores fornecidos para os parâmetros `DeploymentId` e `InstanceId`. 
+  `aws:executeScript`- Coleta informações da EC2 instância da Amazon, como o estado da instância e detalhes do perfil da instância do IAM. 
+  `aws:executeScript`: analisa a implantação especificada e retorna uma análise sobre por que a implantação falhou.