[OPS] buryan-hub объединён: история перенесена в ops/history/legacy-hub, старый репозиторий архивирован
lint / hygiene (push) Failing after 9s
lint / hygiene (push) Failing after 9s
This commit is contained in:
1 parent
1b0d850387
commit
443e07f541
4 files changed
+1774
No files matched your search
@@ -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
@@ -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 |
|
||||
@@ -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/` этого репозитория.
|
||||
Reference in new issue
Block a user