参考
部署状态机
19 个部署状态、9 个轮询态与 7 个需关注态,含界面标签与源码位置。
状态集合
部署状态机共 19 个状态,分成两个集合:9 个轮询态与 7 个需关注态。两个集合可以重叠。
| 状态 | 界面标签 | 轮询 | 需关注 | 源码 |
|---|---|---|---|---|
PREPARED | 待提交 | — | — | src/client/state/deployment.mjs:1 |
UPLOADING | 上传运行包 | — | — | src/client/state/deployment.mjs:1 |
UPLOAD_UNKNOWN | 上传结果待核对 | — | ⚠️ | src/client/state/deployment.mjs:1 |
UPLOADED | 已上传 | — | — | src/client/state/deployment.mjs:1 |
CREATING | 创建中 | — | — | src/client/state/deployment.mjs:1 |
CREATE_UNKNOWN | 创建结果待核对 | — | ⚠️ | src/client/state/deployment.mjs:1 |
PROVISIONING | 准备实例 | ✅ | — | src/client/state/deployment.mjs:1 |
CONFIGURING | 配置访问令牌 | ✅ | — | src/client/state/deployment.mjs:1 |
TOKEN_PENDING | 等待配置生效 | ✅ | ⚠️ | src/client/state/deployment.mjs:1 |
STARTING | 启动中 | ✅ | — | src/client/state/deployment.mjs:1 |
UPDATING | 切换版本 · 等待入口确认 | ✅ | — | src/client/state/deployment.mjs:1 |
UPDATE_UNKNOWN | 更新结果待核对 | ✅ | ⚠️ | src/client/state/deployment.mjs:1 |
READY | 就绪 | — | — | src/client/state/deployment.mjs:1 |
AVAILABLE_UPDATING | 入口可用 · 平台更新中 | ✅ | — | src/client/state/deployment.mjs:1 |
ACTION_REQUIRED | 需要处理 | — | ⚠️ | src/client/state/deployment.mjs:1 |
FAILED | 失败 | — | ⚠️ | src/client/state/deployment.mjs:1 |
DELETING | 删除中 | ✅ | — | src/client/state/deployment.mjs:1 |
DELETE_UNKNOWN | 删除结果待核对 | ✅ | ⚠️ | src/client/state/deployment.mjs:1 |
DELETED | 已删除 | — | — | src/client/state/deployment.mjs:1 |
「轮询」表示客户端继续拉状态;「需关注」表示界面必须给出可执行操作,而不是继续转圈。界面标签是产品内的中文文案,此处保留原样。
三个常量都在 src/client/state/deployment.mjs 里单行定义:DEPLOYMENT_LABELS(第 1 行)、DEPLOYMENT_POLL_STATES(第 3 行)、DEPLOYMENT_ATTENTION_STATES(第 5 行),所以每行的「源码」列都指向同一处。
轮询态
这些状态代表「平台还在做事」,客户端可以安全重试轮询:
| 状态 | 界面标签 |
|---|---|
UPDATING | 切换版本 · 等待入口确认 |
UPDATE_UNKNOWN | 更新结果待核对 |
PROVISIONING | 准备实例 |
CONFIGURING | 配置访问令牌 |
TOKEN_PENDING | 等待配置生效 |
STARTING | 启动中 |
AVAILABLE_UPDATING | 入口可用 · 平台更新中 |
DELETING | 删除中 |
DELETE_UNKNOWN | 删除结果待核对 |
需关注态
这些状态代表「结果不确定或需要人」,继续轮询不会改变结果:
| 状态 | 界面标签 |
|---|---|
CREATE_UNKNOWN | 创建结果待核对 |
UPLOAD_UNKNOWN | 上传结果待核对 |
UPDATE_UNKNOWN | 更新结果待核对 |
DELETE_UNKNOWN | 删除结果待核对 |
ACTION_REQUIRED | 需要处理 |
FAILED | 失败 |
TOKEN_PENDING | 等待配置生效 |
结果待核对不等于失败
带 *_UNKNOWN 后缀的状态表示上一次请求的结果未知。先核对云端实际状态,再决定重试还是回滚;直接重试可能产生第二个资源。
状态机主干
PREPARED → UPLOADING → UPLOADED → CREATING → PROVISIONING → CONFIGURING
→ TOKEN_PENDING → STARTING → READY
READY → UPDATING → AVAILABLE_UPDATING → READY
any state → FAILED | ACTION_REQUIRED
any state → DELETING → DELETED主干之外只有两条支线:失败与删除。所有 *_UNKNOWN 都是主干某一步的中断记录,不是独立分支。
版本与兼容性
| 项 | 值 | 说明 |
|---|---|---|
| 状态数 | 19 | 新增状态需要同步本页与客户端 |
| 轮询态 | 9 | DEPLOYMENT_POLL_STATES |
| 需关注态 | 7 | DEPLOYMENT_ATTENTION_STATES |
| 界面标签 | 中文硬编码 | 见 src/client/state/deployment.mjs |
开发者入口
| 内容 | 源码位置 |
|---|---|
| 部署状态 | src/client/state/deployment.mjs |
| 部署客户端 | src/studio-deployments.mjs |
| 部署版本 | src/deployment-versions.mjs |
| 部署回滚 | src/deployment-rollouts.mjs |
相关测试:
| 测试文件 | 位置 |
|---|---|
| studio-deployments.test.mjs | tests/studio-deployments.test.mjs |