Files
buryan-infra/ops/notify/README.md

51 lines
2.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Единый слой уведомлений
## Зачем
Доступ к Telegram нестабилен, и оповещение инфраструктуры нельзя строить
на канале, который может не работать. Поэтому **Matrix — основной канал**,
Telegram — зеркало.
Проверено 15.10.2026: тестовое уведомление доставлено в Matrix,
**в Telegram — НЕ доставлено**. Именно поэтому слой и построен.
## Как устроено
```
событие (диск, сертификат, хранилище, обновление)
↓
notify.send(text)
├─→ Matrix (основной) — комната «Инфраструктура: уведомления»
└─→ Telegram (зеркало) — если доступен
```
`send()` возвращает `True`, если доставлено **хотя бы одним** каналом, —
чтобы вызывающая сторона не слала уведомление повторно.
## Файлы
| Файл | Назначение |
|---|---|
| `/root/.buryan-notify.env` | адрес Matrix, токен, комната (права 600) |
| `/opt/buryan-hub/scripts/notify.py` | сам модуль |
| `ops/notify/*.py` | копия в репозитории для истории |
## Комната
`!xmPlMatgPxoOgHOPEA:matrix.buryans.ru` — «Инфраструктура: уведомления»,
**без сквозного шифрования**: это машинные сообщения, а не переписка.
Для команд людей используется отдельная комната бота.
## Как переведены скрипты
Исходная функция переименована в `send_alert_telegram`, а `send_alert`
стала обёрткой над общим слоем. **Логика не изменилась** — те же имя,
аргумент и результат. Копии оригинала лежат рядом: `*.before-notify`.
Откат одного скрипта: `cp check_disk.py.before-notify check_disk.py`.
## Задел
Слой позволяет добавить третий канал (или убрать Telegram) изменением
одного файла, а не сорока трёх.