翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # CodeDeploy でデプロイ設定を使用する デプロイ設定とは、デプロイ中に CodeDeploy が使用する一連のルール、成功条件、および失敗条件です。これらのルールや条件は、EC2/オンプレミスのコンピューティングプラットフォーム、 AWS Lambda コンピューティングプラットフォーム、または Amazon ECS コンピューティングプラットフォームのいずれかにデプロイするかによって、異なります。 ## EC2/オンプレミスコンピューティングプラットフォームのデプロイ設定 EC2/オンプレミスコンピューティングプラットフォームにデプロイする場合、デプロイ設定では、「正常なホストの最小数」とオプションの「ゾーンあたりの正常なホストの最小数」の値を使用することで、デプロイ中のどの時点でも使用可能でなければならないインスタンスの数または割合 (%) を指定します。 が提供する 3 つの事前定義されたデプロイ設定のいずれかを使用する AWS か、カスタムデプロイ設定を作成できます。カスタムデプロイ設定の作成の詳細については、「[CodeDeploy を使用してデプロイ設定を作成する](deployment-configurations-create.md)」を参照してください。デプロイ設定を指定しない場合、CodeDeploy は、CodeDeployDefault.OneAtATime デプロイ設定を使用します。 CodeDeploy がデプロイ中にインスタンスのヘルス状態をモニタリングおよび評価する方法の詳細については、「[CodeDeploy インスタンスのヘルス](instances-health.md)」を参照してください。 AWS アカウントに既に登録されているデプロイ設定のリストを表示するには、「」を参照してください[CodeDeploy によるデプロイ設定の詳細の表示](deployment-configurations-view-details.md)。 ### EC2/オンプレミスコンピューティングプラットフォームの事前定義されたデプロイ設定 次の表は、定義済みのデプロイ設定を一覧表示します。 **注記** [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 つすべてのインスタンスへのデプロイが失敗した場合に限り失敗します。**ブルー/グリーンデプロイ** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/deployment-configurations.html) | | CodeDeployDefault.HalfAtATime | **インプレースデプロイ**: 一度に最大半分のインスタンスにデプロイします (端数は切り捨てられます)。デプロイ全体は、アプリケーションリビジョンが少なくとも半分のインスタンスにデプロイされた場合は成功です (端数は切り捨てられます)。それ以外の場合、デプロイは失敗です。9 つのインスタンスの例では、4 つまでのインスタンスに同時にデプロイされます。デプロイ全体は 5 つ以上のインスタンスへのデプロイが成功した場合は成功です。それ以外の場合、デプロイは失敗です。 複数の Auto Scaling グループのインスタンスにデプロイする場合、CodeDeploy は属する *Auto Scaling グループに関係なく*、一度に最大半分のインスタンスにデプロイします。例えば、Auto Scaling グループが `ASG1` と `ASG2` の 2 つあり、それぞれに 10 個のインスタンスがあるとします。このシナリオでは、CodeDeploy は `ASG1` のみで 10 個のインスタンスにデプロイできますが、少なくとも半数のインスタンスにデプロイされているため、成功と見なすことができます。 **ブルー/グリーンデプロイ** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/deployment-configurations.html) | | CodeDeployDefault.OneAtATime | **インプレースデプロイ**: 一度に 1 つのインスタンスにのみアプリケーションリビジョンをデプロイします。 複数のインスタンスを含むデプロイグループの場合。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/deployment-configurations.html) 1 つのインスタンスのみを含むデプロイグループでは、1 つのインスタンスへのデプロイが成功した場合にのみ、デプロイは全体は成功します。 **ブルー/グリーンデプロイ** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codedeploy/latest/userguide/deployment-configurations.html) | ## Amazon ECS コンピューティングプラットフォームのデプロイ設定 Amazon ECS コンピューティングプラットフォームにデプロイする場合、デプロイ設定より、更新された Amazon ECS タスクセットにトラフィックを移行する方法を指定します。**canary**、**リニア**、または**一度にすべて**のデプロイ設定を使用してトラフィックをシフトできます。詳細については、「[Deployment configuration](primary-components.md#primary-components-deployment-configuration)」を参照してください。 独自の Canary または線形のデプロイ設定を作成することもできます。詳細については、「[CodeDeploy を使用してデプロイ設定を作成する](deployment-configurations-create.md)」を参照してください。 ### Amazon ECS コンピューティングプラットフォームの事前定義されたデプロイ設定 以下の表に、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 ブルー/グリーンデプロイのデプロイ設定 (Amazon ECS) 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 コンピューティングプラットフォームでのデプロイ設定 AWS Lambda コンピューティングプラットフォームにデプロイする場合、デプロイ設定は、アプリケーションの新しい Lambda 関数バージョンにトラフィックを移行する方法を指定します。**canary**、**リニア**、または**一度にすべて**のデプロイ設定を使用してトラフィックをシフトできます。詳細については、「[Deployment configuration](primary-components.md#primary-components-deployment-configuration)」を参照してください。 独自の Canary または線形のデプロイ設定を作成することもできます。詳細については、「[CodeDeploy を使用してデプロイ設定を作成する](deployment-configurations-create.md)」を参照してください。 ### AWS Lambda コンピューティングプラットフォームの事前定義されたデプロイ設定 次の表に、 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 関数に一度に移行します。 | ## トピック + [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) # CodeDeploy を使用してデプロイ設定を作成する CodeDeploy に用意してあるデフォルトのデプロイ設定のいずれも使用しない場合は、次の手順を実行して独自のデプロイ設定を作成できます。 CodeDeploy コンソール、 AWS CLI CodeDeploy APIs、または CloudFormation テンプレートを使用して、カスタムデプロイ設定を作成できます。 CloudFormation テンプレートを使用してデプロイ設定を作成する方法については、「」を参照してください[CloudFormation CodeDeploy リファレンスの テンプレート](reference-cloudformation-templates.md)。 **Topics** + [デプロイ設定の作成 (コンソール)](#deployment-configurations-create-console) + [CodeDeploy を使用してデプロイ設定を作成する (AWS CLI)](#deployment-configurations-create-cli) ## デプロイ設定の作成 (コンソール) AWS コンソールを使用してデプロイ設定を作成するには、次の手順を実行します。 **コンソールを使用して CodeDeploy でデプロイ設定を作成するには** 1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) で CodeDeploy コンソールを開きます。 **注記** 「[CodeDeploy の開始方法](getting-started-codedeploy.md)」で設定したのと同じユーザーでサインインします。 1. ナビゲーションペインで **[デプロイ設定]** を選択します。 組み込みのデプロイ設定のリストが表示されます。 1. [**Create deployment configuration (デプロイ設定の作成)**] を選択します。 1. **[デプロイ設定名]** に、デプロイ設定の名前を入力します。例えば、**my-deployment-config**。 1. **[コンピューティングプラットフォーム]** で、次のいずれかを選択します。 + **EC2/オンプレミス** + **AWS Lambda** + **Amazon ECS** 1. 次のいずれかを行います。 + **EC2/オンプレミスを選択した場合**: 1. **[正常なホストの最小数]** で、デプロイ中のどの時点でも使用可能でなければならないインスタンスの数または割合を指定します。CodeDeploy がデプロイ中にインスタンスのヘルス状態をモニタリングおよび評価する方法の詳細については、「[CodeDeploy インスタンスのヘルス](instances-health.md)」を参照してください。 1. (オプション) **[ゾーン設定]** で、**[ゾーン設定を有効にする]** を選択すると、CodeDeploy は AWS リージョン内で一度に 1 つの[アベイラビリティーゾーン](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-availability-zones)にアプリケーションをデプロイします。一度に 1 つのアベイラビリティーゾーンにデプロイすることで、デプロイのパフォーマンスと実行可能性に対する信頼が高まるにつれて、デプロイを徐々に多くのユーザーに公開できます。ゾーン設定を有効にしない場合、CodeDeploy はリージョン内のランダムに選択されたホストにアプリケーションをデプロイします。 ゾーン設定機能を有効にする場合は、次の点に注意してください。 + ゾーン設定機能は、Amazon EC2 インスタンスへのインプレースデプロイでのみサポートされます (ブルー/グリーンデプロイやオンプレミスインスタンスはサポートされません)。インプレイスデプロイの詳細については、「[デプロイタイプ](primary-components.md#primary-components-deployment-type)」を参照してください。 + ゾーン設定機能は、[事前定義済みのデプロイ設定](deployment-configurations.md#deployment-configurations-predefined)ではサポートされません。ゾーン設定を使用するには、ここで説明しているように、カスタムデプロイ設定を作成する必要があります。 + CodeDeploy は、デプロイをロールバックする必要がある場合、ランダムなホストにロールバック操作を実行します (CodeDeploy は、想定とは異なり、一度に 1 つのゾーンを順にロールバックしません)。このロールバック動作は、パフォーマンス上の理由から選択されています。ロールバックの詳細については、「[CodeDeploy を使用した再デプロイおよびデプロイのロールバック](deployments-rollback-and-redeploy.md)」を参照してください。 1. **[ゾーン設定を有効にする]** チェックボックスをオンにした場合は、オプションで以下のオプションを指定します。 + (オプション) **[監視期間]** で、CodeDeploy が 1 つのアベイラビリティーゾーンへのデプロイを完了してから待機する時間を秒単位で指定します。CodeDeploy は、次のアベイラビリティーゾーンへのデプロイを開始する前に、この時間だけ待機します。デプロイが 1 つのアベイラビリティーゾーンで完了して次のゾーンに進む前に、一定時間を確保して完了を実証 (ベイク) する場合は、監視期間を追加することを検討します。監視期間を指定しない場合、CodeDeploy は次のアベイラビリティーゾーンへのデプロイをすぐに開始します。**[監視期間]** 設定の仕組みについては、「[アベイラビリティーゾーンあたりの正常なインスタンスの最小数について](instances-health.md#minimum-healthy-hosts-az)」を参照してください。 + (オプション) **[最初のゾーンに監視期間を追加]** を選択すると、最初のアベイラビリティーゾーンにのみ監視期間が設定されます。このオプションは、1 つ目のアベイラビリティーゾーンのベイク時間を確保する場合に設定できます。**[最初のゾーンの監視期間を追加]** に値を指定しない場合、CodeDeploy は最初のアベイラビリティーゾーンの **[監視期間]** の値を使用します。 + (オプション) **[ゾーンあたりの正常なホストの最小数]** で、デプロイ中に使用可能でなければならない、アベイラビリティーゾーンあたりのインスタンスの数または割合を指定します。**FLEET\$1PERCENT** を選択してパーセンテージを指定するか、**HOST\$1COUNT** を選択して数値を指定します。このフィールドは **[正常なホストの最小数]** フィールドと連動します。詳細については、「[アベイラビリティーゾーンあたりの正常なインスタンスの最小数について](instances-health.md#minimum-healthy-hosts-az)」を参照してください。 **[ゾーンあたりの正常なホストの最小数]** に値を指定しない場合、CodeDeploy はデフォルト値の `0` パーセントを使用します。 + **[AWS Lambda]** または **[Amazon ECS]** を選択した場合: 1. **[タイプ]**] で、**[リニア]** または **[Canary]** を選択します。 1. **[ステップ]** フィールドと **[間隔]** フィールドで、次のいずれかを行います。 + **[Canary]** を選択した場合は、**[ステップ]** に、移行するトラフィックのパーセンテージを 1～99 で入力します。この値は、最初の増分で移行されるトラフィックの割合を示します。残りのトラフィックは、2 回目の増分で、選択した間隔後に移行されます。 **[間隔]** に、1 番目と 2 番目のトラフィック移行間の分数を入力します。 + **[リニア]** を選択した場合は、**[ステップ]** に、移行するトラフィックのパーセンタージを 1～99 で入力します。この値は、各間隔の開始時に移行されるトラフィックの割合を示します。 **[間隔]** に、各増分移行間の分数を入力します。 1. [**Create deployment configuration (デプロイ設定の作成)**] を選択します。 これで、デプロイグループに関連付けることができるデプロイ設定が整いました。 ## CodeDeploy を使用してデプロイ設定を作成する (AWS CLI) を使用してデプロイ設定 AWS CLI を作成するには、[create-deployment-config](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment-config.html) コマンドを呼び出します。 次の例では、`ThreeQuartersHealthy` という名前の EC2/オンプレミスデプロイ設定を作成します。このデプロイ設定では、デプロイ中にターゲットインスタンスの 75% が常に正常であることが要求されます。 ``` aws deploy create-deployment-config --deployment-config-name ThreeQuartersHealthy --minimum-healthy-hosts type=FLEET_PERCENT,value=75 ``` 次の例では、`300Total50PerAZ` という名前の EC2/オンプレミスデプロイ設定を作成します。このデプロイ設定では、デプロイあたり合計 300 個のターゲットインスタンス、およびアベイラビリティーゾーンあたり 50 個のターゲットインスタンスが常に正常であることが要求されます。また、監視期間を 1 時間に設定します。 ``` aws deploy create-deployment-config --deployment-config-name 300Total50PerAZ --minimum-healthy-hosts type=HOST_COUNT,value=300 --zonal-config '{"monitorDurationInSeconds":3600,"minimumHealthyHostsPerZone":{"type":"HOST_COUNT","value":50}}' ``` 次の例では、 という名前の AWS Lambda デプロイ設定を作成します`Canary25Percent45Minutes`。この際、最初の増分でトラフィックの 25 パーセントを移行する Canary トラフィックを使用します。残りの 75 パーセントは 45 分後に移行されます。 ``` aws deploy create-deployment-config --deployment-config-name Canary25Percent45Minutes --traffic-routing-config "type="TimeBasedCanary",timeBasedCanary={canaryPercentage=25,canaryInterval=45}" --compute-platform Lambda ``` 次の例では、`Canary25Percent45Minutes` という名前の Amazon ECS デプロイ設定を作成します。この際、最初の増分でトラフィックの 25 パーセントを移行する Canary トラフィックを使用します。残りの 75 パーセントは 45 分後に移行されます。 ``` aws deploy create-deployment-config --deployment-config-name Canary25Percent45Minutes --traffic-routing-config "type="TimeBasedCanary",timeBasedCanary={canaryPercentage=25,canaryInterval=45}" --compute-platform ECS ``` # CodeDeploy によるデプロイ設定の詳細の表示 CodeDeploy コンソール、 AWS CLI、または CodeDeploy APIs を使用して、 AWS アカウントに関連付けられたデプロイ設定の詳細を表示できます。事前定義された CodeDeploy デプロイ設定の説明については、「[EC2/オンプレミスコンピューティングプラットフォームの事前定義されたデプロイ設定](deployment-configurations.md#deployment-configurations-predefined)」を参照してください。 **Topics** + [デプロイ設定の詳細の表示 (コンソール)](#deployment-configurations-view-details-console) + [デプロイ設定の表示 (CLI)](#deployment-configurations-view-details-cli) ## デプロイ設定の詳細の表示 (コンソール) CodeDeploy コンソールを使用して、デプロイ設定名の一覧を表示するには: 1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) で CodeDeploy コンソールを開きます。 **注記** 「[CodeDeploy の開始方法](getting-started-codedeploy.md)」で設定したのと同じユーザーでサインインします。 1. ナビゲーションペインで [**デプロイ**] を展開し、[**デプロイ設定**] を選択します。 コンソールで、各デプロイ設定のデプロイ設定名および条件の一覧を表示できます。 **注記** エントリが表示されない場合は、正しいリージョンが選択されていることを確認しましょう。ナビゲーションバーのリージョンセレクターで、「AWS 全般のリファレンス」**の「[リージョンとエンドポイント](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region)」に一覧表示されているいずれかのリージョンを選択します。CodeDeploy は、これらのリージョンでのみサポートされています。 ## デプロイ設定の表示 (CLI) を使用してデプロイ設定の詳細 AWS CLI を表示するには、 `get-deployment-config` コマンドまたは `list-deployment-configs` コマンドを呼び出します。 1 つのデプロイ設定に関する詳細を表示するには、[get-deployment-config](https://docs.aws.amazon.com/cli/latest/reference/deploy/get-deployment-config.html) コマンドを呼び出し、一意のデプロイ設定名を指定します。 複数のデプロイ設定に関する詳細を表示するには、[list-deployments](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployments.html) コマンドを呼び出します。 # CodeDeploy を使用してデプロイ設定を削除する AWS CLI または CodeDeploy APIs を使用して、 AWS アカウントに関連付けられたカスタムデプロイ設定を削除できます。`CodeDeployDefault.AllAtOnce`、`CodeDeployDefault.HalfAtATime`、`CodeDeployDefault.OneAtATime` などの組み込みのデプロイ設定は削除できません。 **警告** まだ使用中のカスタムデプロイ設定は削除できません。未使用のカスタムデプロイ設定を削除すると、それを新しいデプロイおよび新規デプロイグループに関連付けることはできなくなります。このアクションを元に戻すことはできません。 を使用してデプロイ設定 AWS CLI を削除するには、[delete-deployment-config](https://docs.aws.amazon.com/cli/latest/reference/deploy/delete-deployment-config.html) コマンドを呼び出し、デプロイ設定名を指定します。デプロイ設定名のリストを表示するには、[list-deployment-configs](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-configs.html) コマンドを呼び出します。 次の例では、ThreeQuartersHealthy という名前のデプロイ設定を削除します。 ``` aws deploy delete-deployment-config --deployment-config-name ThreeQuartersHealthy ```