refactor: config/apps 目录重组、文档重构、架构图收窄

- 中央:config/(prometheus,alertmanager,grafana)、apps/(tile-cache,topology-editor)
- 边缘:config/(vmagent,blackbox,targets)、apps/(onvif-exporter)
- env: TRAEFIK_PROVIDER、prometheus/env.example 详细说明
- 文档:README/doc 重构,EDGE_CACHE 合并到 EDGE_AGENT_CONFIG
- targets.csv 更新流程说明,ARCHITECTURE 图收窄

Made-with: Cursor
This commit is contained in:
2026-02-28 22:05:43 -05:00
parent 650e5145f1
commit ab1515dffb
48 changed files with 2071 additions and 509 deletions

View File

@@ -1,21 +1,23 @@
# 部署指南
部署顺序**[doc/README.md](README.md)#部署顺序**:中央 → 边缘 → 多用户/告警(可选)。本文为各步操作与验证要点
部署顺序:中央 → 边缘 → 多用户/告警(可选)。详见 [README](README.md)。
---
## 第一步:部署中央服务器
**前置**Docker、Docker Compose端口 3000、9091、8428、9093、4090 未被占用;磁盘充足。
**前置**Docker、Docker Compose端口 3000、9091、8428、9093 未被占用;磁盘充足。
```bash
cd central-server
cp env.example .env # 可选
cp env.example .env # 可选按需改端口、Traefik 等
bash deploy.sh
```
**验证**Grafana http://localhost:3000admin/admin123、Prometheus http://localhost:9091、VictoriaMetrics http://localhost:8428。
**详细**[CENTRAL_SERVER_CONFIG](CENTRAL_SERVER_CONFIG.md)、[central-server/CONFIGURATION.md](../central-server/CONFIGURATION.md)。
---
## 第二步:部署边缘节点
@@ -23,29 +25,31 @@ bash deploy.sh
**前提**中央已运行VictoriaMetrics 8428 可访问。
- **本机同机**`cd edge-agent && bash deploy.sh --local`(中央地址设为 host.docker.internal:8428
- **边缘在另一台机器**
- 在 edge-agent 下 `cp env.example .env`,编辑 `CENTRAL_SERVER_HOST``CENTRAL_SERVER_PORT=8428`
- `bash deploy.sh`(会自动调用 update-configs
- **边缘跨机**`cd edge-agent` → 编辑 `.env``CENTRAL_SERVER_HOST=中央IP``bash deploy.sh`
**验证**:边缘 Prometheus http://localhost:9092(或边缘机 IP:9092;中央 Grafana 选数据源 **VictoriaMetrics**,查询 `probe_success{job="network-ping"}` 可见边缘数据。
**验证**:边缘 http://localhost:9092中央 Grafana 选数据源 **VictoriaMetrics**,查询 `probe_success{job="network-ping"}` 可见边缘数据。
**targets.csv**:部署时自动生成 target-*.json修改 targets.csv 后需手动 `cd config && ./update-configs.sh`vmagent 每 5 分钟自动重载。
**常见问题**
- 看不到边缘数据:确认 `.env` 中为中央 IP host.docker.internal,除非本机同机);从边缘 `curl -s -o /dev/null -w "%{http_code}" http://<中央IP>:8428/health` 应为 200。
- 端口冲突:边缘 Prometheus 已映射 9092避免与中央 9091 冲突
- 看不到边缘数据:确认 `.env` 中为中央 IP跨机不能用 host.docker.internal`curl -s -o /dev/null -w "%{http_code}" http://<中央IP>:8428/health` 应为 200。
- 端口冲突:边缘已映射 9092与中央 9091 区分
**详细**[EDGE_AGENT_CONFIG](EDGE_AGENT_CONFIG.md)、[TARGETS_AND_MONITORING](TARGETS_AND_MONITORING.md)。
---
## 第三步(可选):多用户与告警
- **Grafana 多用户**`cd central-server/grafana && bash setup-users.sh`见 [USER_MANAGEMENT.md](USER_MANAGEMENT.md)。
- **告警**:规则见 [ALERTING.md](ALERTING.md);通知渠道编辑 `central-server/alertmanager/alertmanager.yml`
- **Grafana 多用户**`cd central-server/config/grafana && bash setup-users.sh`,见 [USER_MANAGEMENT](USER_MANAGEMENT.md)。
- **告警**:规则见 [ALERTING](ALERTING.md);通知渠道编辑 `central-server/config/alertmanager/alertmanager.yml`
---
## 部署后检查清单
- **中央**`docker compose ps` 中相关服务 UpGrafana Prometheus 数据源可查 `up`
- **边缘**prometheus-edge、blackbox-exporter UpGrafana 选 VictoriaMetrics 可查 `probe_success{job="network-ping"}` 等。
- **磁盘/端口**端口冲突用 `ss -tulpn` 查;空间不足时清理或扩容数据目录
- **中央**`docker compose ps` 中相关服务 UpGrafana Prometheus 数据源可查 `up`
- **边缘**prometheus-edge、blackbox-exporter UpGrafana 选 VictoriaMetrics 可查 `probe_success{job="network-ping"}`
- **磁盘/端口**`ss -tulpn`端口;空间不足时清理或扩容。
详见 [TROUBLESHOOTING.md](TROUBLESHOOTING.md)、[README.md](README.md)
详见 [TROUBLESHOOTING](TROUBLESHOOTING.md)。