AWS Fargate Spot タスクで Spot 終了通知を処理するにはどうすればよいですか?

最終更新日: 2023 年 1 月 6 日

Fargate Spot を使用すると、中断に耐性のある Amazon Elastic Container Service (Amazon ECS) タスクを実行できます。終了通知は、Fargate Spot タスクが終了する 2 分前に受信する警告です。この警告は、アプリケーションに正常なシャットダウンに備える時間を与えることで、Spot の中断を管理するのに役立ちます。終了通知は、Fargate Spot タスクが終了対象としてマークされるとすぐに作成されます。通知には、実行中の Fargate Spot タスクが終了する時刻が示されます。警告は、Amazon EventBridge にタスク状態変更イベントとして送信され、実行中のタスクに SIGTERM シグナルとして送信されます。

タスクが停止する前に Fargate Spot 上のコンテナが確実に終了するようにするには、タスクが使用するコンテナ定義で stopTimeout 値を 120 秒以下に指定します。stopTimeout 値を指定することで、コンテナが正常に終了する時間を設定できます。この時間が経過すると、コンテナは強制的に停止されます。

注: 指定できる stopTimeout の最大値は 120 秒です。このパラメータに値を指定しない場合、デフォルト値の 30 秒が使用されます。

Fargate Spot を使用する Amazon ECS サービスで中断シグナルを受信すると、サービススケジューラは追加のキャパシティが利用可能かどうかを判断します。サービススケジューラは、minimumHealthyPercent と maximumPercent の値を使用してこの判断を行います。キャパシティが使用可能な場合、サービススケジューラは Fargate Spot で追加のタスクの起動を試みます。ただし、サービススケジューラが新しいタスク用の容量を見つけられなかった場合、stopTimeout 期間が経過すると古いタスクは終了します。

ロードバランサーで Fargate Spot を使用する場合は、次の点を考慮してください。

• FARGATE_SPOT として実行されるタスクは、タスクが STOPPED 状態に移行するまで、ロードバランサーのターゲットグループから登録解除されない場合があります。
• FARGATE_SPOT では、2 分以内に、タスクがシャットダウンされる前にターゲットグループの登録を解除する必要があります。つまり、FARGATE_SPOT に関連付けられているターゲットグループの登録解除の遅延を 2 分未満の値に設定する必要があります。

キャパシティが使用不可であったり、Fargate Spot のキャパシティが取り戻されたりすると、ECS サービススケジューラは新しいタスクを開始できません。代わりに、スケジューラーは 2 分前に通知した後に既存のタスクを終了します。ただし、これらのイベントは Amazon ECS コンソールではレポートされません。

ECS からのイベントは、ほぼリアルタイムで EventBridge に配信されます。したがって、選択したイベントと、イベントがルールに一致したときに自動的に実行されるアクションを示す簡単なルールを記述するのがベストプラクティスです。この記事では、次のユースケース向けの EventBridge ルールについて説明します。

• FARGATE_SPOT タスクが Fargate Spot の中断によりシャットダウンされた。
• Fargate Spot 容量が使用できないために FARGATE_SPOT タスクを配置できない。

Fargate Spot の中断の停止理由と停止コードを表示するタスク状態変更イベントのスニペットを次に示します。

{
  "version": "0",
  "id": "a99d3f53-4a7c-4153-a1a5-48957fc83b8f",
  "detail-type": "ECS Task State Change",
  "source": "aws.ecs",
  "account": "1111222233334444",
  "resources": [
    "arn:aws:ecs:ap-southeast-2:1111222233334444:task/4be29e5b-b05c-42a2-a596-be62090eea9b"
  ],
  "detail": {
    "clusterArn": "arn:aws:ecs:ap-southeast-2:1111222233334444:cluster/default",
    "createdAt": "2022-02-25T10:13:08.455Z",
    "desiredStatus": "STOPPED",
    "lastStatus": "RUNNING",
    "stoppedReason": "Your Spot Task was interrupted.",
    "stopCode": "SpotInterruption",
    "taskArn": "arn:aws:ecs:ap-southeast-2:1111222233334444:task/4be29e5b-b05c-42a2-a596-be62090eea9bEXAMPLE",
    ...
  }
}

Fargate Spot の中断によりタスクが停止した場合、stopCode は SpotInterruption として言及されることに注意してください。FARGATE_SPOT タスクが SpotInterruption によって停止されるたびに Amazon Simple Notification Service (Amazon SNS) アラートを送信する EventBridge ルールを作成できます。

