jack
ab1515dffb
- 中央：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
56 lines
2.3 KiB
Markdown
56 lines
2.3 KiB
Markdown
# 部署指南
|
||
|
||
部署顺序：中央 → 边缘 → 多用户/告警（可选）。详见 [README](README.md)。
|
||
|
||
---
|
||
|
||
## 第一步：部署中央服务器
|
||
|
||
**前置**：Docker、Docker Compose；端口 3000、9091、8428、9093 未被占用；磁盘充足。
|
||
|
||
```bash
|
||
cd central-server
|
||
cp env.example .env # 可选，按需改端口、Traefik 等
|
||
bash deploy.sh
|
||
```
|
||
|
||
**验证**：Grafana http://localhost:3000（admin/admin123）、Prometheus http://localhost:9091、VictoriaMetrics http://localhost:8428。
|
||
|
||
**详细**：[CENTRAL_SERVER_CONFIG](CENTRAL_SERVER_CONFIG.md)、[central-server/CONFIGURATION.md](../central-server/CONFIGURATION.md)。
|
||
|
||
---
|
||
|
||
## 第二步：部署边缘节点
|
||
|
||
**前提**：中央已运行，VictoriaMetrics 8428 可访问。
|
||
|
||
- **本机同机**：`cd edge-agent && bash deploy.sh --local`（中央地址设为 host.docker.internal:8428）。
|
||
- **边缘跨机**：`cd edge-agent` → 编辑 `.env` 中 `CENTRAL_SERVER_HOST=中央IP` → `bash deploy.sh`。
|
||
|
||
**验证**：边缘 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。
|
||
- 端口冲突：边缘已映射 9092，与中央 9091 区分。
|
||
|
||
**详细**：[EDGE_AGENT_CONFIG](EDGE_AGENT_CONFIG.md)、[TARGETS_AND_MONITORING](TARGETS_AND_MONITORING.md)。
|
||
|
||
---
|
||
|
||
## 第三步（可选）：多用户与告警
|
||
|
||
- **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` 中相关服务 Up；Grafana Prometheus 数据源可查 `up`。
|
||
- **边缘**：prometheus-edge、blackbox-exporter Up；Grafana 选 VictoriaMetrics 可查 `probe_success{job="network-ping"}`。
|
||
- **磁盘/端口**：`ss -tulpn` 查端口；空间不足时清理或扩容。
|
||
|
||
详见 [TROUBLESHOOTING](TROUBLESHOOTING.md)。
|