AWS CodeDeploy デプロイアクションリファレンス - AWS CodePipeline
アクションの種類設定パラメータ 入力アーティファクト出力アーティファクトサービスロールのアクセス許可: AWS CodeDeploy アクションアクションの宣言関連情報

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

AWS CodeDeploy デプロイアクションリファレンス

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

注記

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

アクションの種類

  • カテゴリ:Deploy

  • 所有者: AWS

  • プロバイダー: CodeDeploy

  • バージョン: 1

設定パラメータ

ApplicationName

必須: はい

CodeDeploy で作成したアプリケーションの名前。

DeploymentGroupName

必須: はい

CodeDeploy で作成したデプロイメントグループ。

入力アーティファクト

  • アーティファクトの数: 1

  • [説明:] CodeDeploy が判断に使用する AppSpec ファイル

    • Amazon S3 や GitHub にあるアプリケーションリビジョンから、インスタンスにインストールするもの。

    • デプロイライフサイクルイベントに応じて実行するライフサイクルイベントフック。

    AppSpec ファイルの詳細については、[CodeDeploy AppSpec ファイルリファレンス] を参照してください。

出力アーティファクト

  • アーティファクトの数: 0

  • 説明: 出力アーティファクトは、このアクションタイプには適用されません。

サービスロールのアクセス許可: AWS CodeDeploy アクション

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": [
                "*"
            ]
        }
    ]
}

アクションの宣言

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"
        }
    ]
},

このアクションを利用する際に役立つ関連リソースは以下の通りです。

  • チュートリアル: シンプルなパイプラインを作成する (S3 バケット) — このチュートリアルでは、ソースバケット、EC2 インスタンス、および CodeDeploy リソースを作成して、サンプルアプリケーションをデプロイする手順について説明します。次に、S3 バケットに保持されているコードを Amazon EC2 インスタンスにデプロイする CodeDeploy デプロイアクションを使用してパイプラインを構築します。

  • チュートリアル: シンプルなパイプラインを作成する (CodeCommit リポジトリ) — このチュートリアルでは、CodeCommit ソースリポジトリ、EC2 インスタンス、および CodeDeploy リソースを作成して、サンプルアプリケーションをデプロイする手順を説明します。次に、CodeCommit リポジトリから Amazon EC2 インスタンスにコードをデプロイする CodeDeploy デプロイアクションを使用してパイプラインを構築します。

  • [CodeDeploy AppSpec ファイルリファレンス] — [AWS CodeDeploy ユーザーガイド] のこのリファレンスの章では CodeDeploy AppSpec ファイルのリファレンス情報と例について説明します。