主题
从项目迁移到任务
划分原则
| 特征 | 项目 | 任务 |
|---|---|---|
| 拉代码构建 | 是(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 案例。
迁移步骤
- 导出定义:
deploy project get <key> --json > old.json。 - 改写为任务格式:去掉
useGit/git*/kind/dependencies;commands改名steps(字段结构不变); 保留key/name/workdir/timeoutSec/envs;scriptFile相对路径保持可用。 - 创建任务:
deploy task create --file task.json(key 可与旧项目同名,二者命名空间独立)。 - 预演核对:
deploy task preview <key>与旧项目命令脚本逐条比对。 - 实跑验证:
deploy task run <key> -f,必要时--step-id抽跑关键步。 - 归档旧项目:
deploy project update <old-key> --file传{"key":"<old-key>","archived":true}; 确认无引用后再考虑删除(更新、归档与删除)。 - 改自动化引用:把脚本里的
run <key> --command-id …换成task run <key> --step-id N,删掉前置的project get。
迁移检查表
- [ ] 任务定义不含 Git/依赖字段。
- [ ] steps 顺序与旧 commands 一致(位置 ID 即新引用)。
- [ ] Secret 以
envs数组迁移,isSecret 保持。 - [ ] Hook Token:旧项目的 hk_ 令牌不自动转移,需在任务详情页重建并更新外部调用方。
- [ ] 旧项目已归档;依赖它的其他项目已解除依赖。
- [ ] 运行历史保留在旧项目下(归档不删历史),审计需要时仍可查。
反向迁移
任务后来需要拉代码构建?新建项目并把步骤搬为命令,而不是给任务加 Git——类型语义不支持。 迁移方向总是「向语义更丰富的类型新建」,旧定义归档留痕。