Skip to content

部署第一个项目 ​

用一个最小项目走通「创建 → 触发 → 跟随 → 终态」闭环。示例不依赖 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 任务」的差别。