Правки различные

2026-08-26 11:05:32 +03:00
parent c1e49fb15d
commit 728b9826a3
36 changed files with 722 additions and 1986 deletions
@@ -1,7 +1,8 @@
 # SigNoz для HAN Chat

 Одноузловой self-hosted SigNoz на Ubuntu 24.04 через официальный
-`foundryctl` и Docker Compose.
+`foundryctl` и Docker Compose. Исполняемый порядок раскатки, lockdown и
+обновления — только в [docs/RUNBOOK.ru.md](docs/RUNBOOK.ru.md).

 Сетевая модель:

@@ -19,127 +20,13 @@
 - рабочий приватный интерфейс с адресом `192.168.0.5`;
 - доступ к ВМ по SSH через приватную сеть до отключения внешнего IP.

-## Установка
-
-Скопируйте эту папку на ВМ, например в `/opt/signoz`:
-
-```bash
-rsync -rltD --no-perms --no-owner --no-group -ivc --delete \
-  --exclude='.env' \
-  --exclude='dist/' \
-  --exclude='secrets/' \
-  --exclude='pours/' \
-  --exclude='casting.yaml.lock' \
-  -e "ssh -i ~/.ssh/hansel-private" \
-  /mnt/c/Users/MI/Documents/Assistent/HAN_chat_specification/codebase/Signoz/ \
-  root@135.106.166.7:/opt/signoz/
-```
-
-Исключения `pours/` и `casting.yaml.lock` обязательны при повторной
-синхронизации: Foundry создаёт их непосредственно на VM. Без исключений
-`rsync --delete` удалит runtime-конфигурацию, которой нет локально.
-
-На ВМ:
-
-```bash
-cd /opt/signoz
-sed -i 's/\r$//' scripts/*.sh
-chmod +x scripts/*.sh
-
-sudo ./scripts/05-configure-private-network.sh
-sudo PRIVATE_IP=192.168.0.5 ./scripts/00-check-vm.sh
-sudo ./scripts/10-install-docker.sh
-sudo PRIVATE_IP=192.168.0.5 ./scripts/20-deploy-signoz.sh
-```
-
-После запуска создайте первого администратора и организацию SigNoz. До этого
-OpAMP не выдаст ingester рабочую OTLP-конфигурацию, хотя контейнер будет
-выглядеть запущенным.
-
-Адреса `127.0.0.1` всегда означают loopback той машины, на которой
-интерпретируются. HAN_CHAT имеет приватный адрес `192.168.0.1`, а SigNoz —
-`192.168.0.5`. UI слушает `127.0.0.1:8080` именно на VM SigNoz.
-
-Для постоянного доступа после удаления публичного IP SigNoz добавьте в
-`C:\Users\MI\.ssh\config`:
-
-```sshconfig
-Host han-jump
-    HostName 135.106.164.58
-    User root
-    IdentityFile C:\Users\MI\.ssh\hansel
-
-Host signoz-private
-    HostName 192.168.0.5
-    User root
-    IdentityFile C:\Users\MI\.ssh\hansel-private
-    ProxyJump han-jump
-```
-Затем ssh signoz-ui -N
-
-(устаревшее: 
-На рабочем компьютере откройте туннель до SigNoz через HAN_CHAT:
-
-```powershell
-ssh -L 8080:127.0.0.1:8080 signoz-private -N
-```
-)
-Маршрут SSH: Windows → публичный адрес HAN_CHAT → `192.168.0.5:22`.
-Назначение `127.0.0.1:8080` в `-L` открывает конечная VM SigNoz, а не
-HAN_CHAT.
-
-Откройте `http://127.0.0.1:8080`, создайте администратора/организацию, затем
-на VM выполните:
-
-```bash
-cd /opt/signoz
-sudo docker compose -f pours/deployment/compose.yaml restart ingester
-sudo ./scripts/30-verify-signoz.sh
-```
-
-После успешной проверки настройте host firewall. Подставьте реальный приватный
-IP backend:
-
-```bash
-sudo OTLP_SOURCE=192.168.0.1 \
-  ADMIN_CIDR=192.168.0.0/24 \
-  PRIVATE_IP=192.168.0.5 \
-  ./scripts/40-configure-firewall.sh
-```
-
-Затем выполните чек-лист из [docs/NETWORK.md](docs/NETWORK.md), подключите
-backend по [docs/BACKEND_OTLP.md](docs/BACKEND_OTLP.md) и только после
-успешной end-to-end проверки удалите внешний IP.
-
-## Проверка и управление
-
-```bash
-cd /opt/signoz
-sudo ./scripts/30-verify-signoz.sh
-sudo docker compose -f pours/deployment/compose.yaml ps
-sudo docker compose -f pours/deployment/compose.yaml logs --tail=200
-sudo docker compose -f pours/deployment/compose.yaml restart
-```
-
-Не редактируйте `pours/` вручную: Foundry перегенерирует эту папку.
-Постоянные изменения вносятся в `casting.yaml`, после чего снова запускается
-`20-deploy-signoz.sh`.
-
-Обновление требует временного доступа к Docker Hub, GitHub и SigNoz:
-
-```bash
-cd /opt/signoz
-sudo ./scripts/20-deploy-signoz.sh
-```
-
-Перед обновлением сделайте snapshot диска ВМ. Данные находятся в Docker
-volumes ClickHouse и PostgreSQL; `docker compose down -v` удалит их и поэтому
-для штатного обслуживания запрещён.
-
 ## Документация

+- [RUNBOOK.ru.md](docs/RUNBOOK.ru.md) — раскатка ВМ3, verify, firewall,
+  lockdown, обновление и rollback;
 - [NETWORK.md](docs/NETWORK.md) — сеть, группа безопасности, SSH-туннель;
 - [BACKEND_OTLP.md](docs/BACKEND_OTLP.md) — передача телеметрии HAN Chat;
- [SIGNOZ_RUNBOOK.md](docs/SIGNOZ_RUNBOOK.md) — что смотреть в SigNoz;
+- [SIGNOZ_RUNBOOK.md](docs/SIGNOZ_RUNBOOK.md) — ежедневная работа в UI и
+  разбор инцидентов;
 - [MVP_DASHBOARDS_ALERTS.md](docs/MVP_DASHBOARDS_ALERTS.md) — versioned
  спецификация первых dashboards и alerts.