主题
更新、归档与删除
update 语义
deploy project update <key> --file project.json(或 --kind / --dependencies flag):
- 保留未传字段:文件里没写的字段维持原值。
- 列表整体替换:给了
commands就替换全部命令;给了envs就替换全部变量。想加一条命令也要带上其余命令。 - 命令 ID 重新生成:每次 update 后旧 ID 全部失效,选择性运行前重新
project get。 - 拒绝 env 简写:update 必须给
envs数组({key,value,isSecret}),防止 Secret 被简写误降级。 - 文件 key 必须匹配目标:
--file里的key与位置参数不一致报用法错误。 scriptFile相对定义文件目录解析,CRLF 归一化。--dependencies=空值清空依赖;--kind app|lib改类型。
网页编辑页保存等价于一次整体 update,同样触发命令 ID 重生成。
归档
归档(archived: true)是软隐藏:默认列表不显示,定义、运行历史、日志全部保留,可恢复。
- 网页:列表页归档切换(active/archived/all)+ 归档/恢复按钮。
- CLI:
deploy project list --archived查看;deploy project update <key> --file传{"key":"<key>","archived":true}归档(update 透传该字段)。 - 用途:下线旧应用、迁移项目→任务后隐藏旧项目(见 从项目迁移到任务)。
删除
删除是硬清理,不可恢复:
- 取消该项目所有运行;删除命令、加密变量、运行历史与日志文件。
- 不删除源码工作区目录、数据库、systemd 服务等外部资源——这些需要另行清理。
- 被其他项目依赖的 lib 项目删除前,先解除依赖关系,否则依赖方触发时报错。
入口:网页详情页删除按钮、API DELETE /api/v1/projects/{key}。CLI 当前无删除子命令(以 deploy project --help 为准)。
清理临时项目的规程
project list+project get读依赖图,确认哪些是临时勘察/引导/废弃项目。- 保留活跃应用、被引用的 lib、无关系统项目。
- 先归档观察一段时间,确认无引用后再删除。
- 删除后读回列表,并验证线上服务不受影响(工作区与服务未被触碰)。
对照表
| 操作 | 定义 | 运行历史/日志 | 工作区/服务 | 可恢复 |
|---|---|---|---|---|
| 归档 | 保留 | 保留 | 不动 | 是 |
| 删除 | 删除 | 删除 | 不动 | 否 |
| 手工 rm 工作区 | 不动 | 不动 | 删除 | 否(Git 可重拉) |