AWSSupport-TroubleshootCodeDeploy - AWS Systems Manager Guide de 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 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 AWS Identity and Access Management (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)

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 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 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é.