メニュー
AWS CloudFormation
ユーザーガイド (API Version 2010-05-15)

AWS::CodeDeploy::DeploymentConfig

AWS::CodeDeploy::DeploymentConfig リソースは、デプロイ中に AWS CodeDeploy が使用するデプロイのルール、デプロイの成功条件、デプロイの失敗条件を作成します。デプロイ設定では、MinimumHealthyHosts の値を使用して、デプロイ中に使用可能な状態に維持する必要のあるインスタンスの数または割合を指定します。

構文

AWS CloudFormation テンプレートでこのエンティティを宣言するには、次の構文を使用します。

JSON

Copy
{ "Type" : "AWS::CodeDeploy::DeploymentConfig", "Properties" : { "DeploymentConfigName" : String, "MinimumHealthyHosts" : MinimumHealthyHosts } }

YAML

Copy
Type: "AWS::CodeDeploy::DeploymentConfig" Properties: DeploymentConfigName: String MinimumHealthyHosts: MinimumHealthyHosts

プロパティ

DeploymentConfigName

デプロイ設定の名前。名前を指定しない場合、AWS CloudFormation は一意の物理 ID を生成し、その ID をデプロイ設定名として使用します。詳細については、「Name タイプ」を参照してください。

重要

名前を指定すると、このリソースの置換が必要な更新はできません。中断が不要であるか、一定の中断が必要な更新であれば、行うことができます。リソースを置き換える必要がある場合は、新しい名前を指定します。

必須: いいえ

Type: String

更新に伴う要件: 置換

MinimumHealthyHosts

AWS CodeDeploy デプロイの間のいつでも使用可能でなければならない正常なインスタンスの最小数。たとえば、9 個のインスタンス群の場合に最低 6 個の正常なインスタンスを指定すると、AWS CodeDeploy はアプリケーションに一度に最大 3 個のインスタンスをデプロイして、正常なインスタンスが常に 6 個維持されるようにします。アプリケーションが 6 個以上のインスタンスのデプロイに成功すれば、デプロイは成功で、そうでない場合、デプロイ失敗となります。

インスタンスの状態の詳細については、「AWS CodeDeploy Instance Health」(AWS CodeDeploy User Guide) を参照してください。

Required: Yes

タイプ: AWS CodeDeploy DeploymentConfig MinimumHealthyHosts

更新に伴う要件: 置換

戻り値

参照番号

AWS::CodeDeploy::DeploymentConfig リソースの論理 ID を組み込み Ref 関数に渡すと、関数はデプロイ設定名 (mydeploymentconfig-a123d0d1 など) を返します。

Ref 関数の使用方法の詳細については、「Ref」を参照してください。

次の例では、インスタンスの少なくとも 75% が正常である必要があります。たとえば、4 個のインスタンス群がある場合、デプロイは一度に 1 個のインスタンスを処理します。

JSON

Copy
"TwentyFivePercentAtATime" : { "Type" : "AWS::CodeDeploy::DeploymentConfig", "Properties" : { "MinimumHealthyHosts" : { "Type" : "FLEET_PERCENT", "Value" : "75" } } }

YAML

Copy
TwentyFivePercentAtATime: Type: "AWS::CodeDeploy::DeploymentConfig" Properties: MinimumHealthyHosts: Type: "FLEET_PERCENT" Value: 75

このページの内容: