72a5bf30b4
- tile-cache: 瓦片缓存服务(vec/cva)、启动探针、详细日志、上游超时可配置(UPSTREAM_TIMEOUT_MS) - central: docker-compose 集成 tile-cache，env.example 增加 TILE_CACHE_* / TIANDITU_TK - topology-editor: 天地图/缓存加载、GPS 安全来源错误提示、TIANDITU 文档(403/白名单、localhost 测试说明) - doc: README 部署步骤与 GPS 安全来源说明，TIANDITU_CONFIG 完善 Co-authored-by: Cursor <cursoragent@cursor.com>
62 lines
2.7 KiB
Markdown
62 lines
2.7 KiB
Markdown
# 部署指南
|
||
|
||
部署顺序见 **[doc/README.md](README.md)#部署顺序**：中央 → 边缘 → 多用户/告警（可选）→ 拓扑标注（可选）。本文为各步操作与验证要点。
|
||
|
||
---
|
||
|
||
## 第一步：部署中央服务器
|
||
|
||
**前置**：Docker、Docker Compose；端口 3000、9091、8428、9093、4080 未被占用；磁盘充足。
|
||
|
||
```bash
|
||
cd central-server
|
||
cp env.example .env # 可选
|
||
bash deploy.sh
|
||
```
|
||
|
||
**验证**：Grafana http://localhost:3000（admin/admin123）、Prometheus http://localhost:9091、VictoriaMetrics http://localhost:8428、拓扑标注助手 http://localhost:4080。
|
||
|
||
---
|
||
|
||
## 第二步：部署边缘节点
|
||
|
||
**前提**：中央已运行，VictoriaMetrics 8428 可访问。
|
||
|
||
- **本机同机**：`cd edge-agent && bash run-edge-local.sh`（中央地址设为 host.docker.internal:8428）。
|
||
- **边缘在另一台机器**：
|
||
- 在 edge-agent 下 `cp env.example .env`，编辑 `CENTRAL_SERVER_HOST`、`CENTRAL_SERVER_PORT=8428`。
|
||
- `cd config && ./update-configs.sh && cd .. && bash deploy.sh`。
|
||
|
||
**验证**：边缘 Prometheus http://localhost:9092（或边缘机 IP:9092）；中央 Grafana 选数据源 **VictoriaMetrics**，查询 `probe_success{job="network-ping"}` 可见边缘数据。
|
||
|
||
**常见问题**：
|
||
- 看不到边缘数据：确认 `.env` 中为中央 IP（非 host.docker.internal，除非本机同机）；从边缘 `curl -s -o /dev/null -w "%{http_code}" http://<中央IP>:8428/health` 应为 200。
|
||
- 端口冲突：边缘 Prometheus 已映射 9092，避免与中央 9091 冲突。
|
||
|
||
---
|
||
|
||
## 第三步（可选）：多用户与告警
|
||
|
||
- **Grafana 多用户**：`cd central-server/grafana && bash setup-users.sh`，详见 [USER_MANAGEMENT.md](USER_MANAGEMENT.md)。
|
||
- **告警**：规则见 [ALERTING.md](ALERTING.md)；通知渠道编辑 `central-server/alertmanager/alertmanager.yml`。
|
||
|
||
---
|
||
|
||
## 第四步（可选）：拓扑标注助手
|
||
|
||
与中央同机运行，访问 http://localhost:4080。上传本机 `targets.csv` → 选择设备、GPS 或地图点击补坐标 → 保存 → 下载 CSV → 将下载文件部署到各边缘 `edge-agent/config/targets.csv`，在边缘执行：
|
||
|
||
```bash
|
||
cd edge-agent/config && ./update-configs.sh && ./csv-to-topology-geojson.sh targets.csv topology.geojson
|
||
```
|
||
|
||
---
|
||
|
||
## 部署后检查清单
|
||
|
||
- **中央**：`docker compose ps` 中相关服务 Up；Grafana 中 Prometheus 数据源可查 `up`。
|
||
- **边缘**：prometheus-edge、blackbox-exporter Up；Grafana 选 VictoriaMetrics 可查 `probe_success{job="network-ping"}` 等。
|
||
- **磁盘/端口**：端口冲突用 `ss -tulpn` 排查；空间不足时清理或扩容数据目录。
|
||
|
||
详见 [TROUBLESHOOTING.md](TROUBLESHOOTING.md)、[README.md](README.md)。
|