

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

 **Descripción** 

 El `AWSSupport-TroubleshootCodeDeploy` manual ayuda a diagnosticar por qué ha fallado una AWS CodeDeploy implementación en una instancia de Amazon Elastic Compute Cloud (Amazon EC2). El manual de procedimientos proporciona pasos para ayudarle a resolver el problema o a resolver problemas adicionales. También CodeDeploy se proporcionan las mejores prácticas para ayudarlo a evitar problemas similares en el futuro. 

Este manual de procedimientos puede ayudarle a resolver los siguientes problemas:
+ El CodeDeploy agente no está instalado o no se está ejecutando en la EC2 instancia de Amazon
+ La EC2 instancia de Amazon no tiene un perfil de instancia AWS Identity and Access Management (IAM) adjunto
+ El perfil de instancia de IAM adjunto a la EC2 instancia de Amazon no tiene los permisos necesarios de Amazon Simple Storage Service (Amazon S3)
+ Falta una revisión almacenada en Amazon S3 o el bucket de Amazon S3 utilizado está en una Región de AWS EC2 instancia diferente a la de Amazon
+ Problemas con el archivo de especificaciones de la aplicación (AppSpec)
+ Errores de tipo “File already exists at location”
+ Los enganches de eventos del ciclo de vida CodeDeploy administrado
+ Enlaces de eventos fallidos del ciclo de vida gestionados por el cliente
+ Eventos de escalado durante una implementación

 [Ejecuta esta automatización (consola)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootCodeDeploy) 

**Tipo de documento**

Automatización

**Propietario**

Amazon

**Plataformas**

Linux, macOS, Windows

**Parámetros**
+ AutomationAssumeRole

  Tipo: cadena

  Descripción: (opcional) el Nombre de recurso de Amazon (ARN) del rol de AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.
+ DeploymentId

  Tipo: cadena

  Descripción: (obligatorio) el ID de la implementación que falló.
+ InstanceId

  Tipo: cadena

  Descripción: (obligatorio) El ID de la EC2 instancia de Amazon en la que se produjo un error en la implementación.

**Permisos de IAM necesarios**

El parámetro `AutomationAssumeRole` requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.
+  `codedeploy:GetDeployment` 
+  `codedeploy:GetDeploymentTarget` 
+  `ec2:DescribeInstances` 

 **Pasos de documentos** 
+  `aws:executeAwsApi`: verifica los valores proporcionados para los parámetros `DeploymentId` y `InstanceId`. 
+  `aws:executeScript`- Recopila información de la EC2 instancia de Amazon, como el estado de la instancia y los detalles del perfil de la instancia de IAM. 
+  `aws:executeScript`: revisa la implementación especificada y regresa un análisis sobre los motivos por los que se ha producido un error en la implementación. 