次を実行します。

1.    Amazon SNS トピックを作成します。

2.    このユースケース向けの EventBridge ルールを作成します。

このユースケース向けの EventBridge ルールを作成するには、次の手順を実行します。

1.    Amazon EventBridge コンソールを開きます。

2.    ナビゲーションペインで [Rules★] をクリックします。

3.    [Create rule] (ルールの作成) を選択します。

4.    ルールの名前と説明を入力します。

5.    [Event bus] (イベントバスを選択) で、[AWS default event bus] (AWS デフォルトイベントバス) を選択します。

6.    [Rule type] (ルールタイプ) で、[Rule with an event pattern] (イベントパターンを含むルール) を選択します。

7.    [次へ] を選択します。

8.    [Event source] (イベントソース) で、[AWS services] (AWS のサービス) を選択します。

9.    [Event pattern] (イベントパターン) で、[Custom patterns (JSON editor)] (カスタムパターン (JSON エディタ)) を選択し、次のパターンを追加します。

{
  "source": [
    "aws.ecs"
  ],
  "detail-type": [
    "ECS Task State Change"
  ],
  "detail": {
    "stopCode": [
      "SpotInterruption"
    ],
    "clusterArn": [
      "arn:aws:ecs:exampleregion:1111222233334444:cluster/examplecluster"
    ]
  }
}

10.    [Next] (次へ) を選択します。

11.    [Target types] (ターゲットタイプ) で、[AWS service] (AWS のサービス) を選択します。

12.    [Select a target] (ターゲットを選択) で、[SNS topic] (SNS トピック) を選択します。

13.    [Topic] (トピック) で、作成した SNS トピックを選択します。

14.    [Next] (次へ) を選択します。

15.    [configure tags - optional] (タグを設定 - オプション) ページで、[Next] (次へ) を選択します。

16.    オプションを確認し、[Create rule] (ルールを作成) を選択します。

次の条件下で発生したサービスタスク配置失敗イベントのスニペットを次に示します。

• タスクは FARGATE_SPOT キャパシティプロバイダーの使用を試みました。
• サービススケジューラは Fargate Spot のキャパシティを取得できませんでした。

{
  "version": "0",
  "id": "403b98b2-616e-4ec7-8dff-b2cba8d5bf64",
  "detail-type": "ECS Service Action",
  "source": "aws.ecs",
  "account": "1111222233334444",
  "time": "2022-02-25T14:56:32.756Z",
  "region": "ap-southeast-2",
  "resources": [
    "arn:aws:ecs:ap-southeast-2:1111222233334444:service/default/servicetest"
  ],
  "detail": {
    "eventType": "ERROR",
    "eventName": "SERVICE_TASK_PLACEMENT_FAILURE",
    "clusterArn": "arn:aws:ecs:ap-southeast-2:1111222233334444:cluster/default",
    "capacityProviderArns": [
      "arn:aws:ecs:ap-southeast-2:1111222233334444:capacity-provider/FARGATE_SPOT"
    ],
    "reason": "RESOURCE:FARGATE",
    "createdAt": "2022-02-25T14:21:04.163Z"
  }
}

Fargate Spot キャパシティが使用できないためにタスクを配置できない場合、eventName は SERVICE_TASK_PLACEMENT_FAILURE として言及されます。これは、FARGATE_SPOT タスクを配置できないときに SNS アラートを送信する EventBridge ルールを作成できることを意味します。

以下の操作を実行します。

1.    SNS トピックを作成します。

2.    このユースケース向けの Amazon EventBridge ルールを作成します。これを実行するには、次の変更を除き、「FARGATE_SPOT タスクが Fargate Spot の中断によりシャットダウンされた」のセクションに記載されている手順を使用します。

[Event pattern] (イベントパターン) で、[Custom patterns (JSON editor)] (カスタムパターン (JSON エディタ)) を選択し、次のパターンを追加します。

{
  "source": [
    "aws.ecs"
  ],
  "detail-type": [
    "ECS Deployment State Change"
  ],
  "detail": {
    "eventName": [
      "SERVICE_TASK_PLACEMENT_FAILURE"
    ],
    "clusterArn": [
      "arn:aws:ecs:example-region:1111222233334444:cluster/example-cluster"
    ],
    "reason": [
      "RESOURCE:FARGATE"
    ]
  }
}