Skip to content

更新、归档与删除 ​

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 为准)。

清理临时项目的规程 ​

  1. project list + project get 读依赖图,确认哪些是临时勘察/引导/废弃项目。
  2. 保留活跃应用、被引用的 lib、无关系统项目。
  3. 先归档观察一段时间,确认无引用后再删除。
  4. 删除后读回列表,并验证线上服务不受影响(工作区与服务未被触碰)。

对照表 ​

操作定义运行历史/日志工作区/服务可恢复
归档保留保留不动是
删除删除删除不动否
手工 rm 工作区不动不动删除否(Git 可重拉)

延伸阅读 ​