Support multiple ordered sandbox pools per installation
維護者通常 1 天內回覆
還沒有人認領這個 Issue。
評估
- 難度
- 5/5
- 預估耗時
- 一週以上
- 新手友好度
- 20/100
- Issue 類型
- 功能
- 描述清晰度
- 基本清楚
- 活躍度
- 活躍
- 技術堆疊
- go, postgresql
研究方向
Start with services/core/internal/deployment/placement/placement.go and the contracts/agents-api/sandbox-deployment.md contract, then trace the runtime_deployment schema and deployment API. The proposal spans placement, lifecycle, API, client validators, and Web, with open design questions still unresolved. Done means ordered pools replace the singleton across these areas while preserving the stated placement and restore constraints.
由索引模型根據 Issue 內容生成。
描述
Problem
An installation can select exactly one Sandbox Provider (docker, microsandbox or e2b). Administrators cannot combine compute sources, for example Docker nodes plus microsandbox nodes, or self-hosted nodes that overflow to E2B. Switching providers requires a full sandbox reset that clears all hosted resources.
Multiple nodes of the same provider already work: DecidePlacement picks an online, ready node with free capacity, preferring the highest ready generation and then the fewest active sandboxes.
Where the single-provider assumption lives
- Contract:
contracts/agents-api/sandbox-deployment.mdsays PostgreSQL holds "one active selection per installation",provideris "exactly one ofdocker,microsandbox,e2b", and changing to a different backend requires a reset first. - Schema:
runtime_deploymentis a singleton table (singleton boolean PRIMARY KEY CHECK (singleton)) holding oneprovider_kind,mode,generationand specification.runtime_deployment_generationskeeps retained generations only so that existing allocations can still be cleaned up. - Placement:
services/core/internal/deployment/placement/placement.goreturns no placement indirectmode and otherwise chooses among the nodes of the single provider. - Node configuration:
providers.Loadrejects configuring bothdockerandmicrosandbox("only one sandbox provider can be configured"). - API and Web:
/core/v1/sandbox/deploymentGET/POST/PUT take one selection object, andSandboxSetupWizardasks the administrator to pick one provider.
Proposal
Replace the singleton deployment with an ordered list of sandbox pools. Each pool has its own provider, specification, Runtime release, generation, credential and priority.
- Data model: pools replace the
runtime_deploymentsingleton. Placements and allocations record their pool, including direct (E2B) allocations, which have no placement record today. - Placement: try pools in priority order and use the first one with admissible capacity. Within a node pool, keep the current node selection rules. Direct pools need a declared capacity limit so that lower-priority pools can be reached.
- Lifecycle: generation rollout, reset, owner epoch, suspension policy and node enrollment become per-pool. Removing or replacing a pool clears only that pool's resources.
- API and contract: replace the single deployment object with pool CRUD and ordering under
/core/v1/sandbox/. Update the OpenAPI,sandbox-deployment.mdand itszhtranslation, and the@oac/agents-clientvalidators. - Web: show a pool list with add, reorder, and per-pool nodes and capacity.
Constraints
- Ordering applies only when a new Session is placed, based on capacity and availability. A failed or unknown
Createis never retried in another pool: the Sandbox Provider contract forbids replayingCreate, and Core never substitutes another implementation. - An existing placement, allocation or suspended Environment stays in its original pool and node. Restores never move to another pool.
- No provider-name branches in placement or lifecycle code. Pool behavior comes from the registered adapter declarations.
- Pre-release: replace the singleton outright, with no compatibility layer for the old single-deployment API.
Open questions
- Should a pool's capacity limit be declared by the adapter, set by the administrator, or both?
- Can pools of the same provider kind coexist, for example two E2B pools with different templates?
- How should Session-level selection (for example, by resources or Harness) interact with pool order, if at all?
- 主要語言
- Go
- 星號
- 182
- 分支
- 17
- 平均合併
- 1 小時 15 分鐘
- 30 天內合併 PR
- 360
環境準備
- 沒有 Dockerfile 或 Docker Compose 檔案
- 沒有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
MiniMax-AI/OpenAgentCore 的其他 Issue
-
Skip to content changes the console page to Overview可能已有人在做 @dvd233 於 3 天前認領。 未關閉
難度 3/5 1-2 天 新手友好度 35/100
MiniMax-AI/OpenAgentCore#421 ·
維護者通常 1 天內回覆
-
難度 5/5 一週以上 新手友好度 25/100
MiniMax-AI/OpenAgentCore#418 ·
維護者通常 1 天內回覆
-
Allow an HTTP base_url for model providers, like OAC_PUBLIC_URL already does可能已有人在做 @velrith 於 5 天前認領。 未關閉
難度 3/5 1-2 天 新手友好度 25/100
MiniMax-AI/OpenAgentCore#416 ·
維護者通常 1 天內回覆
-
難度 5/5 一週以上 新手友好度 20/100
MiniMax-AI/OpenAgentCore#179 ·
維護者通常 1 天內回覆
查看 MiniMax-AI/OpenAgentCore 的全部 Issue
相似的 Issue
-
agent-research agent-review-finding chore
難度 2/5 1-3 小時 新手友好度 66/100
jordansmall/spindrift#4922 ·
維護者通常 1 天內回覆
-
gcsartifact: deleting a missing version returns an error可能已有人在做 @ktsoator 今天認領。 未關閉bug
難度 2/5 1-3 小時 新手友好度 78/100
維護者通常 2 天內回覆
-
govulncheck
難度 2/5 1-3 小時 新手友好度 62/100
維護者通常 1 天內回覆
-
Change wording for init command success message可能已有人在做 關聯的 PR 仍在進行中或已合併。 未關閉
難度 1/5 1 小時以內 新手友好度 82/100
維護者通常 1 天內回覆
-
enhancement pkg:sdk
難度 2/5 1-3 小時 新手友好度 80/100
aws/aws-durable-execution-sdk-go#144 ·
維護者通常 1 天內回覆