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

# AWS CodeDeploy デプロイアクションリファレンス
<a name="action-reference-CodeDeploy"></a>

 AWS CodeDeploy アクションを使用して、アプリケーションコードをデプロイフリートにデプロイします。デプロイフリートは、Amazon EC2 インスタンス、オンプレミスインスタンス、またはその両方で構成することができます。

**注記**  
このリファレンストピックでは、Amazon EC2 をデプロイプラットフォームとする CodePipeline の CodeDeploy デプロイアクションを説明します。CodePipeline における Amazon Elastic Container Service から CodeDeploy の blue/green デプロイアクションのリファレンス情報については、[Amazon ECS および CodeDeploy ブルー/グリーンデプロイアクションリファレンス](action-reference-ECSbluegreen.md) を参照してください。

**Topics**
+ [アクションタイプ](#action-reference-CodeDeploy-type)
+ [設定パラメータ](#action-reference-CodeDeploy-config)
+ [入力アーティファクト](#action-reference-CodeDeploy-input)
+ [出力アーティファクト](#action-reference-CodeDeploy-output)
+ [サービスロールのアクセス許可: AWS CodeDeploy アクション](#edit-role-codedeploy)
+ [アクションの宣言](#action-reference-CodeDeploy-example)
+ [関連情報](#action-reference-CodeDeploy-links)

## アクションタイプ
<a name="action-reference-CodeDeploy-type"></a>
+ カテゴリ:`Deploy`
+ 所有者: `AWS`
+ プロバイダー: `CodeDeploy`
+ バージョン: `1`

## 設定パラメータ
<a name="action-reference-CodeDeploy-config"></a>

**ApplicationName**  
必須: はい  
CodeDeploy で作成したアプリケーションの名前。

**DeploymentGroupName**  
必須: はい  
CodeDeploy で作成したデプロイメントグループ。

## 入力アーティファクト
<a name="action-reference-CodeDeploy-input"></a>
+ **アーティファクトの数:** `1`
+ **説明:** CodeDeploy が判断に使用する AppSpec ファイル
  + Amazon S3 や GitHub にあるアプリケーションリビジョンから、インスタンスにインストールするもの。
  + デプロイライフサイクルイベントに応じて実行するライフサイクルイベントフック。

  AppSpec ファイルの詳細については、[[CodeDeploy AppSpec ファイルリファレンス](https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-appspec-file.html)] を参照してください。

  

## 出力アーティファクト
<a name="action-reference-CodeDeploy-output"></a>
+ **アーティファクトの数:** `0` 
+ **説明:** 出力アーティファクトは、このアクションタイプには適用されません。

## サービスロールのアクセス許可: AWS CodeDeploy アクション
<a name="edit-role-codedeploy"></a>

 AWS CodeDeploy サポートを受けるには、ポリシーステートメントに以下を追加します。

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "codedeploy:CreateDeployment",
                "codedeploy:GetApplication",
                "codedeploy:GetDeployment",
                "codedeploy:RegisterApplicationRevision",
                "codedeploy:ListDeployments",
                "codedeploy:ListDeploymentGroups",
                "codedeploy:GetDeploymentGroup"
            ],
            "Resource": [
                "arn:aws:codedeploy:*:111122223333:application:[[codedeployApplications]]",
                "arn:aws:codedeploy:*:111122223333:deploymentgroup:[[codedeployApplications]]/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "codedeploy:GetDeploymentConfig"
            ],
            "Resource": [
                "arn:aws:codedeploy:*:111122223333:deploymentconfig:[[deploymentConfigs]]"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "codedeploy:ListDeploymentConfigs"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}
```

------

## アクションの宣言
<a name="action-reference-CodeDeploy-example"></a>

------
#### [ YAML ]

```
Name: Deploy
Actions:
  - Name: Deploy
    ActionTypeId:
      Category: Deploy
      Owner: AWS
      Provider: CodeDeploy
      Version: '1'
    RunOrder: 1
    Configuration:
      ApplicationName: my-application
      DeploymentGroupName: my-deployment-group
    OutputArtifacts: []
    InputArtifacts:
      - Name: SourceArtifact
    Region: us-west-2
    Namespace: DeployVariables
```

------
#### [ JSON ]

```
{
    "Name": "Deploy",
    "Actions": [
        {
            "Name": "Deploy",
            "ActionTypeId": {
                "Category": "Deploy",
                "Owner": "AWS",
                "Provider": "CodeDeploy",
                "Version": "1"
            },
            "RunOrder": 1,
            "Configuration": {
                "ApplicationName": "my-application",
                "DeploymentGroupName": "my-deployment-group"
            },
            "OutputArtifacts": [],
            "InputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "Region": "us-west-2",
            "Namespace": "DeployVariables"
        }
    ]
},
```

------

## 関連情報
<a name="action-reference-CodeDeploy-links"></a>

このアクションを利用する際に役立つ関連リソースは以下の通りです。
+ [チュートリアル: シンプルなパイプラインを作成する (S3 バケット)](tutorials-simple-s3.md) — このチュートリアルでは、ソースバケット、EC2 インスタンス、および CodeDeploy リソースを作成して、サンプルアプリケーションをデプロイする手順について説明します。次に、S3 バケットに保持されているコードを Amazon EC2 インスタンスにデプロイする CodeDeploy デプロイアクションを使用してパイプラインを構築します。
+ [チュートリアル: シンプルなパイプラインを作成する (CodeCommit リポジトリ)](tutorials-simple-codecommit.md) — このチュートリアルでは、CodeCommit ソースリポジトリ、EC2 インスタンス、および CodeDeploy リソースを作成して、サンプルアプリケーションをデプロイする手順を説明します。次に、CodeCommit リポジトリから Amazon EC2 インスタンスにコードをデプロイする CodeDeploy デプロイアクションを使用してパイプラインを構築します。
+ [[CodeDeploy AppSpec ファイルリファレンス](https://docs.aws.amazon.com/codedeploy/latest/userguide/reference-appspec-file.html)] — [*AWS CodeDeploy ユーザーガイド*] のこのリファレンスの章では CodeDeploy AppSpec ファイルのリファレンス情報と例について説明します。