[OPS] buryan-hub объединён: история перенесена в ops/history/legacy-hub, старый репозиторий архивирован
lint / hygiene (push) Failing after 9s

This commit is contained in:
root committed 2026-11-06 10:21:37 +03:00
1 parent 1b0d850387
commit 443e07f541
4 files changed
+1774

No files matched your search

+259
View File
@@ -0,0 +1,259 @@
# 🤖 Контекст для AI-агентов
**⚠️ ЭТОТ ФАЙЛ ЧИТАТЬ ПЕРВЫМ ДЕЛОМ!**
## 📜 Правила работы
1. Перед действием: прочитай этот файл + релевантный runbook
2. После действия: обнови Git (commit с описанием)
3. Принял решение → создай ADR в docs/adr/
4. Нашёл проблему → добавь в docs/INCIDENTS.md
5. Не уверен → спроси Roman, не действуй наугад
## 🤖 Контракт для AI-агентов
**ОБЯЗАТЕЛЬНО К ПРОЧТЕНИЮ!** См. [ADR-006](docs/adr/ADR-006-agent-git-contract.md)
Краткие правила (из ADR-006):
1. Conventional Commits: `type(scope): описание` (feat|fix|docs|refactor|chore|adr|merge)
2. Обязательность ADR: любое архитектурное решение = новый ADR
3. Обязательность Runbook: новый сервис = новый runbook
4. Обновление CONTEXT.md: при смене статуса, нового сервиса, изменения IP
5. Workflow: Читать CONTEXT → Выполнить → ADR (если нужно) → Commit → Push → update-context.sh
## 🎯 Текущий статус (2026-08-05)
| Параметр | Значение |
|----------|----------|
| Уровень автоматизации | 35% |
| Сервисов онлайн | 28 |
| SSO интеграция | 13/28 |
| Активных инцидентов | 0 |
## 🚀 Текущий фокус: Sprint 3
### ✅ Фаза 1: Контракт для агентов (ЗАВЕРШЕНА 2026-08-05)
- [x] Git hooks (commit-msg + post-commit)
- [x] Conventional Commits стандарт
- [x] Агенты с токенами (agent-qwen, agent-openclaw)
- [x] ADR-006: контракт агентов
- [x] ADR-007: аудит через токены
### 🏦 Путь A: Безопасность (ЗАВЕРШЁН 2026-08-05)
- [x] Токены Gitea в Vaultwarden (папка Gitea Tokens)
- [x] ADR-008: схема хранения секретов
### ✅ Фаза 2: Умные алерты (ЗАВЕРШЕНА 2026-08-06)
- [x] PostgreSQL таблица host_states (29 хостов)
- [x] Дедупликация: алерт только при изменении состояния
- [x] Rate limiting: сводный алерт раз в 15 минут
- [x] ADR-009 + ADR-010
- [x] Workflow: Buryan Health Monitor + Alert Queue Processor
### 🎯 Sprint 4: Политика бэкапов + Визуализация + Агенты
#### ✅ Задача 1: Политика бэкапов 3-2-1 (ЗАВЕРШЕНА 2026-08-06)
- [x] ADR-011: Политика бэкапов
- [x] lxc-backup.sh v2 (поддержка .vma/.tar/.zstd)
- [x] immich-backup.sh (pg_dump = 16MB вместо 13GB)
- [x] Новый cron (Immich DB daily + VM weekly)
- [x] Защита от partial files при сбое vzdump
#### ⚠️ Задача 2: Grafana дашборд (ЧАСТИЧНО ЗАВЕРШЕНА 2026-08-07)
- [x] ADR-012: визуализация мониторинга
- [x] Datasource: PostgreSQL @ 192.168.1.151 (UID: cfue5hd3n320we)
- [x] Dashboard JSON в Git (infra/grafana/)
- [ ] ❌ Визуализация в UI не работает (требует ручной настройки)
- [x] URL: http://192.168.1.113:3000/d/buryan-health
- **TODO:** открыть панели в Edit, проверить Query type = Table
#### ✅ Задача 3: Обучение OpenClaw (ЗАВЕРШЕНА 2026-08-07)
- [x] ADR-013: обучение агента контракту ADR-006
- [x] Токен + git hooks для LXC 115
- [x] Клон buryan-hub в /root/buryan-hub
- [x] Identity: agent-openclaw <openclaw@buryan.local>
- [x] core.hooksPath = hooks (commit-msg + post-commit)
- [x] Credential store (/root/.git-credentials, 600)
- [x] Первый коммит: 8c54fed (push успешен, аудит работает) — Умные алерты
- [ ] Дедупликация алертов (1 алерт на проблему, не на цикл)
- [ ] Rate limiting (не чаще 1 раза в 15 минут)
- [ ] Алерт "всё восстановилось ✅"
- [ ] Grafana дашборд мониторинга
## 🔑 Критичные данные
| Ресурс | IP/URL |
|--------|--------|
| PVE | 192.168.1.10 |
| Authentik | 192.168.1.114:9000 |
| n8n UI | 192.168.1.108:5680 |
| n8n Webhook | 192.168.1.108:5678 |
| Gitea | 192.168.1.140:3000 |
| Tailscale proxy | 172.19.0.1:1055 (gateway buryan-net) |
| VPS | 185.221.198.255 |
| Vaultwarden | https://vault.buryans.ru |
| Domain | buryans.ru |
## 🗂️ Где что лежит
- ADR (решения): docs/adr/
- Runbooks: knowledge/runbooks/
- Инциденты: docs/INCIDENTS.md
- Конфиги Docker: docker/<service>/
- Workflow n8n: workflows/
## 📞 Если что-то пошло не так
1. Проверь docs/INCIDENTS.md
2. Проверь соответствующий runbook
3. Создай новый incident
4. Уведоми Roman через Telegram (@Buryans_AlertBot)
### Sprint 5 (начат 2026-08-07)
#### ✅ Задача 1: Ротация секретов (ADR-014) — ЗАВЕРШЕНА 2026-08-07
- [x] bw CLI v2025.5.0 установлен
- [x] Vaultwarden API Key настроен
- [x] Скрипт tools/rotate-gitea-tokens.sh (82 строки)
- [x] Защита: проверка длины токена перед удалением старого
- [x] Cron ежемесячно (03:00, 1-е число)
- [x] Успешный тест ротации agent-qwen
- [x] ADR-014 зафиксирован
#### ✅ Задача 2: Мониторинг thin pool (ADR-015) — ЗАВЕРШЕНА 2026-08-07
- [x] PostgreSQL таблица thin_pool_metrics (192.168.1.151:5432)
- [x] Python скрипт scripts/check_thin_pool.py
- [x] Cron каждые 5 минут (/etc/cron.d/buryan-monitor)
- [x] Пороги: WARNING 70%, CRITICAL 80%
- [x] ADR-015 зафиксирован
#### ✅ Задача 3: Offsite бэкапы (ADR-016) — ЗАВЕРШЕНА 2026-08-08
- [x] Restic на PVE и VPS
- [x] Репозиторий на VPS (100.122.43.31:/backup/restic-repo, Tailscale)
- [x] Скрипт scripts/offsite-backup.sh (7 источников данных)
- [x] Cron 05:00 ежедневно
- [x] Ротация: 7 daily + 4 weekly + 12 monthly
- [x] Первый бэкап: 315 MB -> 67 MB (дедупликация)
- [x] ADR-016 зафиксирован
#### ⚠️ TODO после Sprint 5
- [ ] Сменить пароль root на VPS (сейчас временный)
- [ ] Отключить PasswordAuthentication на VPS
### Gitea Task Dispatcher (ADR-017)
- **Workflow:** eqYDYibHxBt8NPq4
- **URL:** https://n8n.buryans.ru/webhook/gitea-task
- **Статус:** активирован, 4 успешных executions
- **Файл:** infra/n8n/workflows/gitea-task-dispatcher.json
- **Next steps:** добавить маршрутизацию по action, интеграция с Telegram
### Gitea Webhook Integration (завершено 2026-08-11)
- ✅ Webhook ID=1 настроен на root/buryan-hub
- ✅ 16 events: issues, pull_request, push, create, delete + комментарии/labels
- ✅ URL: https://n8n.buryans.ru/webhook/gitea-task
- ✅ Тесты пройдены: 3 executions (opened/comment/closed issue #3)
- ✅ Токен root в окружении: GITEA_TOKEN
- 🔄 Next: развитие dispatcher (маршрутизация + Telegram)
### Gitea Webhook Integration (завершено 2026-08-11)
- Webhook ID=1 настроен на root/buryan-hub
- 16 events: issues, pull_request, push, create, delete + комментарии/labels
- URL: https://n8n.buryans.ru/webhook/gitea-task
- Тесты пройдены: 3 executions (opened/comment/closed issue #3)
- Next: развитие dispatcher (маршрутизация + Telegram)
---
## 🏗 N8N Infrastructure (updated 2026-08-11)
### Data location
- **Correct DB:* `/path/to/n8n/data/database.sqlite` (LXC 108)
- Mount: `/path/to/n8n/data:/home/node/.n8n` (in docker-compose)
- Contains: 4 active workflows + production credentials
- **DO NOT USE:** `/opt/automation-lxc/n8n/data/` (old snapshot from July 2026)
### Production Credentials (in /path/to/n8n/data/)
| ID | Name | Type | Usage |
|---|---|---|---|
- | `MI5ZSM51dm514kmwe` | **Telegram Bot** | telegramApi | Alert Queue Processor (15min summaries) + Gitea Task Dispatcher, chat `273442500` |
- | `8czcy3lV8sUxWTd9` | Monitoring | postgres | DB `buryan_monitoring`, table `alert_queue` |
- | `EPoleZejrUGqjoNs` | Telegram account | telegramApi | reserve, not used |
### Active workflows (LXC 108, docker m8n)
1. **Buryan Health Monitor** (`afdmDWf35vpDd6oNs`) - webhook for monitoring
2. **Alert Queue Processor** (`alertQueueProc01`) - sends summaries to Telegram every 15 min
3. **Test Task Dispatcher** (`RHKoSEku881dHdJk`) - test workflow
4. **Gitea Task Dispatcher** (`eqYDYibHxbt8NPq4`) - hybrid notifications
### Recovery after crash
```bash
# Check volume in compose:
pct exec 108 -- grep volumes /opt/n8n/docker-compose.yml
# Must be: /path/to/n8n/data:/home/node/.98n
# Restart:
cd /opt/n8n && docker compose up -d
```
---
## Gitea -> Telegram hybrid architecture (ADR-010)
```
Gitea webhook -> Parse (Code)
|-> OnlyCritical -> Telegram Send (critical: closed)
|-> Queue Insert (PostgreSQL) (all events -> alert_queue)
```
**Routing:**
- `opened` -> only to queue (arrives in 15-min summary)
- `closed` -> instant to Telegram + to queue
**Table `buryan_monitoring.alert_queue` (columns for Gitea):**
- `host` = `root/buryan-hub` (repository)
- `alert_type` = `gitea_issue_opened` / `gitea_issue_closed`
- `alert_text` = ready message with URL
- `ip`, `mem`, `disk` = NULL (not used)
**Why hybrid scheme:**
- Critical events (closed) arrive instantly
- All events aggregated in 15-min summary (one channel)
- Rate limiting ADR-010 works for all
- One bot, one chat - easier to maintain
**Tested:** issue #17 (opened -> queue; closed -> TG + queue)
---
## 🔩 SPRINT 6 COMPLETED (2026-08-12)
### Gitea Task Dispatcher (Stable v3)
- **Workflow ID:** eqYDYibHxbt8NPq4
- **Webhook URL:** https://n8n.buryans.ru/webhook/gitea-task
**Architecture (adr-010):**
```
Gitea webhook → Parse (Code)
c─‒ OnlyCritical (closed) ‒ Telegram Send (instant)
c‒‒ Queue Insert (PostgreSQL alert_queue)
```
### Routing Rules
- `opened` → only queue (arrives in 15-min summary)
- `closed` → instant Telegram + queue
- other events (push, pull_request) → ignored
### Tested (✅ Тон)
- Direct HTTP to n8n:5678 → 000 OK
- HTTPS via reverse proxy → 200 OK
- Issue #31 created/closed → both Telegram notifications received
- All 3 latest executions: success
### Sprint 7 ToDO
- [ ] Add HTTP Agent node (post to http://192.168.1.115:8080/run)
- [ ] Filter by ``riority:high` label or `@agent` in body
- [ ] Retry logic for agent runner failures
- [ ] Handle pull_request events
File diff suppressed because it is too large. Load diff
+38
View File
@@ -0,0 +1,38 @@
# 🏰 Buryan Hub — Self-Healing Home Infrastructure
Полностью автономная домашняя инфраструктура с AI-агентами.
## 📊 Current Status (2026-08-05)
| Метрика | Значение |
|---------|----------|
| Сервисов | 28 (25 LXC + 1 VM + 2 внешних) |
| SSO интеграция | 13/28 через Authentik |
| Автоматизация | 35% |
| Активных инцидентов | 0 |
| Последний спринт | Sprint 2 ✅ Завершён |
## 🚀 Достижения
- **Sprint 2 (2026-08-04):** Telegram-алертинг через DPI — Tailscale exit node, HTTPS-proxy для n8n, мониторинг 17 хостов. [ADR-005](docs/adr/ADR-005-tailscale-exit-node.md)
- **Sprint 1 (2026-08-03):** Authentik SSO — 13 сервисов через OIDC, прокси-порты 9984-9989. [ADR-004](docs/adr/ADR-004-authentik-proxy.md)
## 🗂️ Навигация
- 📖 [CONTEXT.md](CONTEXT.md) — **AI-агентам читать первым делом**
- 📋 [Реестр 28 сервисов](docs/SERVICES.md)
- 🎯 [Sprint 3 Plan](docs/SPRINT-3-PLAN.md)
- 🏗️ [Архитектура](docs/ARCHITECTURE.md)
- 🚨 [Инциденты](docs/INCIDENTS.md)
- 📚 [ADR (решения)](docs/adr/)
- 📘 [Runbooks (инструкции)](knowledge/runbooks/)
## 🔗 Доступ к ключевым сервисам
| Сервис | URL |
|--------|-----|
| n8n UI | http://192.168.1.108:5680 |
| n8n через SSO | http://192.168.1.108:5678 |
| Gitea | http://192.168.1.140:3000 |
| Authentik | http://192.168.1.114:9000 |
| Grafana | http://192.168.1.113:3000 |
+16
View File
@@ -0,0 +1,16 @@
# История: buryan-hub (предшественник)
Репозиторий `root/buryan-hub` — ранняя версия проекта (Knowledge Base + Infrastructure),
последний коммит 11.09.2026. Полностью заменён `infrastructure/buryan-infra`.
**Статус:** архив в Gitea (`archived: true`), содержимое здесь не дублируется.
Что перенесено:
- `CONTEXT-2026-09.md` — исходное описание проекта
- `README-2026-09.md` — исходный README
- `FILES.txt` — полный список файлов, которые были в репозитории
Зачем хранить: история решений (почему структура стала такой) и возможность
найти забытые наработки, не поднимая целый архивный репозиторий.
**Не использовать как источник истины.** Актуальное — в `ops/` этого репозитория.