コンテンツにスキップ

スロットのマシンの種類を選ぶ

ecs-ec2 の配備で、スロットに使うインスタンスの種類を複数用意し、テナント管理者にテナントごと・メンバーごとに選ばせます。 速さより費用を優先する種類や、Graviton(arm64)の種類を足せます。

あなたがやること 起きること
Ec2SlotTypes に名前つきのクラスを書く テナント管理者の画面に「マシンの種類」が出る
arm64 のクラスを足す前に、イメージと AMI を用意する Graviton のスロットが起動できる
Ec2DefaultSlotClass を決める 何も選んでいないメンバーが、そのクラスに載る
テナント管理者が種類を選ぶ そのメンバーの次の起動から、そのクラスのインスタンスに載る

クラスを足しただけでは、どのメンバーもそのクラスへ移りません。

Ec2SlotTypes には 2 つの書きかたがあります。古いほうもそのまま使えます。

instanceType:memoryMiB[:vcpu],… one unnamed class, x86_64
id|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,…

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 のためのものです。

arm64 のクラスを書く前に、この順で準備します。

  1. ワークスペースのイメージに arm64 のマニフェストを持たせます。 ないと、スロットは起動しても、タスクはその上で動くイメージを pull できません。crane manifest <image> で確かめます。manifest.v2+json が 1 つだけなら、アーキテクチャは 1 つしかありません。必要なのはマニフェストリスト(OCI インデックス)です

  2. 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 を渡します

  3. Ec2SlotTypes に arm64 のクラスを足します。 たとえば次のように書きます

    …;arm|Faster and cheaper (Arm)|arm64|m8g.large:8192:2,m8g.xlarge:16384:4,m8g.2xlarge:32768:8
  4. 2 つ目の golden のビルドを待ちます。 golden はバイナリの詰まったホームなので、アーキテクチャごとに 1 つです。arm64 の golden ができるまで、arm64 のクラスの新しいメンバーは空のホームから始まります(遅いだけで、壊れはしません)。golden は「スロット」の画面にアーキテクチャごとに表示されます

  • arm64 のクラスがあって Ec2SlotAmiArm64 が空だと、Control Plane は起動を拒みます。起動できないクラスを画面に出さないためです
  • Ec2SlotAmiArm64 は初期値と予備の値にすぎません。Control Plane は同じ SSM パラメータを自分で読んでスロットを起動するので、パッチのためにデプロイし直す必要はありません

エージェントが主に読む・編集する・小さなコマンドを動かすだけのメンバーには、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 の compile 1 つだけで約 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

価格は変わります。決める前に確かめ直してください。

Ec2DefaultSlotClass は、自分にもテナントにも指定がないメンバーが載るクラスの id です。空のときは Ec2SlotTypes の最初のクラスになります。

  • 動いている配備でこれを変えると、自分で選んでいないメンバー全員が移ります。 アーキテクチャが変わるなら、その全員のホームが、次の起動でアーキテクチャに依存するツールを入れ直します
  • 動いているスタックは、パラメータを渡さないかぎり今の Ec2SlotTypes を持ち続けます。Control Plane をアップグレードしただけで、メンバーに選択肢が表示されることはありません

メンバーをアーキテクチャの違うクラスに移す

Section titled “メンバーをアーキテクチャの違うクラスに移す”

テナント管理者は、テナントの「既定のマシン種別」と、メンバー詳細の「マシンの種類」で選びます(ワークスペースのサイズを決める)。

アーキテクチャをまたぐ移動は安全ですが、入れ直しの手間がかかります。

残るもの 入れ直すもの
ホームそのもの ~/.local の CLI・nvm の node・Chromium など、アーキテクチャに依存するもの。次の起動で自動で入れ直す
~/repos の中身 node_modules・target・.venv など、メンバーがビルドしたもの。メンバーが自分で入れ直す。見つかったものは af-arch-repair が通知で名前を出す

保存する前に、Console が警告を出します。

エージェント向け

この指示をエージェントに送ると、このページを読ませられます。

https://agent-fleet.org/docs/ja/operate/aws-ecs/slot-types/index.md を読んで