テーマ別の解説テーマ:コンテナとECS・Fargate
Amazon ECS入門:タスク定義・タスク・サービスの違いを図解
タスク定義は「どう動かすか」、タスクは「実際の実行」、サービスは「指定した台数を維持する仕組み」です。 Amazon ECS(Elastic Container Service)は、コンテナ化したアプリの実行を管理します。架空のレポートAPIを2台動かす例で、定義の登録・実行・更新を分けて読み解きます。
定義・実行・サービスを指し分け、新リビジョンの登録やtask停止で何が変わるか、何は未確定かを説明できる。
イメージはアプリと実行に必要なファイルをまとめたもの、コンテナはそれを使って動かすプロセス環境です。この教材は固定例を読む練習です。AWSアカウント、Dockerの実行、実ログや認証情報は不要です。
定義・実行・維持・実行基盤を分ける
- サービス → タスク定義 :7実行に使う定義を参照
- サービス → タスク A・B指定数に向けて起動・置換する
- タスク A・B → 実行基盤選んだ実行基盤で動く
- タスク定義 :7
- イメージ・CPU・メモリ等を指定
- サービス
- 定義 :7 を参照・desired 2
- タスク A・B
- それぞれが定義 :7 の実行
- 実行基盤
- 例:Fargate
| 用語 | この例での役割 | 取り違えやすい点 |
|---|---|---|
| タスク定義 | report-api:7。動かす設定の版。 | 定義が存在しても、実行中とは限らない。 |
| タスク | demo-a、demo-b。それぞれの実行。 | 一つのtaskは複数containerを含められる。 |
| サービス | reports-training。指定数2を維持する設定。 | desired 2は正常なHTTP応答2台の証明ではない。 |
| クラスター | taskやserviceをまとめる論理的な単位。 | クラスターそのものが1台のサーバーではない。 |
この例ではFargateを実行基盤とします。ECS自体とFargateは同義ではありません。利用者が管理するEC2、AWSがEC2基盤を管理するECS Managed Instances等の選択肢もあります。選ぶ方式でOS・容量・保守の分担が変わります。
新しい定義を登録しても、既存タスクは更新されない
同じ名前の定義のまとまりをfamily、その版番号をrevision(リビジョン)と呼びます。report-api:7とreport-api:8は、同じfamilyの別の版です。実行時にどの版を使ったかを追えるよう、定義と実行を別に見ます。
Definition report-api:7 image=A
Definition report-api:8 image=B [newly registered]
Service reports-training definition=report-api:7 desired=2
Task demo-a definition=report-api:7 lastStatus=RUNNING
Task demo-b definition=report-api:7 lastStatus=RUNNINGT1で追加したのは:8の定義だけです。サービスは引き続き:7を参照し、demo-a・demo-bも:7の実行のままです。:8を使うには、実行やサービスの更新でその版を選ぶ必要があります。登録した版番号8は、動かす台数8という意味ではありません。
| 見る対象 | 登録前 | 登録後 |
|---|---|---|
| 登録済み定義 | :7 | :7 と :8 |
| サービスが参照する版 | :7 | :7 |
| demo-a / demo-bの版 | :7 / :7 | :7 / :7 |
| desired count | 2 | 2 |
タスクが止まったら、誰が置き換えるのか
T2:サービスに属するdemo-aが停止した場合、サービスのscheduler(配置・起動を調整する仕組み)は、指定数2へ戻すために新しいtaskの起動を試みます。T1の設定が変わっていなければ使う定義は:7です。停止したtaskがその場で:8に変身する、という動きではありません。
起動には実行基盤の容量、権限、イメージ取得、ネットワーク等の条件があります。起動失敗を繰り返す場合は再試行の間隔が延びることもあります。サービスが維持を試みることと今すぐ正常な2台が使えることは分けます。
| 実行の形 | 停止後に考えること |
|---|---|
| この例のサービス管理task | サービスが指定数へ向けて置換を試みる。結果は別に確認。 |
| サービスに属さない単発RunTask | 継続的に指定数を維持するサービスは存在しない。必要なら別の再実行設計を確認。 |
イメージ取得の権限と、アプリの権限を分ける
Agent(エージェント)は、コンテナの起動やログ送信等を支える側のプログラムです。アプリがデータを読む主体とは分けて、権限を考えます。
| ロール | 使う主体 | この例の用途 |
|---|---|---|
| タスク実行ロール(execution role) | ECS / Fargateのagent | 必要な権限に従って非公開イメージを取得し、設定したログを送る。 |
| タスクロール(task role) | コンテナ内のアプリ | 許可されたS3 APIでレポートを読む。 |
アプリのS3アクセスに困ったからといって、execution roleへ広い権限を足して解決とはしません。誰が、どの操作を、どの対象へ行うかを確かめ、対応するロールと最小限の権限を調べます。また、IAMの許可だけではDNS・通信経路・TLS接続の成功は決まりません。
RUNNING・正常性・要求成功を別に確かめる
Health check(ヘルスチェック)は、設定したコマンドや接続先を使って状態を調べる確認処理です。LB(ロードバランサー)は、要求を複数の処理先へ振り分ける仕組み。何を、どの経路で確かめたかを区別します。
| 観測 | 言えること | 追加で見ること |
|---|---|---|
| サービスのdesired=2 | 指定数が2という設定。 | 実task数、各状態、serviceイベント。 |
| taskのlastStatus=RUNNING | 観測時点のtaskの実行状態。 | containerのcheck、アプリの応答。 |
| 設定したhealth checkの成功 | そのcheckが調べた条件の成功。 | LB経由の到達性や実際の利用者操作。 |
| 利用者の要求の成功 | その要求・経路・時点での成功。 | 別の要求や将来の継続成功は別に観測。 |
- クラスター・サービス・参照する定義の版とdesired数をそろえる。
- 実行中/停止したtaskごとに、使った版・状態・停止理由を確かめる。
- Serviceイベントと必要なログから、配置・イメージ取得・権限・通信を切り分ける。
- 設定したhealth checkと、利用者が使う経路の応答を別に確認する。
定義と実行を、固定例で読み分けてみる
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 図で定義・サービス・タスク・実行基盤を指し分ける。
- T1とT2で、変わるものと変わらないものを説明する。
- 2ロールとRUNNINGの意味を確認し、小問の理由まで読む。
理解を確かめる: ECSで実行の更新を確認するには、何を見る?
登録済みの版だけでなく、サービスの参照と実taskの版・状態・応答を確認する。
設定の追加、指定数の維持、起動、正常性、要求成功は別の事実です。どこまで確かめたかを分けると、更新や障害を読み違えにくくなります。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件定義・リビジョンと実行taskを区別。新規登録を既存taskの更新とは扱わない。 公式資料の確認であり実AWS検証ではありません。
参照した本文定義・実行・維持・実行基盤を分ける 新しい定義を登録しても、既存タスクは更新されない タスクが止まったら、誰が置き換えるのか 定義と実行を、固定例で読み分けてみる
確認した内容・条件指定数の維持と置換、起動失敗時の再試行を確認。即時成功やHTTP正常を保証しない。 公式資料の確認であり実AWS検証ではありません。
参照した本文定義・実行・維持・実行基盤を分ける タスクが止まったら、誰が置き換えるのか RUNNING・正常性・要求成功を別に確かめる 定義と実行を、固定例で読み分けてみる
確認した内容・条件論理的な集合と実行基盤を区別。Fargate・EC2・Managed Instancesの現行選択肢。 公式資料の確認であり実AWS検証ではありません。
参照した本文定義・実行・維持・実行基盤を分ける
確認した内容・条件Service更新と登録のみを区別。image digest解決の条件を自動更新へ一般化しない。 公式資料の確認であり実AWS検証ではありません。
参照した本文新しい定義を登録しても、既存タスクは更新されない
確認した内容・条件Serviceイベントを診断の入口とし、表示範囲とAPI/コンソールの差に注意。 公式資料の確認であり実AWS検証ではありません。
確認した内容・条件Agentによるイメージ取得・ログ等の権限とアプリのtask roleを分離。 公式資料の確認であり実AWS検証ではありません。
参照した本文イメージ取得の権限と、アプリの権限を分ける
確認した内容・条件アプリのAWS API利用権限。ロールとネットワーク到達性やtask分離は別。 公式資料の確認であり実AWS検証ではありません。
確認した内容・条件Task definitionのcheckとtask/container/LB/アプリの状態を区別。 公式資料の確認であり実AWS検証ではありません。
参照した本文RUNNING・正常性・要求成功を別に確かめる
確認した内容・条件RUNNING/STOPPED等はtaskの状態。利用者の要求成功やアプリの正常性とは別。 公式資料の確認であり実AWS検証ではありません。