AWSSupport-TroubleshootCodeDeploy - AWS Systems Manager Referência do runbook de automação

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

Descrição

O runbook AWSSupport-TroubleshootCodeDeploy ajuda a diagnosticar por que uma implantação do AWS CodeDeploy 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 o CodeDeploy também são fornecidas para ajudar você a evitar problemas semelhantes no futuro.

Este runbook pode ajudá-lo a resolver os seguintes problemas:

  • O agente do CodeDeploy não está instalado ou não está em execução na instância do Amazon EC2

  • A instância do Amazon EC2 não tem um perfil de instância do AWS Identity and Access Management (IAM) anexado

  • O perfil de instância do IAM anexado à instância do Amazon EC2 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 uma Região da AWS que é diferente da instância do Amazon EC2

  • Problemas com o arquivo de especificação do aplicativo (AppSpec)

  • Erros “O arquivo já existe no local”

  • Falha nos hooks de eventos do ciclo de vida gerenciado do CodeDeploy

  • Falha nos hooks de eventos do ciclo de vida gerenciado do cliente

  • Eventos de escalonamento durante a implantação

Execute esta automação (console)

Tipo de documento

Automation

Proprietário

Amazon

Plataformas

Linux, macOS, Windows

Parâmetros

  • AutomationAssumeRole

    Tipo: sequência

    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: sequência

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

  • InstanceId

    Tipo: sequência

    Descrição: (obrigatório) o ID da instância do Amazon EC2.

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 instância do Amazon EC2, como o estado da instância e detalhes do perfil de instância do IAM.

  • aws:executeScript: analisa a implantação especificada e retorna uma análise sobre por que a implantação falhou.