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

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

 **설명** 

 `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 관리형 수명 주기 이벤트 후크 실패
+ 고객 관리형 수명 주기 이벤트 후크 실패
+ 배포 중 이벤트 축소

 [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootCodeDeploy) 

**문서 유형**

자동화

**소유자**

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` - `DeploymentId` 및 `InstanceId` 파라미터에 제공된 값을 확인합니다.
+  `aws:executeScript` - Amazon EC2 인스턴스에서 인스턴스 상태 및 IAM 인스턴스 프로파일 세부 정보와 같은 정보를 수집합니다.
+  `aws:executeScript` - 지정된 배포를 검토하고 배포가 실패한 이유에 대한 분석을 반환합니다.