diff --git a/deploy-ai-readme.md b/deploy-ai-readme.md index f77ea3f..8054adf 100644 --- a/deploy-ai-readme.md +++ b/deploy-ai-readme.md @@ -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次) + 已达最大重试次数 ``` ## 排除文件