Skip to content

RunSpace

角色

RunSpace 是 provider 侧真实承载执行的运行空间对象,用于表达 workspace、实例、隔离槽位或调用空间本身,而不是它的租约或网络连接。

v1 将 RunSpace 作为公开可查询资源,以支持复盘、调试和复用判断。

核心字段

  • runSpaceId
  • orgId
  • providerType
  • runEnv
  • kind
  • status
  • currentSessionId
  • currentRunId
  • currentAttemptId
  • locator
  • metadata
  • createdAt
  • updatedAt
  • terminatedAt

标准类型

  • workspace
  • instance
  • slot
  • invocation
  • custom

标准状态

  • provisioning
  • ready
  • occupied
  • reclaiming
  • terminated
  • failed

与 Session 的关系

  • SessionRunSpace 的租约对象,而不是 RunSpace 本身
  • 一个 RunSpace 在时间维度上 MAY 先后绑定多个 Session
  • 同一时刻一个 RunSpace MUST NOT 被多个未终止 Session 同时占用
  • currentSessionId 如存在,MUST 指向当前正在占用该 RunSpaceSession

规范要求

  • provider MUST 为每个实际执行空间分配稳定的 runSpaceId,至少在该空间生命周期内稳定
  • RunSpace MUST 表达底层空间本身的存在与状态,而不是复用 Session 的租约状态
  • terminatedRunSpace MUST NOT 再接收新的 Session
  • RunSpace MAYSession 结束后继续存在,以支持复用、延迟释放或后续清理
  • faasworker 一类短生命周期环境 MAY 产生非常短命的 RunSpace,但只要它真实承载过执行,平台 MUST 能在事实中引用其 runSpaceId
  • locatormetadata MAY 携带 provider 私有信息,但不得改变稳定资源语义
  • 读面 SHOULD 允许按 run、attempt、session 和 id 查询 RunSpace

白皮书与规范内容以仓库真源为准。