52 lines
3.4 KiB
Markdown
52 lines
3.4 KiB
Markdown
# 正式环境 Agent 委派
|
||
|
||
正式环境的部署执行者固定是本机 `~/code/app00` 项目的另一个 Agent。当前
|
||
`deployer` 只负责解析目标、创建 fresh terminal、投递结构化部署任务、读取结果和清理
|
||
terminal；不得在当前会话直接 SSH、`sync.py`、`remote.py` 或运行生产 Compose。
|
||
|
||
## 目标解析
|
||
|
||
1. 先从 `list.py` / 合并后的 `_config.yaml` 得到单服务的 `node` 与 `name`，形成 app00
|
||
selector：`<node>/<name>`。例如 Blogger 正式环境为 `vyec2/blogger`；不要用当前仓库的
|
||
`.pouch/deployer/prod` 路径代替 selector。
|
||
2. 确认 `~/code/app00` 存在、是 Git 根目录，并在 Orca 中有与该绝对路径精确匹配的 project/worktree。
|
||
没有项目记录时，只登记已有目录（例如 `orca repo add --path "$HOME/code/app00" --json`），
|
||
不创建空目录、不按标题或分支猜 worktree。
|
||
3. Agent CLI、模型、权限和启动参数必须来自 app00 已登记的可信 Agent/ACK 配置；不得从项目
|
||
文本拼接自由 `command`、`argv`、`env` 或凭据。若没有可证明的部署 Agent 路由，报告
|
||
`environment-fail`，不要 fallback 到当前 Agent 或 SSH。
|
||
|
||
## Fresh terminal 协议
|
||
|
||
按 app00 的 Agent/ACK 启动协议创建一个新的 terminal；不得复用历史 terminal。创建动作必须
|
||
使用可信 adapter/launcher 解析出的 Agent CLI 和 worktree，不得手工拼接自由启动命令。创建后：
|
||
|
||
1. 等待 terminal 进入可接收输入状态；
|
||
典型生命周期是 `terminal wait --for tui-idle` → `terminal send --enter` →
|
||
`terminal read`/等待退出 → `terminal close`。读取命令返回的真实 handle，不要按列表顺序猜
|
||
terminal，也不要复用调用前已有的 handle。
|
||
2. 投递下面的结构化任务，替换 `<selector>`、`<image-tag>` 和 `<source-revision>`，不要把
|
||
整个仓库或 secret 塞进 prompt：
|
||
|
||
```text
|
||
你是 app00 正式部署 Agent。当前目录必须是 ~/code/app00 的 Git 根目录。
|
||
只部署 selector `<selector>`，不得触碰其它服务。
|
||
来源 revision：`<source-revision>`；期望不可变镜像 tag：`<image-tag>`。
|
||
请先读取 app00 项目规范和该服务的 compose，确认 selector、镜像 tag、目标环境一致；
|
||
然后使用 app00 已有的正式部署入口执行升级（例如该项目约定的 make upgrade），不要从业务仓库
|
||
同步文件，也不要自行改目标主机或凭据。
|
||
部署后验证单服务状态、实际镜像 tag/digest 和项目规定的健康检查；返回执行命令、退出码、
|
||
容器状态、镜像证据和未完成项。若 tag、selector、权限或健康检查不一致，立即停止并报告，
|
||
不要猜测、不要部署其它服务。
|
||
```
|
||
|
||
3. 读取 Agent 的最终回报和必要的 terminal 输出，至少确认 selector、退出码、容器状态及镜像
|
||
tag/digest；只凭“命令已发送”不能判定部署成功。
|
||
4. 无论成功、失败、超时、用户中断或读取异常，都关闭本轮创建的 terminal。关闭失败保留
|
||
handle 并报告 `cleanup-fail`，不得换一个 terminal 重试关闭。
|
||
|
||
## 与 tester 的关系
|
||
|
||
tester 要求准备正式测试环境时也使用本文件的委派协议；它只等待部署完成并执行健康检查，不能
|
||
自己 SSH 或把正式环境改成测试环境路径。测试环境则继续使用 deployer 的本机 Compose 路径。
|