主题
运行第一个任务
任务用于「跑一件事」:勘察、改配置、清缓存。没有 Git、没有依赖,步骤 ID 稳定。
创建任务
bash
deploy task create \
--key disk-check --name "磁盘巡检" \
--workdir /srv/deploy/workspaces/disk-check \
--step "总览::df -h" \
--step "大目录::du -xh --max-depth=2 /srv 2>/dev/null | sort -rh | head -20"或用 JSON 定义(步骤可 scriptFile):
json
{
"key": "disk-check",
"name": "磁盘巡检",
"workdir": "/srv/deploy/workspaces/disk-check",
"steps": [
{ "name": "总览", "script": "df -h" },
{ "name": "大目录", "script": "du -xh --max-depth=2 /srv 2>/dev/null | sort -rh | head -20" }
]
}bash
deploy task create --file task.json先预演再执行
bash
deploy task preview disk-checkpreview 只展开脚本与工作目录、不执行,用于审查破坏性步骤(rm、覆盖配置等)。
执行与选择性执行
bash
deploy task run disk-check -f # 全部步骤
deploy task get disk-check # 步骤表 ID = 位置序号
deploy task run disk-check --step-id 2 -f # 只跑第 2 步步骤 ID 是位置序号(1 起),task update 后不变——与项目命令 ID 每次 update 重生成形成对照, 所以 --step-id 不需要每次重新读 ID。
与项目共用的部分
运行记录、日志、取消完全同构:
bash
deploy runs list --project disk-check # 任务运行同样把 task key 存于该过滤列
deploy logs <runId> -f
deploy stop <runId>Hook 也共用:任务详情页可创建 Hook Token,外部系统 POST 即触发,见 HTTP Hook 触发。
什么时候该用项目而不是任务
需要拉代码构建、需要依赖先建、需要「发布 + 重启 + 健康检查」的重复流程 → 项目。 判断细则与真实迁移教训见 从项目迁移到任务。