

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

# CodeDeploy でデプロイ設定を使用する
<a name="deployment-configurations"></a>

デプロイ設定とは、デプロイ中に CodeDeploy が使用する一連のルール、成功条件、および失敗条件です。これらのルールや条件は、EC2/オンプレミスのコンピューティングプラットフォーム、 AWS Lambda コンピューティングプラットフォーム、または Amazon ECS コンピューティングプラットフォームのいずれかにデプロイするかによって、異なります。

## EC2/オンプレミスコンピューティングプラットフォームのデプロイ設定
<a name="deployment-configuration-server"></a>



EC2/オンプレミスコンピューティングプラットフォームにデプロイする場合、デプロイ設定では、「正常なホストの最小数」とオプションの「ゾーンあたりの正常なホストの最小数」の値を使用することで、デプロイ中のどの時点でも使用可能でなければならないインスタンスの数または割合 (%) を指定します。

が提供する 3 つの事前定義されたデプロイ設定のいずれかを使用する AWS か、カスタムデプロイ設定を作成できます。カスタムデプロイ設定の作成の詳細については、「[CodeDeploy を使用してデプロイ設定を作成する](deployment-configurations-create.md)」を参照してください。デプロイ設定を指定しない場合、CodeDeploy は、CodeDeployDefault.OneAtATime デプロイ設定を使用します。

CodeDeploy がデプロイ中にインスタンスのヘルス状態をモニタリングおよび評価する方法の詳細については、「[CodeDeploy インスタンスのヘルス](instances-health.md)」を参照してください。 AWS アカウントに既に登録されているデプロイ設定のリストを表示するには、「」を参照してください[CodeDeploy によるデプロイ設定の詳細の表示](deployment-configurations-view-details.md)。

### EC2/オンプレミスコンピューティングプラットフォームの事前定義されたデプロイ設定
<a name="deployment-configurations-predefined"></a>

次の表は、定義済みのデプロイ設定を一覧表示します。

**注記**  
[zonal configuration](deployment-configurations-create.md#zonal-config) 機能 (アベイラビリティーゾーンあたりの正常なホストの数を指定できる機能) をサポートする定義済みのデプロイ設定はありません。この機能を使用する場合は、[独自のデプロイ設定を作成する](deployment-configurations-create.md)必要があります。


****  

| Deployment configuration | 説明 | 
| --- | --- | 
| CodeDeployDefault.AllAtOnce | **インプレースデプロイ**:一度に可能な限り多くのインスタンスへアプリケーションリビジョンをデプロイするよう試みます。アプリケーションリビジョンが 1 つ以上のインスタンスにデプロイされる場合、デプロイ全体のステータスは Succeeded として表示されます。アプリケーションリビジョンがいずれのインスタンスにもデプロイされない場合、デプロイ全体のステータスは Failed として表示されます。9 つのインスタンスの例を使い、CodeDeployDefault.AllAtOnce は、一度に 9 つのインスタンスすべてにデプロイするよう試みます。インスタンスへのデプロイが 1 つでも成功すると、デプロイ全体は成功します。9 つすべてのインスタンスへのデプロイが失敗した場合に限り失敗します。<br />**ブルー/グリーンデプロイ** [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/deployment-configurations.html) | 
| CodeDeployDefault.HalfAtATime | **インプレースデプロイ**:<br />一度に最大半分のインスタンスにデプロイします (端数は切り捨てられます)。デプロイ全体は、アプリケーションリビジョンが少なくとも半分のインスタンスにデプロイされた場合は成功です (端数は切り捨てられます)。それ以外の場合、デプロイは失敗です。9 つのインスタンスの例では、4 つまでのインスタンスに同時にデプロイされます。デプロイ全体は 5 つ以上のインスタンスへのデプロイが成功した場合は成功です。それ以外の場合、デプロイは失敗です。 複数の Auto Scaling グループのインスタンスにデプロイする場合、CodeDeploy は属する *Auto Scaling グループに関係なく*、一度に最大半分のインスタンスにデプロイします。例えば、Auto Scaling グループが `ASG1` と `ASG2` の 2 つあり、それぞれに 10 個のインスタンスがあるとします。このシナリオでは、CodeDeploy は `ASG1` のみで 10 個のインスタンスにデプロイできますが、少なくとも半数のインスタンスにデプロイされているため、成功と見なすことができます。 <br />**ブルー/グリーンデプロイ** [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/deployment-configurations.html) | 
| CodeDeployDefault.OneAtATime | **インプレースデプロイ**:<br />一度に 1 つのインスタンスにのみアプリケーションリビジョンをデプロイします。<br />複数のインスタンスを含むデプロイグループの場合。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/deployment-configurations.html)<br />1 つのインスタンスのみを含むデプロイグループでは、1 つのインスタンスへのデプロイが成功した場合にのみ、デプロイは全体は成功します。<br />**ブルー/グリーンデプロイ**[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/deployment-configurations.html) | 

## Amazon ECS コンピューティングプラットフォームのデプロイ設定
<a name="deployment-configuration-ecs"></a>

