デプロイグループの詳細オプションの設定 - AWS CodeDeploy

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

デプロイグループの詳細オプションの設定

デプロイグループを作成または更新する場合は、そのデプロイグループのデプロイをより詳細に制御および監視できるように、数多くのオプションを設定できます。

このページの情報を使用して、次のトピックで、デプロイグループを使用するときに詳細オプションを設定できます。

Amazon SNS 通知トリガー: CodeDeploy デプロイグループにトリガーを追加して、そのデプロイグループ内のデプロイに関連するイベントに関する通知を受け取ることができます。これらの通知は、トリガーのアクションの一部にした Amazon SNS トピックをサブスクライブする受信者に送信されます。

このトリガーがポイントする Amazon SNS トピックを既に設定していて CodeDeploy、このデプロイグループからトピックに発行するアクセス許可を持っている必要があります。これらのセットアップ手順をまだ完了していない場合は、後でデプロイグループにトリガーを追加できます。

このアプリケーションのデプロイグループのデプロイイベントに関する通知を受信するトリガーを今すぐ作成する場合は、[Create trigger] を選択します。

Amazon EC2 インスタンスにデプロイする場合、インスタンスの通知を作成して、関連する通知を受け取ることができます。

詳細については、「Monitoring Deployments with Amazon SNS Event Notifications」を参照してください。

Amazon CloudWatch アラーム : 指定した期間にわたって単一のメトリクスを監視し、複数の期間にわたって特定のしきい値に対するメトリクスの値に基づいて 1 つ以上のアクションを実行する CloudWatch アラームを作成できます。Amazon EC2 デプロイでは、 CodeDeploy オペレーションで使用しているインスタンスまたは Amazon EC2 Auto Scaling グループのアラームを作成できます。 AWS Lambda および Amazon ECS デプロイでは、Lambda 関数のエラーのアラームを作成できます。

Amazon CloudWatch アラームがメトリクスが定義されたしきい値を下回った、または超えたことを検出したときに停止するようにデプロイを設定できます。

デプロイグループに追加 CloudWatch する前に、 でアラームを作成しておく必要があります。

  1. デプロイグループにアラームモニタリングを追加するには、[アラーム]、[アラームの追加] の順に選択します。

  2. このデプロイをモニタリングするために設定済みの CloudWatch アラームの名前を入力します。

    CloudWatch アラームは、 で作成されたとおりに入力する必要があります CloudWatch。アラームのリストを表示するには、 で CloudWatch コンソールを開きhttps://console.aws.amazon.com/cloudwatch/ALARM を選択します。

追加のオプション:

  • 追加したアラームを想定せずにデプロイを続行する場合は、[Ignore alarm configuration] を選択します。

    この選択は、後で同じアラームを再び追加しなくても、デプロイグループのアラームの監視を一時的に非アクティブ化する場合に便利です。

  • (オプション) Amazon からアラームステータスを取得 CodeDeploy できない場合にデプロイを続行するには CloudWatch、アラームステータスが使用できない場合でもデプロイを継続するを選択します。

    注記

    このオプションは、 CodeDeploy API ignorePollAlarmFailureAlarmConfiguration オブジェクトの に対応します。

詳細については、「での CloudWatch アラームによるデプロイのモニタリング CodeDeploy」を参照してください。

自動ロールバック: デプロイが失敗した場合、または監視しきい値が満たされた場合に、自動的にロールバックするようにデプロイグループまたはデプロイを設定できます。この場合、アプリケーションリビジョンの最後の既知の正常なバージョンがデプロイされます。コンソールを使用してアプリケーションを作成する場合、デプロイグループを作成する場合、またはデプロイグループを更新する場合、デプロイグループのオプション設定を設定できます。新しいデプロイを作成するとき、デプロイグループに指定された自動ロールバック設定をオーバーライドすることもできます。

  • 次のいずれかまたは両方を選択して何か問題が発生した場合、デプロイを有効化して最新の既知の正常なリビジョンにロールバックすることができます。

    • デプロイが に失敗すると、ロールバックします。 CodeDeploy は、既知の最後の正常なリビジョンを新しいデプロイとして再デプロイします。

    • アラームのしきい値が一致したときにロールバックする。前のステップでこのアプリケーションにアラームを追加した場合、指定したアラームの 1 つ以上がアクティブ化されると、 CodeDeploy は最後に正常な既知のリビジョンを再デプロイします。

    注記

    ロールバック設定を一時的に無視するには、[Disable rollbacks] を選択します。この選択は、後で再び同じ設定をセットアップせずに自動ロールバックを一時的に無効にする場合に便利です。

    詳細については、「でデプロイを再デプロイしてロールバックする CodeDeploy」を参照してください。

古いインスタンスへの自動更新: 特定の状況では、アプリケーションの古いリビジョンを Amazon EC2 インスタンスにデプロイ CodeDeploy することがあります。例えば、 CodeDeploy デプロイの進行中に EC2 インスタンスが Auto Scaling グループ (ASG) で起動された場合、それらのインスタンスは最新のリビジョンではなく、アプリケーションの古いリビジョンを受け取ります。これらのインスタンスを最新の状態に保つために、 は、古いインスタンスを更新するためのフォローオンデプロイ CodeDeploy を自動的に開始します (最初のインスタンスの後に即時に)。古い EC2 インスタンスを古いリビジョンに残すようにこのデフォルトの動作を変更する場合は、 CodeDeploy API または AWS Command Line Interface (CLI) を使用して変更できます。

API を使用して古くなったインスタンスの自動更新を設定するには、outdatedInstancesStrategy または UpdateDeploymentGroup のアクションに CreateDeploymentGroup リクエストパラメータを含めます。詳細については、「AWS CodeDeploy API リファレンス」を参照してください。

を使用して自動更新を設定するには AWS CLI、次のいずれかのコマンドを使用します。

aws deploy update-deployment-group arguments --outdated-instances-strategy UPDATE|IGNORE

または…

aws deploy create-deployment-group arguments --outdated-instances-strategy UPDATE|IGNORE

... ここで、引数 は、デプロイに必要な引数に置き換えられ、UPDATE|IGNORE は自動更新を有効にする場合は UPDATE、無効にする場合は IGNORE に置き換わります。

例:

aws deploy update-deployment-group --application-name "MyApp" --current-deployment-group-name "MyDG" --region us-east-1 --outdated-instances-strategy IGNORE

これらの AWS CLI コマンドの詳細については、AWS CLI 「 コマンドリファレンス」を参照してください。