# LeaderWorkerSet [kubernetes-sigs/lws](https://github.com/kubernetes-sigs/lws)。Kubernetes sig-apps 傘下のカスタムリソース API で、単一の StatefulSet では表現しにくい「1 Leader + 複数 Worker」の非対称なマルチノードレプリカをデプロイ・管理する。各レプリカは Leader Pod 1 個と Worker Pod 群(専用 StatefulSet で管理)から構成され、レプリカ単位でのローリングアップデート・スケーリングをサポートする。分散 LLM 推論・訓練など、複数ノードにまたがるモデル並列実行を単一の論理レプリカとして扱いたいワークロードを主な対象とする。[[@2025__KEP__KEP-4671 Gang Scheduling using Workload Object]] は LWS を Job・JobSet・MPIJob・TrainJob と並ぶ「真のワークロードコントローラ」の一つとして位置づけている。 ## KEP-407: ギャングスケジューリング対応 [[@2025__KEP__KEP-407 Gang Scheduling (LeaderWorkerSet)]] は、LWS がレプリカごとに PodGroup リソースを作成し、Volcano・coscheduling scheduler-plugin・YuniKorn 等の外部カスタムスケジューラにギャングスケジューリング(all-or-nothing でのレプリカ内 Pod 起動)を委任できるようにする提案。特定スケジューラに直接結合せず、`SchedulerProvider`(PodGroup 管理)・`BaseResourceProvider`(ヘッドレスサービス等)を合成した `ReplicaResourceProvider` インターフェースでプラガブルに切り替える設計を採る。PodGroup の `MinMember` は LWS の既存概念である StartupPolicy(LeaderCreated/LeaderReady)に連動して切り替わる。 ## sig-appsの姉妹プロジェクト: Agent Sandbox 同じく sig-apps 傘下の [[Agent Sandbox]] は、LWS がマルチノードのモデル並列実行(Leader/Worker 非対称レプリカ)という形状に専用 API を与えたのと同じ設計思想で、孤立・ステートフル・シングルトンな AI エージェントランタイムという別のワークロード形状に Sandbox CRD を与える。両者は「既存の StatefulSet 等の組み合わせでは表現しきれない AI 関連ワークロードの形状ごとに、sig-apps が専用の宣言的 API を新設する」という共通パターンを示す。(Source: [[@2026__KubernetesBlog__Running Agents on Kubernetes with Agent Sandbox]]) ## 関連 - ソース: [[@2025__KEP__KEP-407 Gang Scheduling (LeaderWorkerSet)]] / [[@2026__KubernetesBlog__Running Agents on Kubernetes with Agent Sandbox]] - 概念: [[Kubernetes Workload・PodGroup API]] / [[GPUクラスタスケジューリング]] - エンティティ: [[Agent Sandbox]]