docs: 更新连通性检查文档 — 重试机制 + 双向检查

This commit is contained in:
aiyimickey 2026-05-15 15:21:33 +08:00
parent ccc0f5800d
commit f3373d6f9a
1 changed files with 14 additions and 9 deletions

View File

@ -64,23 +64,28 @@ bash scripts/deploy-ai.sh [选项]
## 部署后验证
### 公共 URL 检查
### 部署后 API 连通性检查
部署完成后检查站点 HTTP 状态码200/301/307 视为成功
部署 issue-ai 和 assets-ai 后自动执行双向连通性检查,均带 **重试机制**3 次、间隔 10s应对同时部署两个站点时目标容器暂不可达的情况
### issue→assets API 连通性检查
部署 issue-ai 后自动执行:
| 部署站点 | 检查方向 | 使用 Key | 目标 URL |
|---------|---------|---------|----------|
| issue-ai | issue → assets | `ASSETS_API_KEY` | `ASSETS_API_URL/assets?pageSize=1` |
| assets-ai | assets → issue | `ISSUE_API_KEY` | `ISSUE_API_URL/tickets?pageSize=1` |
流程:
1. 将连通性检查脚本发送到 txjp 宿主机
2. `docker cp` issue-ai 容器内
3. 使用容器内的 `ASSETS_API_KEY``ASSETS_API_URL/assets?pageSize=1`
4. 返回 200 → 通过;返回 401 → **部署失败退出**,提示检查 API Key 配置
2. `docker cp`对应容器内
3. 容器内 Node.js 发起 HTTP 请求,失败自动重试(最多 3 次,间隔 10s
4. 返回 200 → 通过;全部重试仍失败 → **部署失败退出**
**错误输出示例**
```
[✗] issue→assets API 连通性检查失败!请检查 ASSETS_API_KEY 是否在 assets-ai 中注册
连通失败: HTTP 401 (请检查 ASSETS_API_KEY 是否在 assets-ai 的 API Keys 中注册)
连接失败: HTTP 401 (第1次)
10s 后重试...
连通失败: HTTP 401 (第2次)
已达最大重试次数
```
## 排除文件