c4825c2d27
- 对外端口统一为 18428（vmauth 入口），VM 不再直接暴露宿主机端口 - 边缘 vmagent 与中央 Prometheus remote_write 增加 basic auth - 支持 tenants.csv 驱动的 per-tenant 写入/查询隔离，并提供管理员跨租户只读查询 - 更新 Grafana provisioning 与部署/文档 Made-with: Cursor
56 lines
2.4 KiB
Markdown
56 lines
2.4 KiB
Markdown
# 部署指南
|
||
|
||
部署顺序：中央 → 边缘 → 多用户/告警（可选）。详见 [README](README.md)。
|
||
|
||
---
|
||
|
||
## 第一步：部署中央服务器
|
||
|
||
**前置**：Docker、Docker Compose；端口 3000、9091、18428、9093 未被占用；磁盘充足。
|
||
|
||
```bash
|
||
cd central-server
|
||
cp env.example .env # 可选，按需改端口、Traefik 等
|
||
bash deploy.sh
|
||
```
|
||
|
||
**验证**：Grafana http://localhost:3000（admin/admin123）、Prometheus http://localhost:9091、vmauth（VictoriaMetrics 入口）http://localhost:18428。
|
||
|
||
**详细**：[CENTRAL_SERVER_CONFIG](CENTRAL_SERVER_CONFIG.md)、[central-server/CONFIGURATION.md](../central-server/CONFIGURATION.md)。
|
||
|
||
---
|
||
|
||
## 第二步：部署边缘节点
|
||
|
||
**前提**：中央已运行，vmauth（VictoriaMetrics 入口）18428 可访问。
|
||
|
||
- **本机同机**：`cd edge-agent && bash deploy.sh --local`（中央地址设为 host.docker.internal:18428）。
|
||
- **边缘跨机**：`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>:18428/health` 应为 200（需要带鉴权时用 `-u user:pass`）。
|
||
- 端口冲突：边缘已映射 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)。
|