AWS CloudFormation リファレンス用の CodeDeploy テンプレート - AWS CodeDeploy

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

AWS CloudFormation リファレンス用の CodeDeploy テンプレート

このセクションでは、 CodeDeploy デプロイで動作するように設計された AWS CloudFormation リソース、変換、フックについて説明します。の AWS CloudFormation フックによって管理されるスタック更新を作成する手順については CodeDeploy、「」を参照してください。 を使用して Amazon ECS ブルー/グリーンデプロイを作成する AWS CloudFormation

注記

AWS CloudFormation フックは の AWS CloudFormation コンポーネントの一部であり AWS 、ライフサイクルイベントフックとは異なり CodeDeployます。

で利用できる他の方法に加えて CodeDeploy、 AWS CloudFormation テンプレートを使用して以下のタスクを実行できます。

  • アプリケーションを作成します。

  • デプロイグループを作成し、ターゲットリビジョンを指定します。

  • デプロイ設定を作成します。

  • Amazon EC2 インスタンスを作成します。

AWS CloudFormation は、 テンプレートを使用して AWS リソースをモデル化およびセットアップするのに役立つサービスです。 AWS CloudFormation テンプレートは、形式が JSON 標準に準拠しているテキストファイルです。必要なすべての AWS リソースを記述するテンプレートを作成し、 AWS CloudFormation がそれらのリソースのプロビジョニングと設定を行います。

詳細については、AWS CloudFormationユーザーガイドの「AWS CloudFormation とは」および「Working with AWS CloudFormation Templates」を参照してください。

組織 CodeDeploy 内で と互換性のある AWS CloudFormation テンプレートを使用する場合は、管理者として、 AWS CloudFormation が依存する AWS AWS CloudFormation サービスとアクションへのアクセス権を付与する必要があります。アプリケーション、デプロイグループ、デプロイ設定を作成するアクセス許可を付与するには、 を使用するユーザーのアクセス許可セットに次のポリシーを追加します AWS CloudFormation。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [                
        "cloudformation:*"        
      ],
      "Resource": "*"
    }
  ]
}

ポリシーの詳細については、以下のトピックを参照してください。

次の表は、 AWS CloudFormation テンプレートがユーザーに代わって実行できるアクションと、 AWS CloudFormation テンプレートに追加できる AWS リソースタイプとそのプロパティタイプに関する詳細情報へのリンクを示しています。

アクション AWS CloudFormation リファレンス 参照タイプ
CodeDeploy アプリケーションを作成します。 AWS::Codeデプロイ::アプリケーション AWS CloudFormation リソース
アプリケーションリビジョンのデプロイに使用されるデプロイグループの詳細を作成し、指定します。¹ AWS::CodeDeploy::DeploymentGroup AWS CloudFormation リソース
デプロイ中に CodeDeploy が使用するデプロイルール、デプロイの成功条件、デプロイ失敗条件のセットを作成します。 AWS::CodeDeploy::DeploymentConfig AWS CloudFormation リソース
Amazon EC2 インスタンスを作成します。² AWS::EC2::Instance AWS CloudFormation リソース
変換とAWS::CodeDeploy::BlueGreenフックを使用して AWS CloudFormation AWS::CodeDeployBlueGreen、 CodeDeploy ブルー/グリーンデプロイのスタック更新の管理、リソースの作成、トラフィックのシフトを行います。3 AWS::CodeDeployBlueGreen AWS::CodeDeployBlueGreen 変換は、 AWS CloudFormation によりホストされるマクロです。
AWS::CodeDeploy::BlueGreen AWS::CodeDeploy::BlueGreen フックは のHookリソースとして構造化されています AWS CloudFormation。フックには、指定された CodeDeployライフサイクルイベントフックを指すことで CodeDeploy AppSpec 、ファイルの代わりに使用されるパラメータが含まれます。

¹ デプロイグループの一部としてデプロイするアプリケーションリビジョンのバージョンを指定する場合、プロビジョニングプロセスが完了するとすぐに、ターゲットリビジョンがデプロイされます。テンプレート設定の詳細については、「 ユーザーガイドCodeDeploy DeploymentGroup 」の「デプロイリビジョン S3Location」とCodeDeploy DeploymentGroup 「デプロイリビジョン GitHubLocationAWS CloudFormation 」を参照してください。

2 がサポートされているリージョンに Amazon EC2 インスタンスを作成するために使用できるテンプレート CodeDeploy が用意されています。これらのテンプレートの使用の詳細については、「用の Amazon EC2 インスタンスを作成する CodeDeploy （AWS CloudFormation テンプレート）」を参照してください。

3このデプロイ設定では、 Amazon ECS ブルー/グリーンデプロイのみがサポートされています。 AWS CloudFormationによる Amazon ECS ブルー/グリーンデプロイのデプロイ構成の詳細については、「AWS CloudFormation blue/green デプロイのためのデプロイ設定 (Amazon ECS)」を参照してください。による Amazon ECS ブルー/グリーンデプロイ AWS CloudFormation と、 でデプロイを表示する方法の詳細については CodeDeploy、「」を参照してくださいを使用して Amazon ECS ブルー/グリーンデプロイを作成する AWS CloudFormation。