global-search-api/DEPLOY-V2.md

32 lines
1.0 KiB
Markdown
Raw Normal View History

# V2 部署说明
V2 必须与旧版并行启动,不覆盖旧的 `server.py`、旧服务或旧网址。
部署前,服务器上应当已经有:
- `/opt/zhuyuan/fifth-domain/world-router.json`(广播塔权威登记表)
- `/opt/zhuyuan/<仓库名>/`(已经挂载、可供搜索的仓库副本)
启动参数:
```bash
cd /opt/zhuyuan/global-search-api
WORLD_ROUTER_PATH=/opt/zhuyuan/fifth-domain/world-router.json \
REPO_ROOT=/opt/zhuyuan PORT=3951 python3 server_v2.py
```
反向代理新增一个比旧规则更靠前的精确前缀,把
`/global-search/v2/` 转给 `127.0.0.1:3951/v2/`。不要改动现有
`/global-search/`;它保留给既有调用,直到 V2 验收完成。
验收只需四项:
```text
/global-search/v2/help
/global-search/v2/repos
/global-search/v2/resolve?q=铸渊
/global-search/v2/context?q=GLSV
```
其中 `repos` 必须显示第五域为可用,且提交号等于服务器上第五域的当前提交号;否则先同步仓库,不能把旧副本对外宣布为当前内容。