コンテナインスタンスのドレイン
クラスターからコンテナインスタンスを削除する必要がある場合があります。たとえば、システム更新を実行する、Docker デーモンを更新する、またはクラスターサイズを縮小する場合などです。コンテナインスタンスのドレインにより、クラスターのタスクに影響を与えずにクラスターからコンテナインスタンスを削除できます。
コンテナインスタンスを DRAINING に設定すると、Amazon ECS によって新規タスクがそのコンテナインスタンスに配置されなくなります。ドレインしている PENDING 状態のコンテナインスタンスのサービスタスクは即時停止されます。クラスター内に使用可能なコンテナインスタンスがある場合、そのインスタンスで代わりのサービスタスクが開始されます。
RUNNING 状態のコンテナインスタンスのサービスタスクは停止され、サービスのデプロイ設定パラメータ minimumHealthyPercent および maximumPercent に従って代替されます。
-
minimumHealthyPercentが 100% を下回っている場合、タスクの代替中、スケジューラは一時的にdesiredCountを無視できます。たとえば、desiredCountが 4 つのタスクの場合、最小値 50% でスケジューラは 2 つの既存タスクを停止してから 2 つの新規タスクを開始できます。最小が 100% の場合、サービススケジューラは、代替タスクが正常な状態と見なされるまで既存タスクを削除できません。ロードバランサーを使用しないサービスのタスクがRUNNING状態にある場合、正常な状態と見なされます。ロードバランサーを使用するサービスのタスクは、RUNNING状態にあり、そのタスクをホストするコンテナインスタンスがロードバランサーによって正常と報告された場合に、正常であると見なされます。 -
maximumPercentパラメータは、タスクの代替中に実行できるタスク数の上限を表します。これにより代替バッチサイズを定義できます。たとえば、desiredCountが 4 つのタスクで、最大が 200% であればドレインされる 4 つのタスクを停止する前に 4 つの新規タスクを開始できます (これを行うために必要なクラスターリソースを使用できる場合)。最大が 100% の場合、代替タスクは、ドレインするタスクが停止するまで開始できません。
詳細については、「サービス定義パラメータ」を参照してください。
サービスに属さない PENDING または RUNNING タスクは影響を受けません。終了するのを待つか、手動で停止する必要があります。
コンテナインスタンスは、RUNNING タスクがなくなるとドレインを終了します (ただし、状態は DRAINING のままです)。ListTasks オペレーションに containerInstance パラメータを使用してこれを検証できます。
コンテナインスタンスのステータスを DRAINING から ACTIVE に変更すると、Amazon ECS スケジューラはそのインスタンスのタスクを再度スケジュールできるようになります。
インスタンスのドレイン
UpdateContainerInstancesState API アクションまたは update-container-instances-state コマンドを使用して、コンテナインスタンスのステータスを DRAINING に変更できます。
次の手順は、AWS マネジメントコンソール を使用してインスタンスを DRAINING に設定する方法を示しています。
コンソールを使用してインスタンスを DRAINING に設定するには
-
https://console.aws.amazon.com/ecs/ にある Amazon ECS コンソールを開きます。
-
ナビゲーションペインで、[Clusters] を選択し、クラスターを選択します。
-
[ECS Instances] を選択し、コンテナインスタンスのチェックボックスを選択します。
-
[Actions]、[Drain instances] を選択します。
-
インスタンスが処理されたら、[Done] を選択します。
