Initial LisgloSIPS V2 implementation
This commit is contained in:
hectorzhao
@@ -0,0 +1,123 @@
|
||||
# Server B HOMER 与基础监控 Runbook
|
||||
|
||||
本文记录 S06 在 Server B 建立的 HOMER、HEP 接收、Prometheus、Grafana 和 Exporter 基线，以及 Server A 的 Node Exporter 采集入口。当前环境是本地 KVM 开发环境，不是阿里云生产环境。
|
||||
|
||||
## 1. 固定版本
|
||||
|
||||
| 组件 | 版本/来源 | 管理方式 |
|
||||
| --- | --- | --- |
|
||||
| PostgreSQL | `16.14` | Ubuntu 官方包，用于 HOMER 数据库 |
|
||||
| Heplify Server | `github.com/sipcapture/heplify-server@v1.60.2-0.20260512101233-c74dc3d216ac` | Go 构建，二进制 SHA-256 记录在 `infra/server-b/s06/versions.env` |
|
||||
| Homer App | `github.com/sipcapture/homer-app@v0.0.0-20251021161517-9b1336352aa0` | Go 构建，监听 `127.0.0.1:9080` |
|
||||
| Prometheus | `2.45.3` | Ubuntu security/updates 包，自定义 `lisglosips-prometheus.service` |
|
||||
| Grafana | `13.0.2` | Tsinghua HTTPS 镜像包，包哈希来自官方 Packages 元数据 |
|
||||
| Node Exporter | `1.7.0` | A/B 两机 Ubuntu 包，自定义 `lisglosips-node-exporter.service` |
|
||||
| MySQL Exporter | `0.15.0` | Ubuntu 包，监听 `127.0.0.1:9104` |
|
||||
| PostgreSQL Exporter | `0.15.0` | Ubuntu 包，监听 `127.0.0.1:9187` |
|
||||
| Redis Exporter | `1.86.0` | Go 构建，监听 `127.0.0.1:9121` |
|
||||
|
||||
Docker 与 Compose 已安装但运行时禁用。最初计划使用 HOMER10 Docker 架构，但 Docker/GitHub 对象存储在当前代理链路下下载 blob 反复 EOF；S06 改为原生 HOMER7/PostgreSQL/Heplify 部署。不要在后续会话里反复重试 Docker 镜像，除非网络条件已明确修复。
|
||||
|
||||
## 2. 目录与端口
|
||||
|
||||
| 项目 | 路径/端口 |
|
||||
| --- | --- |
|
||||
| HOMER PostgreSQL 数据 | `/data/homer/postgresql` |
|
||||
| HOMER 配置 | `/etc/homer/webapp_config.json` |
|
||||
| Heplify HEP UDP | `100.90.90.91:9060/udp` |
|
||||
| Heplify Metrics | `127.0.0.1:9096` |
|
||||
| Homer App | `127.0.0.1:9080`，经 `https://homer.lisglosips.local/` 暴露 |
|
||||
| Prometheus | `127.0.0.1:9090` |
|
||||
| Grafana | `127.0.0.1:3001`，经 `https://grafana.lisglosips.local/` 暴露 |
|
||||
| B Node Exporter | `127.0.0.1:9100` |
|
||||
| A Node Exporter | `100.90.90.90:9100`，仅允许 B 访问 |
|
||||
|
||||
开发证书已重新签发，SAN 包含 `grafana.lisglosips.local` 与 `homer.lisglosips.local`。本地 CA 公钥副本仍在 `.codex-private/tls/lisglosips-dev-ca.crt`。
|
||||
|
||||
## 3. 关键服务
|
||||
|
||||
Server B：
|
||||
|
||||
```text
|
||||
postgresql.service
|
||||
heplify-server.service
|
||||
homer-app.service
|
||||
lisglosips-prometheus.service
|
||||
grafana-server.service
|
||||
lisglosips-node-exporter.service
|
||||
lisglosips-mysqld-exporter.service
|
||||
lisglosips-postgres-exporter.service
|
||||
lisglosips-redis-exporter.service
|
||||
nginx.service
|
||||
```
|
||||
|
||||
Server A：
|
||||
|
||||
```text
|
||||
lisglosips-exporter-firewall.service
|
||||
lisglosips-node-exporter.service
|
||||
```
|
||||
|
||||
A 机使用独立 `nftables` 表 `inet lisglosips_s06` 保护 9100，只允许 `100.90.90.91` 抓取。Ubuntu 包自带的 `prometheus-node-exporter.service` 已 mask，避免抢占端口。A/B 两机的 `openipmi.service` 已 mask，因为 KVM 虚拟机不支持该驱动。
|
||||
|
||||
## 4. 验收命令
|
||||
|
||||
Prometheus targets：
|
||||
|
||||
```bash
|
||||
curl -fsS http://127.0.0.1:9090/api/v1/targets
|
||||
```
|
||||
|
||||
预期 7 个 target 全部 `up`：`prometheus`、`node/server-a`、`node/server-b`、`mysql`、`postgresql_homer`、`redis`、`heplify_server`。
|
||||
|
||||
HEP 入库测试：从 A 发送 HEPv3 UDP 到 B 的 `9060`，然后在 B 查询 `homer_data.hep_proto_1_call`。S06 验收已确认测试 `INVITE` 入库，`method=INVITE`、`srcIp=100.90.90.90`、`dstIp=100.90.90.91`。
|
||||
|
||||
HTTPS：
|
||||
|
||||
```bash
|
||||
curl --fail --cacert /etc/lisglosips/pki/ca/lisglosips-dev-ca.crt \
|
||||
https://127.0.0.1/api/health
|
||||
```
|
||||
|
||||
Windows 本机可使用：
|
||||
|
||||
```powershell
|
||||
curl.exe --ssl-no-revoke --cacert .codex-private/tls/lisglosips-dev-ca.crt \
|
||||
--resolve grafana.lisglosips.local:443:100.90.90.91 \
|
||||
https://grafana.lisglosips.local/api/health
|
||||
```
|
||||
|
||||
Grafana 已预置两个 datasource：`Prometheus`、`HOMER PostgreSQL`；已预置 Dashboard：`LisgloSIPS Infrastructure Overview`。
|
||||
|
||||
## 5. 回滚
|
||||
|
||||
S06 变更前备份：
|
||||
|
||||
```text
|
||||
B: /var/backups/lisglosips-s06/20260620T132440Z
|
||||
A: /var/backups/lisglosips-s06/20260620225517
|
||||
```
|
||||
|
||||
回滚原则：
|
||||
|
||||
1. 先停止 S06 新增服务，再恢复备份配置。
|
||||
2. PostgreSQL 数据目录 `/data/homer/postgresql` 不直接删除；需要退回时先备份当前目录。
|
||||
3. Nginx 只移除 `grafana.lisglosips.local`、`homer.lisglosips.local` 站点，不影响 S05 Web 入口。
|
||||
4. A 机只删除 `inet lisglosips_s06` 表和两个 S06 服务，不碰 OpenSIPS/RTP 配置。
|
||||
|
||||
常用命令：
|
||||
|
||||
```bash
|
||||
sudo systemctl stop heplify-server homer-app lisglosips-prometheus grafana-server
|
||||
sudo systemctl stop lisglosips-mysqld-exporter lisglosips-postgres-exporter lisglosips-redis-exporter
|
||||
sudo systemctl disable --now lisglosips-exporter-firewall lisglosips-node-exporter
|
||||
sudo nft delete table inet lisglosips_s06
|
||||
```
|
||||
|
||||
## 6. 已知事项
|
||||
|
||||
- 当前 HOMER Web 为最小状态页，HOMER API、HEP 接收和 PostgreSQL 入库已可用；完整 HOMER UI 静态包等网络条件稳定后再补。
|
||||
- Grafana 插件在线检查已关闭，避免受限网络下反复报错。
|
||||
- Docker 已安装但禁用，S06 不依赖 Docker 运行。
|
||||
- A 机 `nftables` 表只保护 Node Exporter 9100，不替代后续 S18/S20 的 Server A 完整防火墙设计。
|
||||
- 生产迁移时必须替换开发 CA、正式域名、正式安全组和云监控告警策略。
|
||||
Reference in New Issue
Block a user