翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS CodeDeploy
<a name="automation-ref-acd"></a>

 AWS Systems Manager 自動化には、事前定義されたランブックが用意されています AWS CodeDeploy。詳細については、「[ランブックの使用](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html)」を参照してください。ランブックコンテンツを表示する方法については、[ランブックの内容を表示する](automation-runbook-reference.md#view-automation-json) を参照してください。

**Topics**
+ [`AWSSupport-TroubleshootCodeDeploy`](automation-awssupport-troubleshootcodedeploy.md)

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

 **説明** 

 `AWSSupport-TroubleshootCodeDeploy` ランブックは、Amazon Elastic Compute Cloud (Amazon EC2) インスタンスで AWS CodeDeploy デプロイが失敗した理由を診断するのに役立ちます。ランブックは、問題の解決やさらなるトラブルシューティングに役立つ手順を出力します。将来、同様の問題を回避するのに役立つ CodeDeploy のベストプラクティスも提供されています。

このランブックは、以下の問題の解決に役立ちます。
+ CodeDeploy エージェントは Amazon EC2 インスタンスにインストールされていないか、Amazon EC2 インスタンスで実行されていません。
+ Amazon EC2 インスタンスに AWS Identity and Access Management (IAM) インスタンスプロファイルがアタッチされていません
+ Amazon EC2 インスタンスにアタッチされた IAM インスタンスプロファイルには、必要な Amazon Simple Storage Service (Amazon S3) 権限がありません
+ Amazon S3 に保存されているリビジョンがないか、 AWS リージョン に使用されている Amazon S3 バケットが Amazon EC2 インスタンスと異なります
+ アプリケーション仕様 (AppSpec) ファイルの問題
+ 「ファイルはすでにそのロケーションに存在します」というエラー
+ 失敗した CodeDeploy マネージドライフサイクルイベントのフック
+ 失敗したカスタマーマネージドライフサイクルイベントのフック
+ デプロイ中のスケールインイベント

 [このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-TroubleshootCodeDeploy) 

**ドキュメントタイプ**

Automation

**[所有者]**

Amazon

**[Platforms]** (プラットフォーム)

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` - 指定されたデプロイを確認し、デプロイが失敗した理由に関する分析を返します。