105 lines
6.1 KiB
Markdown
105 lines
6.1 KiB
Markdown
# 时序
|
||
|
||
## 默认：MCP 全链路（业务部署）
|
||
|
||
```text
|
||
用户 Agent company-deploy-mcp Gitea Dokploy
|
||
│ │ │ │ │
|
||
│ 部署/上线 │ │ │ │
|
||
│─────────────────►│ │ │ │
|
||
│ │ whoami / get_my_quota │ │ │
|
||
│ │────────────────────────►│ │ │
|
||
│ │ Dockerfile + 本地校验 │ │ │
|
||
│ │ ensure_repository │ │ │
|
||
│ │────────────────────────►│──建库(可选)─────►│ │
|
||
│ │◄────────────────────────│◄─────────────────│ │
|
||
│ │ git push（企业凭据） │ │ │
|
||
│ │───────────────────────────────────────────►│ │
|
||
│ │ create_deployment_plan │ │ │
|
||
│ │────────────────────────►│ │ │
|
||
│ │ apply_deployment_plan │ │ │
|
||
│ │────────────────────────►│ │ │
|
||
│ │ │ ensure app │ │
|
||
│ │ │ mounts (/data+) │ │
|
||
│ │ │ postgres/mysql? │ │
|
||
│ │ │ domain buxi+5+LE │ │
|
||
│ │ │ deploy ──────────┼──────────────►│
|
||
│ │ │ │ clone/build │
|
||
│ │ get_deployment_status │ │ run │
|
||
│ │────────────────────────►│──status──────────┼──────────────►│
|
||
│ │ 探活 https://buxi…. │ │ │
|
||
│ 交付 HTTPS 链接 │ │ │ │
|
||
│◄─────────────────│ │ │ │
|
||
```
|
||
|
||
要点：
|
||
|
||
- **建库 / 挂卷 / PG·MySQL / 域名 / deploy** 全在 MCP `apply` 内
|
||
- **push** 只在 Agent 本机
|
||
- 业务用户不接触 Gitea / Dokploy / Token
|
||
|
||
参数与示例：`mcp-deploy.md`。域名与证书：`domain.md`。
|
||
|
||
---
|
||
|
||
## 日常二次发布（MCP）
|
||
|
||
```text
|
||
用户 → Agent → git push → create_deployment_plan(新 SHA)
|
||
→ apply_deployment_plan
|
||
→ 复用 mapping（域名、卷、库、配额名额）
|
||
→ 轮询 + 探活
|
||
```
|
||
|
||
- 同一 `repo` + `environment`：**不新建** Dokploy 应用名额
|
||
- 域名 host **不变**
|
||
- 数据卷 **不变**（应用须写在挂载路径）
|
||
- plan 一次性；每次发布新建 plan
|
||
|
||
---
|
||
|
||
## Legacy：直连 Dokploy（运维例外）
|
||
|
||
```text
|
||
用户 Agent Gitea Dokploy
|
||
│ │ │ │
|
||
│ 明确要求直连 │ │ │
|
||
│───────────────────►│ source .env.deploy │ │
|
||
│ │ Dockerfile │ │
|
||
│ │ 建仓+git push │ │
|
||
│ │────────────────────►│ │
|
||
│ │ application.* │ │
|
||
│ │ mounts / domain │ │
|
||
│ │ application.deploy │ │
|
||
│ │──────────────────────────────────────────►│
|
||
│ │ 轮询 + 探活 │ │
|
||
│◄───────────────────│ │ │
|
||
```
|
||
|
||
仅当 MCP 不可用且有 `.env.deploy` + `DEPLOY_AUTHORIZED=true`。
|
||
默认对话 **不要** 走这条。
|
||
|
||
---
|
||
|
||
## 责任边界
|
||
|
||
| 角色 | MCP 路径 | Legacy 路径 |
|
||
|------|----------|-------------|
|
||
| 用户 | 飞书登录拿 `buxi_`；说「部署」 | 提供/保管 `.env.deploy`（运维） |
|
||
| Agent | 工程 + push + 调 MCP 工具 + 交付 URL | 工程 + push + 直调 Dokploy API |
|
||
| company-deploy-mcp | 身份/配额/审计/Gitea 建库/Dokploy 编排 | — |
|
||
| Gitea | 源码 | 源码 |
|
||
| Dokploy | 构建运行/卷/库/Traefik+LE | 同左（Agent 直调） |
|
||
|
||
---
|
||
|
||
## 异步语义
|
||
|
||
| 动作 | 含义 |
|
||
|------|------|
|
||
| `apply_deployment_plan` 返回 200 | 已受理编排与 deploy 请求 |
|
||
| `deploymentRequested: true` | 不等于用户已可稳定访问 |
|
||
| 上线完成 | Dokploy 部署终态成功 +（Web）HTTPS 探活通过 |
|
||
|
||
构建失败：`get_deployment_status` / `get_sanitized_logs`，修代码或 Dockerfile 后新 SHA 再 plan+apply。
|