Amazon ECS コンピューティングプラットフォームにデプロイする場合、デプロイ設定より、更新された Amazon ECS タスクセットにトラフィックを移行する方法を指定します。**canary**、**リニア**、または**一度にすべて**のデプロイ設定を使用してトラフィックをシフトできます。詳細については、「[Deployment configuration](primary-components.md#primary-components-deployment-configuration)」を参照してください。

独自の Canary または線形のデプロイ設定を作成することもできます。詳細については、「[CodeDeploy を使用してデプロイ設定を作成する](deployment-configurations-create.md)」を参照してください。

### Amazon ECS コンピューティングプラットフォームの事前定義されたデプロイ設定
<a name="deployment-configurations-predefined-ecs"></a>

以下の表に、Amazon ECS のデプロイで利用できる事前定義された設定を一覧表示します。

**注記**  
Network Load Balancer を使用する場合、`CodeDeployDefault.ECSAllAtOnce` 優先デプロイ設定のみがサポートされます。


****  

| Deployment configuration | 説明 | 
| --- | --- | 
| CodeDeployDefault.ECSLinear10PercentEvery1Minutes | すべてのトラフィックが移行されるまで、毎分トラフィックの 10 パーセントを移行します。 | 
| CodeDeployDefault.ECSLinear10PercentEvery3Minutes  | すべてのトラフィックが移行されるまで、3 分ごとにトラフィックの 10 パーセントを移行します。 | 
| CodeDeployDefault.ECSCanary10Percent5Minutes | 最初の増分でトラフィックの 10 パーセントを移行します。残りの 90 パーセントは 5 分後にデプロイされます。 | 
| CodeDeployDefault.ECSCanary10Percent15Minutes | 最初の増分でトラフィックの 10 パーセントを移行します。残りの 90% は 15 分後にデプロイされます。 | 
| CodeDeployDefault.ECSAllAtOnce | すべてのトラフィックを同時に更新済み Amazon ECS コンテナに移行します。 | 

## CloudFormation Blue/Green デプロイのデプロイ設定 (Amazon ECS)
<a name="deployment-configuration-cfn-bg"></a>

 CloudFormation Blue/Green デプロイを介して Amazon ECS コンピューティングプラットフォームにデプロイする場合、デプロイ設定は、更新された Amazon ECS コンテナへのトラフィックの移行方法を指定します。**canary**、**リニア**、または**一度にすべて**のデプロイ設定を使用してトラフィックをシフトできます。詳細については、「[Deployment configuration](primary-components.md#primary-components-deployment-configuration)」を参照してください。

Blue CloudFormation /Green デプロイでは、独自のカスタム Canary または線形デプロイ設定を作成することはできません。 CloudFormation を使用して Amazon ECS ブルー/グリーンデプロイを管理するstep-by-stepについては、 *CloudFormation ユーザーガイド*の「 [を使用した CodeDeploy による ECS ブルー/グリーンデプロイの自動化 CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/blue-green.html)」を参照してください。

**注記**  
を使用した Amazon ECS ブルー/グリーンデプロイの管理 CloudFormation は、欧州 (ミラノ）、アフリカ (ケープタウン）、アジアパシフィック (大阪) リージョンでは利用できません。

## AWS Lambda コンピューティングプラットフォームでのデプロイ設定
<a name="deployment-configuration-lambda"></a>

 AWS Lambda コンピューティングプラットフォームにデプロイする場合、デプロイ設定は、アプリケーションの新しい Lambda 関数バージョンにトラフィックを移行する方法を指定します。**canary**、**リニア**、または**一度にすべて**のデプロイ設定を使用してトラフィックをシフトできます。詳細については、「[Deployment configuration](primary-components.md#primary-components-deployment-configuration)」を参照してください。

独自の Canary または線形のデプロイ設定を作成することもできます。詳細については、「[CodeDeploy を使用してデプロイ設定を作成する](deployment-configurations-create.md)」を参照してください。

### AWS Lambda コンピューティングプラットフォームの事前定義されたデプロイ設定
<a name="deployment-configurations-predefined-lambda"></a>

次の表に、 AWS Lambda のデプロイで利用できる事前定義された設定を一覧表示します。


****  

| Deployment configuration | 説明 | 
| --- | --- | 
| CodeDeployDefault.LambdaCanary10Percent5Minutes | 最初の増分でトラフィックの 10 パーセントを移行します。残りの 90 パーセントは 5 分後にデプロイされます。 | 
| CodeDeployDefault.LambdaCanary10Percent10Minutes | 最初の増分でトラフィックの 10 パーセントを移行します。残りの 90 パーセントは 10 分後にデプロイされます。 | 
| CodeDeployDefault.LambdaCanary10Percent15Minutes | 最初の増分でトラフィックの 10 パーセントを移行します。残りの 90% は 15 分後にデプロイされます。 | 
| CodeDeployDefault.LambdaCanary10Percent30Minutes | 最初の増分でトラフィックの 10 パーセントを移行します。残りの 90 パーセントは 30 分後にデプロイされます。 | 
| CodeDeployDefault.LambdaLinear10PercentEvery1Minute | すべてのトラフィックが移行されるまで、毎分トラフィックの 10 パーセントを移行します。 | 
| CodeDeployDefault.LambdaLinear10PercentEvery2Minutes | すべてのトラフィックが移行されるまで、2 分ごとにトラフィックの 10 パーセントを移行します。 | 
| CodeDeployDefault.LambdaLinear10PercentEvery3Minutes | すべてのトラフィックが移行されるまで、3 分ごとにトラフィックの 10 パーセントを移行します。 | 
| CodeDeployDefault.LambdaLinear10PercentEvery10Minutes | すべてのトラフィックが移行されるまで、10 分ごとにトラフィックの 10 パーセントを移行します。 | 
|  CodeDeployDefault.LambdaAllAtOnce  | すべてのトラフィックは、更新された Lambda 関数に一度に移行します。 | 

## トピック
<a name="topiclist-deployment-configurations"></a>
+ [Create a Deployment Configuration](deployment-configurations-create.md)
+ [View Deployment Configuration Details](deployment-configurations-view-details.md)
+ [Delete a Deployment Configuration](deployment-configurations-delete.md)