AWSSupport-TroubleshootCodeDeploy - AWS Systems Manager 자동화 런북 참조

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWSSupport-TroubleshootCodeDeploy

설명

AWSSupport-TroubleshootCodeDeploy 실행서는 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스에서 AWS CodeDeploy 배포가 실패한 이유를 진단하는 데 도움이 됩니다. 실행서는 문제 해결이나 추가 문제 해결에 도움이 되는 단계를 출력합니다. 향후 유사한 문제를 방지하는 데 도움이 되는 CodeDeploy 모범 사례도 제공합니다.

이 실행서는 다음 문제를 해결하는 데 도움이 될 수 있습니다.

  • CodeDeploy 에이전트가 Amazon EC2 인스턴스에 설치되어 있지 않거나 실행되고 있지 않습니다.

  • Amazon EC2 인스턴스에는 연결된 AWS Identity and Access Management (IAM) 인스턴스 프로파일이 없습니다.

  • Amazon EC2 인스턴스에 연결된 IAM 인스턴스 프로파일에는 필요한 Amazon Simple Storage Service(Amazon S3) 권한이 없습니다.

  • Amazon S3에 저장된 수정 버전이 누락되었거나 사용된 Amazon S3 버킷이 Amazon EC2 인스턴스와 다른 AWS 리전에 있습니다.

  • 애플리케이션 사양(AppSpec) 파일 문제

  • “파일이 해당 위치에 이미 존재합니다” 오류

  • CodeDeploy 관리형 수명 주기 이벤트 후크 실패

  • 고객 관리형 수명 주기 이벤트 후크 실패

  • 배포 중 이벤트 축소

이 자동화 실행(콘솔)

문서 유형

자동화

소유자

Amazon

플랫폼

Linux, macOS, Windows

파라미터

  • AutomationAssumeRole

    유형: 문자열

    설명: (선택 사항) 사용자를 대신하여 Systems Manager Automation을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management(IAM) 역할의 Amazon 리소스 이름(ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.

  • DeploymentId

    유형: 문자열

    설명: (필수) 실패한 배포의 ID입니다.

  • InstanceId

    유형: 문자열

    설명: (필수) 배포가 실패한 Amazon EC2 인스턴스의 ID입니다.

필수 IAM 권한

실행서를 성공적으로 사용하려면 AutomationAssumeRole 파라미터에 다음 작업이 필요합니다.

  • codedeploy:GetDeployment

  • codedeploy:GetDeploymentTarget

  • ec2:DescribeInstances

문서 단계

  • aws:executeAwsApi - DeploymentIdInstanceId 파라미터에 제공된 값을 확인합니다.

  • aws:executeScript - Amazon EC2 인스턴스에서 인스턴스 상태 및 IAM 인스턴스 프로파일 세부 정보와 같은 정보를 수집합니다.

  • aws:executeScript - 지정된 배포를 검토하고 배포가 실패한 이유에 대한 분석을 반환합니다.