スロットのマシンの種類を選ぶ
ecs-ec2 の配備で、スロットに使うインスタンスの種類を複数用意し、テナント管理者にテナントごと・メンバーごとに選ばせます。
速さより費用を優先する種類や、Graviton(arm64)の種類を足せます。
| あなたがやること | 起きること |
|---|---|
Ec2SlotTypes に名前つきのクラスを書く |
テナント管理者の画面に「マシンの種類」が出る |
| arm64 のクラスを足す前に、イメージと AMI を用意する | Graviton のスロットが起動できる |
Ec2DefaultSlotClass を決める |
何も選んでいないメンバーが、そのクラスに載る |
| テナント管理者が種類を選ぶ | そのメンバーの次の起動から、そのクラスのインスタンスに載る |
クラスを足しただけでは、どのメンバーもそのクラスへ移りません。
クラスを書く
Section titled “クラスを書く”Ec2SlotTypes には 2 つの書きかたがあります。古いほうもそのまま使えます。
instanceType:memoryMiB[:vcpu],… one unnamed class, x86_64id|label|arch|<ladder>[;id|label|arch|<ladder>] one class per entry| 欄 | 中身 |
|---|---|
id |
クラスの ID。Ec2DefaultSlotClass で指す |
label |
テナント管理者の画面に出る名前 |
arch |
x86_64 か arm64。インスタンスの名前からは推測せず、書いたとおりに扱う。それ以外の値のクラスは捨てる |
<ladder> |
instanceType:memoryMiB[:vcpu] を小さい順にカンマで並べた段 |
- ワークスペースは、メモリの要求が収まるいちばん小さい段に載り、インスタンスをまるごと使います。クラスが段の並びを選び、メモリがその中の段を選ぶので、「8 GB」の意味はクラスを変えても同じです
- vCPU の欄は省略できます。Console がメモリの値に対応するインスタンスを示すときと、利用履歴が CPU をインスタンス全体に対する割合で表すときに使います
- 4 つ目の欄
instanceType:memoryMiB:vcpu:baselinePctは、バースト型の段の CPU ベースラインをインスタンス全体に対する割合(1〜99)で宣言します。省略できます。読むのは利用履歴だけで、ベースラインを超えて動いた分数を数えるために使います。省略した場合や vCPU の欄が無い場合は、その数字は空になります。値が読めなくても失われるのはその数字だけで、段は残ります - クラスの区切りは
;か改行です。使える段のないクラスは捨てます
既定では、Intel の 2 クラスが入っています。
standard|Standard (Intel)|x86_64|m7i.large:8192:2,…;saver|Lower cost (Intel, previous gen)|x86_64|m6i.large:8192:2,…種類を比べる
Section titled “種類を比べる”ap-northeast-1 で m7i と比べて測った値です。価格は Pricing API から取り、速さは各ファミリーでこのリポジトリをビルドした時間で比べています。
| ファミリー | 1 時間あたりの価格 | ビルドの時間 | ビルド 1 回あたりの費用 |
|---|---|---|---|
| m6i | −4.8% | +13% | +7.3% |
| m8g(Graviton4) | −11.0% | −29% | −37.1% |
| m7g(Graviton3) | −19.0% | −10% | −27.4% |
| m6g(Graviton2) | −24.0% | +32% | ±0 |
- 1 時間あたりがいちばん安いインスタンスが、いちばん安いわけではありません。 m6g は 1 時間あたり 24% 安く、32% 遅いので、CPU を使い続ける作業では得になりません。m8g は m7i より安くて速いので、m7g を選ぶ理由はありません
- どの列が効くかはメンバーしだいです。 スロットは動いている時間で課金され、その大半はワークスペースが読む・考える・モデルを待つ時間です。読むのが中心のメンバーなら m6g で実際に 24% 安くなります。一日中ビルドするメンバーは、安くなった分を待ち時間で払うことになります。そのためメンバーごとの設定になっています
- クラスの
labelには、値引きの率ではなくトレードオフを書きます(「Cheapest — older, slower」など)。「24% 安い」だけだと、代償なしに安くなると誤解されます
m6i は何も要りません。 m7i と同じアーキテクチャなので、同じワークスペースのイメージ・同じ AMI・同じ golden snapshot が使え、メンバーが 2 つのあいだを移ってもホームはそのまま使えます。大きく安くなるのは Graviton で、下の準備もすべて Graviton のためのものです。
Graviton(arm64)のクラスを足す
Section titled “Graviton(arm64)のクラスを足す”arm64 のクラスを書く前に、この順で準備します。
-
ワークスペースのイメージに arm64 のマニフェストを持たせます。 ないと、スロットは起動しても、タスクはその上で動くイメージを pull できません。
crane manifest <image>で確かめます。manifest.v2+jsonが 1 つだけなら、アーキテクチャは 1 つしかありません。必要なのはマニフェストリスト(OCI インデックス)です -
arm64 の AMI を渡します。 起動テンプレートが固定する AMI は 1 つで、Graviton は x86_64 の ECS 最適化 AMI で起動できません。Control Plane は arm64 の AMI を
RunInstancesの ImageId の上書きとして渡します-
40-ec2-poolのSlotAmiIdArm64に、次のコマンドの結果を入れて更新します。Control Plane のロールが起動してよい AMI も、このパラメータで決まりますターミナルウィンドウ aws ssm get-parameter --name /aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/recommended/image_id --query Parameter.Value --output text -
30-ingressのEc2SlotAmiArm64に、40-ec2-poolの出力SlotAmiIdArm64を渡します
-
-
Ec2SlotTypesに arm64 のクラスを足します。 たとえば次のように書きます…;arm|Faster and cheaper (Arm)|arm64|m8g.large:8192:2,m8g.xlarge:16384:4,m8g.2xlarge:32768:8 -
2 つ目の golden のビルドを待ちます。 golden はバイナリの詰まったホームなので、アーキテクチャごとに 1 つです。arm64 の golden ができるまで、arm64 のクラスの新しいメンバーは空のホームから始まります(遅いだけで、壊れはしません)。golden は「スロット」の画面にアーキテクチャごとに表示されます
- arm64 のクラスがあって
Ec2SlotAmiArm64が空だと、Control Plane は起動を拒みます。起動できないクラスを画面に出さないためです Ec2SlotAmiArm64は初期値と予備の値にすぎません。Control Plane は同じ SSM パラメータを自分で読んでスロットを起動するので、パッチのためにデプロイし直す必要はありません
軽いクラスを足す(任意)
Section titled “軽いクラスを足す(任意)”エージェントが主に読む・編集する・小さなコマンドを動かすだけのメンバーには、4 GiB のインスタンスが 8 GiB のおよそ半額で済みます。これらは別の、オプトインのクラスとして宣言します。同梱の Ec2SlotTypes の既定は変わらず、クラスを足しただけでは誰も移りません。
…;light-arm|Light (Arm)|arm64|m8g.medium:4096:1,m8g.large:8192:2;burst-arm|Burstable (Arm)|arm64|t4g.medium:4096:2,t4g.large:8192:2;burst-x86|Burstable (Intel)|x86_64|t3.medium:4096:2,t3.large:8192:2今動かしている値(… の部分)の後ろに足します。置き換えてはいけません。 Ec2DefaultSlotClass が空のとき既定になるのは最初のクラスなので、軽いクラスで始まる値にすると、何も選んでいないメンバー全員がそこに載ります。arm64 のクラスには、Graviton(arm64)のクラスを足すの手順が要ります。vCPU あたりのメモリを増やしたいときは、r8g.medium:8192:1 を別のクラスにします。light-arm の段には足しません。m8g.large:8192 とメモリが同じで、同じメモリの段の順序は決まっていないためです。
- 軽い段は、必ず別のクラスにします。既存のクラスの下に足してはいけません。 サイズが 0(メモリの要求なし)のメンバーは、自分のクラスのいちばん小さい段に載ります。
armの下にm8g.mediumを足すと、サイズを選んでいないそのクラスのメンバーが黙って 4 GiB に下がります。テナントの既定がarmのままでサイズも選んでいないメンバーは、軽いクラスではなくarmのいちばん小さい段のm8g.largeで起動し続けます - 4 GiB の段では、ワークスペースが使えるのは 2048 MiB です。 予約は、既定の
Ec2HostReserveMb(auto)では、どの段からも一律に 2 GiB 引きます(ワークスペースが使えるメモリ)。4 GiB の段では半分が残ります- 軽いエージェントの作業には足ります。
m8g.mediumとt4g.mediumで測った結果、clone とgo vetは両方で、npm ciとtsc --noEmitはt4g.mediumで完了しました(m8g.mediumでは実行していません)。エージェントの CLI も Agent も落ちませんでした - 大きな Go のビルドには足りません。このリポジトリの
go build ./...は両方で OOM キルされ、AWS EC2 SDK のcompile1 つだけで約 1.7 GiB を使いました。大きなプロジェクトをビルドするメンバーは 8 GiB から始めます
- 軽いエージェントの作業には足ります。
- バースト型のクラスは
unlimitedのクレジットモードで動きます(t4gは実測、t3はアカウントの既定)。 Control Plane が起動したt4gのスロットはunlimitedと測れ、アカウントの既定もt4g・t3ともunlimitedです。起動したt3のスロットのクレジットモードは測っていません。CPU を使い続けると、時間単価に加えて余剰クレジットが課金されるので、CPU を回し続けるメンバーはm8gより高くつくことがあります。長いビルドが実際に余剰クレジットを使うかは測っていません - これらのクラスを足すときは、配備に
Ec2SlotTerminateAfterSecを設定します(14400がおすすめです。3 つの上限)。配備全体で 1 つの値で、すべてのクラスに効きます。既定の0では休んでいるスロットは終了されず、余ったスロットとそのルートボリュームがEc2MaxSlotsまで増えます
オンデマンドの Linux の価格です。ap-northeast-1、共有テナンシー(Pricing API、2026 年 11 月)。
| タイプ | vCPU / メモリ | 1 時間あたり(USD) |
|---|---|---|
| m8g.medium | 1 / 4 GiB | 0.05797 |
| m8g.large | 2 / 8 GiB | 0.11594 |
| t4g.medium | 2 / 4 GiB | 0.0432 |
| t4g.large | 2 / 8 GiB | 0.0864 |
| t3.medium | 2 / 4 GiB | 0.0544 |
| t3.large | 2 / 8 GiB | 0.1088 |
| r8g.medium | 1 / 8 GiB | 0.07106 |
価格は変わります。決める前に確かめ直してください。
既定のクラスを決める
Section titled “既定のクラスを決める”Ec2DefaultSlotClass は、自分にもテナントにも指定がないメンバーが載るクラスの id です。空のときは Ec2SlotTypes の最初のクラスになります。
- 動いている配備でこれを変えると、自分で選んでいないメンバー全員が移ります。 アーキテクチャが変わるなら、その全員のホームが、次の起動でアーキテクチャに依存するツールを入れ直します
- 動いているスタックは、パラメータを渡さないかぎり今の
Ec2SlotTypesを持ち続けます。Control Plane をアップグレードしただけで、メンバーに選択肢が表示されることはありません
メンバーをアーキテクチャの違うクラスに移す
Section titled “メンバーをアーキテクチャの違うクラスに移す”テナント管理者は、テナントの「既定のマシン種別」と、メンバー詳細の「マシンの種類」で選びます(ワークスペースのサイズを決める)。
アーキテクチャをまたぐ移動は安全ですが、入れ直しの手間がかかります。
| 残るもの | 入れ直すもの |
|---|---|
| ホームそのもの | ~/.local の CLI・nvm の node・Chromium など、アーキテクチャに依存するもの。次の起動で自動で入れ直す |
~/repos の中身 |
node_modules・target・.venv など、メンバーがビルドしたもの。メンバーが自分で入れ直す。見つかったものは af-arch-repair が通知で名前を出す |
保存する前に、Console が警告を出します。
- EC2 スロットプールを使い始める
- ワークスペースのサイズを決める:テナント管理者がマシンの種類を選ぶ
- スロットを入れ替える・止める:AMI が変わったスロットの入れ替え
- 費用を抑える
エージェント向け
この指示をエージェントに送ると、このページを読ませられます。
https://agent-fleet.org/docs/ja/operate/aws-ecs/slot-types/index.md を読んで