Skip to content

从项目迁移到任务 ​

划分原则 ​

特征项目任务
拉代码构建是(Git 准备)否
依赖先建支持不支持
重复发布流程适合不适合
勘察/改配置/清缓存/导数据能跑但语义冗余适合
选择性执行某一步命令 ID 每次 update 重生成步骤 ID 位置稳定

一句话:要拉代码构建的是项目,只跑一件事的是任务。

真实教训 ​

HuLa 公网部署初期把「环境勘察 / MinIO 配置 / ICE 配置 / SRS 配置」做成了四个项目。 它们不拉代码、不构建,却背着 Git 卡片与依赖语义;更痛的是每次 update 后命令 ID 重生成, 「只跑第 13 步勘察」的脚本必须先 project get。CLI 补齐 task 命令组后,四个项目整体迁移为同名任务并归档旧项目, 选择性执行变为 task run hula-recon --step-id 13,不再读 ID。完整背景见 HuLa 案例。

迁移步骤 ​

  1. 导出定义:deploy project get <key> --json > old.json。
  2. 改写为任务格式:去掉 useGit/git*/kind/dependencies;commands 改名 steps(字段结构不变); 保留 key/name/workdir/timeoutSec/envs;scriptFile 相对路径保持可用。
  3. 创建任务:deploy task create --file task.json(key 可与旧项目同名,二者命名空间独立)。
  4. 预演核对:deploy task preview <key> 与旧项目命令脚本逐条比对。
  5. 实跑验证:deploy task run <key> -f,必要时 --step-id 抽跑关键步。
  6. 归档旧项目:deploy project update <old-key> --file 传 {"key":"<old-key>","archived":true}; 确认无引用后再考虑删除(更新、归档与删除)。
  7. 改自动化引用:把脚本里的 run <key> --command-id … 换成 task run <key> --step-id N,删掉前置的 project get。

迁移检查表 ​

  • [ ] 任务定义不含 Git/依赖字段。
  • [ ] steps 顺序与旧 commands 一致(位置 ID 即新引用)。
  • [ ] Secret 以 envs 数组迁移,isSecret 保持。
  • [ ] Hook Token:旧项目的 hk_ 令牌不自动转移,需在任务详情页重建并更新外部调用方。
  • [ ] 旧项目已归档;依赖它的其他项目已解除依赖。
  • [ ] 运行历史保留在旧项目下(归档不删历史),审计需要时仍可查。

反向迁移 ​

任务后来需要拉代码构建?新建项目并把步骤搬为命令,而不是给任务加 Git——类型语义不支持。 迁移方向总是「向语义更丰富的类型新建」,旧定义归档留痕。