AWSSupport-TroubleshootCodeDeploy - AWS Systems Manager Référence du manuel d'automatisation

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.

AWSSupport-TroubleshootCodeDeploy

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 indique les étapes à suivre pour vous aider à résoudre le problème ou à le résoudre davantage. Les meilleures pratiques pour 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'CodeDeployagent n'est pas installé ou ne s'exécute pas sur l'instance Amazon EC2

  • Aucun profil d'instance AWS Identity and Access Management (IAM) n'est associé à l'instance Amazon EC2

  • Le profil d'instance IAM attaché à l'instance Amazon EC2 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 une Région AWS instance différente de l'instance Amazon EC2

  • Problèmes liés au fichier de spécification de l'application (AppSpec)

  • Erreurs « Le fichier existe déjà à l'emplacement »

  • Les crochets d'événements du cycle de vie CodeDeploy gérés ont échoué

  • Échec des crochets d'événements du cycle de vie gérés par le

  • Événements de mise à l'échelle pendant le déploiement

Exécutez cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

LinuxmacOS, Windows

Paramètres

  • AutomationAssumeRole

    Type : String

    Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle AWS Identity and Access Management (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 démarre ce runbook.

  • DeploymentId

    Type : String

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

  • InstanceId

    Type : String

    Description : (Obligatoire) L'ID de l'instance Amazon EC2 où 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- Recueille des informations à partir de l'instance Amazon EC2, telles que l'état de l'instance et les détails du profil de l'instance IAM.

  • aws:executeScript- Examine le déploiement spécifié et renvoie une analyse expliquant pourquoi le déploiement a échoué.