Skip to content

运行第一个任务 ​

任务用于「跑一件事」:勘察、改配置、清缓存。没有 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-check

preview 只展开脚本与工作目录、不执行,用于审查破坏性步骤(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 触发。

什么时候该用项目而不是任务 ​

需要拉代码构建、需要依赖先建、需要「发布 + 重启 + 健康检查」的重复流程 → 项目。 判断细则与真实迁移教训见 从项目迁移到任务。

下一步 ​

快速开始闭环完成。建议接着读 核心概念 与 项目章, 或直接看 部署案例 把示例换成真实应用。