Amazon ECS デプロイサーキットブレーカーが障害を検出する方法

デプロイサーキットブレーカーは、タスクが定常状態に到達したかどうかを判断する、ローリング更新メカニズムです。デプロイサーキットブレーカーには、デプロイが失敗した場合に、 COMPLETED 状態のデプロイに自動的にロールバックするオプションがあります。回路ブレーカーが障害をカウントする方法と、トリガーとなるしきい値をカスタマイズできるため、ロールバック動作をアプリケーションのスタートアップ特性とタスク障害に対する許容度に合わせることができます。

サービスデプロイの状態が変わったとき、Amazon ECS はサービスデプロイ状態変更イベントを EventBridge に送信します。これにより、サービスデプロイの状態を監視するためのプログラムによる方法がもたらされます。詳細については、「Amazon ECS サービスデプロイ状態変更イベント」を参照してください。デプロイを開始するための手動アクションを実行できるように、eventName が SERVICE_DEPLOYMENT_FAILED の EventBridge ルールをを使用して作成および監視することをお勧めします。詳細については、「Amazon EventBridge ユーザーガイド」の「EventBridge の開始方法」を参照してください。

デプロイサーキットブレーカーは、デプロイが失敗したと判断すると、COMPLETED 状態にある最新のデプロイを探します。このデプロイをロールバックデプロイとして使用します。ロールバックが開始されると、デプロイは COMPLETED から IN_PROGRESS に変わります。つまり、デプロイは COMPLETED 状態になるまで次のロールバックの対象にはなりません。デプロイサーキットブレーカーが COMPLETED 状態のデプロイを見つけられない場合、サーキットブレーカーは新しいタスクを起動せず、デプロイは停止します。

サービスを作成すると、スケジューラーは起動に失敗したタスクを 2 段階で追跡します。

サービスでデプロイサーキットブレーカーメソッドを使用する際には、以下を考慮してください。EventBridge がルールを生成します。

以下の create-service AWS CLI の例は、デプロイサーキットブレーカーと共にロールバックオプションが使用されている場合の Linux サービスの作成方法を示しています。

aws ecs create-service \
     --service-name MyService \
     --deployment-controller type=ECS \
     --desired-count 3 \
     --deployment-configuration "deploymentCircuitBreaker={enable=true,rollback=true}" \
     --task-definition sample-fargate:1 \
     --launch-type FARGATE \
     --platform-family LINUX \
     --platform-version 1.4.0 \
     --network-configuration "awsvpcConfiguration={subnets=[subnet-12344321],securityGroups=[sg-12344321],assignPublicIp=ENABLED}"

次の create-service AWS CLI 例は、固定障害数 5 と累積障害追跡を使用するカスタムデプロイサーキットブレーカー設定でサービスを作成する方法を示しています。

aws ecs create-service \
     --service-name MyService \
     --deployment-controller type=ECS \
     --desired-count 10 \
     --deployment-configuration "deploymentCircuitBreaker={enable=true,rollback=true,resetOnHealthyTask=false,thresholdConfiguration={type=COUNT,value=5}}" \
     --task-definition sample-fargate:1 \
     --launch-type FARGATE \
     --platform-family LINUX \
     --platform-version 1.4.0 \
     --network-configuration "awsvpcConfiguration={subnets=[subnet-12344321],securityGroups=[sg-12344321],assignPublicIp=ENABLED}"

例:

デプロイ 1 は COMPLETED 状態にあります。

デプロイ 2 は起動できないため、サーキットブレーカーはデプロイ 1 にロールバックされます。デプロイ 1 は IN_PROGRESS 状態に移行します。

デプロイ 3 が開始され、COMPLETED 状態のデプロイがないため、デプロイ 3 はロールバックやタスクの起動ができません。

失敗しきい値

デプロイサーキットブレーカは、デプロイを FAILED 状態にいつ移行するかを決定するためのしきい値を計算します。障害のカウント方法としきい値自体の両方を設定できます。

失敗回数モード

resetOnHealthyTask の設定は、デプロイ中にサーキットブレーカーがタスクの失敗をカウントする方法を制御します。

しきい値の設定

thresholdConfiguration の設定では、サーキットブレーカーがトリガーされるタイミングを定義します。これには、しきい値の計算方法を決定する type と、使用する割合または数を指定する value が含まれます。

パーセンテージタイプ (BOUNDED_PERCENT および UNBOUNDED_PERCENT) の場合、value の有効範囲は 1～100 です。デプロイ中、Amazon ECS は計算において常に最新のサービス要求数を使用します。

BOUNDED_PERCENT がしきい値を計算する方法

デフォルトの BOUNDED_PERCENT のしきい値タイプを使用すると、デプロイサーキットブレーカーは次の式を使用してしきい値を計算します。

Minimum threshold (3) <= (value/100) * desired task count => Maximum threshold (200)

計算の結果が最小値 3 を下回った場合、しきい値は 3 に設定されます。結果が 200 より大きい場合、しきい値は 200 に設定されます。それ以外の場合、しきい値は計算された値 (切り上げ) に設定されます。

次の表は、デフォルト値の 50 を使用した例を示しています。

3 <= 0.5 * 1 => 200

3 <= 0.5 * 25 => 200

3 <= 0.5 * 400 => 200

3 <= 0.5 * 800 => 200

UNBOUNDED_PERCENT では、同じ計算が適用されますが、最小値と最大値の制限はありません。例えば、目標件数が 800 で値が 50 のサービスの場合、しきい値は 400 になります。

デプロイステータスチェックには 2 つの段階があります。

たとえば、しきい値が 3 の場合、サーキットブレーカーは故障回数が 0 に設定された状態で起動します。タスクが RUNNING 状態に到達できなかった場合、デプロイサーキットブレーカは故障数を 1 つ増やします。障害カウントが 3 である場合、デプロイは FAILED としてマークされます。

ロールバックオプションの使用方法に関するその他の例については、「Amazon ECS デプロイサーキットブレーカーのお知らせ」を参照してください。