テーマ別の解説テーマ:コンテナとECS・Fargate
ECSのローリング更新:タスク数の計算とロールバックの条件
更新中の余裕は割合をタスク数へ直して読みます。ただし、計算上の枠があっても、新しいタスクが正常に起動する保証にはなりません。 指定数3と4の固定例で、切上げ・切下げ、検査の待ち方、失敗時に何を戻せるかを確認します。
最小正常数と最大タスク数を計算し、更新が進まない場合の確認順と、版の復帰・業務復旧の違いを説明できる。
ECSのタスク定義・サービスと、コンテナ/ALBのヘルスチェックを学んだ後の教材です。REPLICAサービスのROLLINGを対象にします。例ではearlySuccessCriteriaを無効とし、開始時の旧タスクは全て正常、PENDING/STOPPINGはないものとします。実AWSを操作する手順や、配置全体のシミュレータではありません。
割合ではなく、更新中のタスク数で考える
minimumHealthyPercentは正常なタスク数の下限、maximumPercentは更新中のタスク数の上限に関係します。desiredCount(サービスの指定数)を掛け、最小側は切上げ、最大側は切下げます。割合が違っても、端数処理後の数が同じになることがあります。
| 読みたい数 | 計算 | 意味 |
|---|---|---|
| 最小正常数 | ceil(desiredCount × minimumHealthyPercent / 100) | 切上げ。正常な旧タスクを止める余地の確認に使う。 |
| 最大タスク数 | floor(desiredCount × maximumPercent / 100) | 切下げ。追加する余地の確認に使う。 |
指定数3:割合を変えても、1タスク分の余地がない例
指定数3、minimumHealthyPercent=75、maximumPercent=125。 最小はceil(2.25)=3、最大はfloor(3.75)=3です。正常な旧タスクが3つある開始時点では、正常数を守って1つ止める余地も、最大数を守って1つ足す余地もありません。
- 最小正常数 3 → 旧タスク 3・全て正常正常な1つを止める余地なし
- 旧タスク 3・全て正常 → 最大タスク数 31つを追加する余地なし
- 最小正常数 3
- ceil(3 × 75 / 100)
- 旧タスク 3・全て正常
- 開始時の固定条件
- 最大タスク数 3
- floor(3 × 125 / 100)
指定数4:枠があっても、起動と検査は別に確かめる
| 項目 | 値 | ここからは決められないこと |
|---|---|---|
| 最小正常数 | ceil(4 × 50 / 100)=2 | 2つあれば必要な処理性能を満たす、とは限らない。 |
| 最大タスク数 | floor(4 × 200 / 100)=8 | 実際に8つ配置・起動できる、とは限らない。 |
| 開始時の追加余地 | 8 − 4 = 4 | 必要な資源・IP・上限・起動・検査の成功は未確認。 |
| 正常な旧タスクを止める計算上の余地 | 4 − 2 = 2 | 実際に2つ同時停止するという予告ではない。 |
起動した新タスクが、いつ正常数へ数えられるかも確認します。タスク定義にessentialコンテナの検査がある場合や、ロードバランサーを使う場合は、該当する検査条件が関係します。RUNNINGになった数だけで、旧タスクを安全に減らせるとは決めません。
この例ではearlySuccessCriteriaを無効にしています。この機能を使う構成では、正常な新タスクの割合などに基づく完了条件と、旧タスクの後処理を別に読む必要があります。COMPLETEDという表示だけで、全タスクが新しい版へ切り替わったと一般化しません。
更新の失敗検知と、戻せる条件を分ける
| 観点 | 確認すること | 取り違えないこと |
|---|---|---|
| 対象方式 | ROLLINGと有効化設定。 | 全てのデプロイ方式で同じ仕組みではない。 |
| 失敗の数え方 | thresholdConfigurationとresetOnHealthyTask等。 | 全設定で同じ失敗回数とは限らない。 |
| 自動で戻す設定 | rollbackの有効化。 | 失敗検知を有効にしただけで復帰完了とは言えない。 |
| 復帰先 | 直前の復帰可能なCOMPLETED deployment。 | 新規サービスに必ず戻り先があるとは限らない。 |
| 復帰後の確認 | 版・タスク・検査・利用者操作・副作用。 | アプリの版を戻すことと、全データを戻すことは別。 |
復帰先のCOMPLETED deploymentが見つからないと、circuit breakerによる自動復帰を期待できません。公式資料では、この場合は新タスクの起動が止まり、deploymentが進まないと説明しています。初回公開時も、失敗時の対処を別に用意します。
更新が進まないときは、同じ版・時点の記録で調べる
- 対象サービス・方式・指定数・旧版/新版をそろえ、観測時刻を記録する。
- 最小/最大を整数へ直し、実際のRUNNING/PENDING/STOPPINGと正常数を照合する。
- service eventから、追加/停止の制約、配置・IP・上限・起動失敗を分ける。
- 新タスクのコンテナ/ALB検査を照合し、RUNNINGだけで正常としない。
- 失敗検知・rollback設定・復帰先のCOMPLETEDを確認する。
- 復帰や再試行後も、実際の版・利用者の処理・データ/外部副作用を確かめる。
不健康なタスクの置換と、新版への更新も区別します。現在の公式資料は、不健康なタスクを、そのタスクが属するservice revisionで置換すると説明しています。旧版の不健康タスクが置換されたことだけでは、新版への移行完了とは言えません。
整数の計算と、観測できたことを確かめる
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 指定数3の例で、切上げ/切下げから1枠もない理由を説明する。
- 指定数4の例で、計算できる数と実際に確かめる条件を分ける。
- 復帰先とデータ/外部副作用を含め、戻せる範囲を説明する。
理解を確かめる: 「更新設定は正しく、rollbackも有効。だから無停止で必ず元へ戻る」と言える?
言えません。計算・配置/検査・復帰先・業務結果を別々に確認します。
整数の枠は必要な条件の一部です。復帰先や実容量があるか、検査が成功したか、データの互換性や副作用まで戻せるかを別に確かめます。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件最小切上げ/最大切下げと1タスク分の余地、不健康なタスクを所属revisionで置換する条件。計算だけで実配置成功とはしない。 公式資料の確認であり実AWS検証ではありません。
参照した本文割合ではなく、更新中のタスク数で考える 指定数3:割合を変えても、1タスク分の余地がない例 更新が進まないときは、同じ版・時点の記録で調べる 整数の計算と、観測できたことを確かめる
確認した内容・条件Grace period、最小切上げ/最大切下げ、early successの設定を区別。maximumPercentの状態名はAPI記載と差があり開発者ガイドではSTOPPINGも含む。 公式資料の確認であり実AWS検証ではありません。
参照した本文割合ではなく、更新中のタスク数で考える 指定数4:枠があっても、起動と検査は別に確かめる 更新が進まないときは、同じ版・時点の記録で調べる 整数の計算と、観測できたことを確かめる
確認した内容・条件割合計算は開発者ガイドと一致。最大側の状態名はRUNNING/PENDINGという表記差を保持。停止中なら必ず枠が空くとは推測しない。 公式資料の確認であり実AWS検証ではありません。
確認した内容・条件Task definitionのcheckとtask/container/LB/アプリの状態を区別。 公式資料の確認であり実AWS検証ではありません。
参照した本文指定数4:枠があっても、起動と検査は別に確かめる
確認した内容・条件ROLLINGの失敗検知と復帰先COMPLETEDの条件。回数方式が設定可能で既定の有界割合を全設定へ一般化しない。 公式資料の確認であり実AWS検証ではありません。
参照した本文更新の失敗検知と、戻せる条件を分ける 更新が進まないときは、同じ版・時点の記録で調べる 整数の計算と、観測できたことを確かめる
確認した内容・条件enable/rollbackに加えresetOnHealthyTask/thresholdConfigurationを確認。設定と実際の回復結果を区別。 公式資料の確認であり実AWS検証ではありません。
確認した内容・条件Serviceイベントを診断の入口とし、表示範囲とAPI/コンソールの差に注意。 公式資料の確認であり実AWS検証ではありません。
参照した本文更新が進まないときは、同じ版・時点の記録で調べる