主题
部署第一个项目
用一个最小项目走通「创建 → 触发 → 跟随 → 终态」闭环。示例不依赖 Git,先感受执行模型;真实 Java/前端案例见 部署案例。
创建项目
bash
deploy project create \
--key hello --name "Hello 部署" \
--workdir /srv/deploy/workspaces/hello \
--command "准备::mkdir -p /tmp/hello-app && echo ready" \
--command "发布::echo version-1 > /tmp/hello-app/VERSION" \
--command "健康检查::test -s /tmp/hello-app/VERSION && cat /tmp/hello-app/VERSION"'名称::脚本' 给命令命名,省略则自动命名。不带必需参数时 project create 进入交互式向导。 Windows 上没有 bash 的 $(cat …) 写法:把定义写成 JSON 用 --file 读入,命令用 scriptFile 指向脚本文件(相对 JSON 目录),见 项目命令。
查看定义:
bash
deploy project get hello输出包含命令列表(带 ID)与环境变量。记下命令 ID 的用法差异:项目命令 ID 每次 update 重新生成。
触发并跟随
bash
deploy run hello -f-f 先补历史日志再实时跟随到结束,收尾摘要形如:
text
运行 ID #1(构建号 #1) success 退出码 0 耗时 0.4s只要结果不看日志用 --wait;脚本化加 --json(stdout 为 JSONL 日志事件 + 一行终态对象)。
检查终态与历史
bash
deploy runs list --project hello
deploy logs 1 # 回放历史日志退出码契约:0 成功;1 运行 failed/timeout/error/canceled;2 用法错误;3 鉴权失败;4 网络不可用。 Ctrl+C 默认只断开跟随、不取消运行;要取消加 --cancel-on-interrupt 或另开终端 deploy stop <runId>。
改一步再跑
bash
deploy project update hello --file hello.json # 只改文件里给出的字段
deploy project get hello # 命令 ID 已重新生成,选择性运行前必读
deploy run hello --command-id <新ID> -f加上 Git 准备
真实项目通常开启 Git:--use-git --git-url <仓库> --git-branch main,私有仓库先在「系统设置 → 凭据」创建凭据并测试连接。 服务端会在每次运行前 clone 或 fetch + checkout 对齐分支,并注入 GIT_COMMIT 等变量。详见 Git 准备阶段。
下一步
运行第一个任务,体会「项目 vs 任务」的差别。