Files
buryan-infra/ops/OWNER-INSTRUCTIONS.md
T

223 lines
12 KiB
Markdown
Raw 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.
# ИНСТРУКЦИЯ ВЛАДЕЛЬЦУ — что нужно сделать вам
Дата: 05.11.2026 · Всё, что можно было сделать без вас — сделано и проверено.
Здесь только то, что требует **ваших рук, ваших решений или ваших доступов**.
Порядок — по важности. Время — реальная оценка.
---
# 🔴 ЧАСТЬ 1. КРИТИЧНО (сделать в ближайшие дни)
## 1.1. BIOS: включить автозапуск после отключения света
**Почему:** 05.11 свет отключился — сервер пришлось включать руками. Всё, что я автоматизировал, включается только после того, как хост загрузился. Пока BIOS не настроен, при каждом отключении сервер будет мёртв до вашего прихода.
**Когда:** после любых работ с сервером, когда будет доступ к BIOS (нужен монитор и клавиатура).
**Как:**
1. Перезагрузить сервер, при старте зайти в BIOS (обычно `Del` или `F2`).
2. Найти раздел — называется по-разному:
- `Advanced` → `Power Management Setup`
- или `Chipset` → `Power Management`
- или `APM Configuration`
3. Найти параметр:
- `AC Power Loss` / `Restore on AC Power Loss`
- или `After Power Failure` / `State After G3`
- или `PWRON After PWR-Fail`
4. Выставить **`Power On`** (варианты: `Power Off`, `Last State`, `Power On` — нужен последний).
5. `F10` → сохранить → перезагрузка.
**Проверка (обязательно):**
1. Выключить сервер.
2. Выдернуть кабель питания на 30 секунд.
3. Вставить обратно.
4. **Сервер должен включиться сам**, без кнопки.
**Что будет после включения:** через ~1–2 минуты всё поднимется автоматически (я поставил два юнита: `pve-ensure-rw` и `pve-start-all`). Проверить можно командой:
```bash
ssh root@192.168.1.10 "pct list | grep -c running; systemctl --failed --no-legend | wc -l"
```
Ожидается: `32` и `6 и меньше`.
**Отметить:** ☐ сделано
---
## 1.2. Решить судьбу `pve-ssl.key`
Дайджест сам нашёл в журнале:
```
/etc/pve/local/pve-ssl.key: failed to load local private key
```
Это ключ веб-интерфейса Proxmox. Если он битый — панель `https://192.168.1.10:8006` может отвалиться.
**Что сделать:** зайти в панель Proxmox по адресу `https://192.168.1.10:8006` и сказать мне, открывается ли. Я перевыпущу ключ (это безопасно, сертификат самоподписанный).
**Отметить:** ☐ проверил(а), панель открывается / не открывается
---
# 🟡 ЧАСТЬ 2. РЕШЕНИЯ (нужны ваши ответы, 10 минут)
Ответьте коротко — дальше сделаю я.
## 2.1. Контент на русском (Фаза D — блокирует весь медиа-сценарий)
Сейчас качается только с RuTor, там 0–6 сидов: **0 завершённых загрузок**.
Выберите один вариант:
| Вариант | Что нужно от вас | Что будет |
|---|---|---|
| **A. Debrid** (рекомендую) | Купить подписку: Real-Debrid (~€4/мес), AllDebrid, или TorBox | 10–20 источников, качает из кэша, сиды не нужны, скорость максимальная |
| **B. RuTracker** | Зарегистрировать аккаунт, дать логин/пароль | Прямой доступ к самому большому русскому трекеру |
| **C. Telegram-каналы** | Назвать 2–3 канала с кино | Userbot ищет и складывает в библиотеку |
**Мой выбор: A** — дешевле вашего времени, работает автоматически, легально как сервис-кэш.
**Ответ:** ☐ A ☐ B ☐ C ☐ свой вариант: ______
---
## 2.2. Что делать с `netbox` (907 МиБ RAM)
Крупнейший потребитель памяти, CPU 0 %. Вопрос один: **вы им пользуетесь?**
**Ответ:** ☐ да, нужен ☐ нет, можно отключить
---
## 2.3. Дубли сервисов — какие осознанные?
| Сервис | Где | Ваш ответ |
|---|---|---|
| `nginx` | CT106, CT110 | ☐ оба нужны ☐ один лишний |
| `mariadb` | CT109, CT110 | ☐ оба нужны ☐ один лишний |
| `syncthing` | CT105, CT139 | ☐ оба нужны ☐ один лишний |
| `mosquitto` | CT106, CT107 | ☐ оба нужны ☐ один лишний |
| `server` (без тега) | CT109, CT114 | ☐ знаю что это ☐ не знаю |
*(redis ×4 и postgres ×2 — это нормально, изоляция приложений, трогать не нужно)*
---
## 2.4. `paperless` — вернуть или убрать остатки?
Приложение не запущено, но остался `oauth2-proxy-paperless`.
**Ответ:** ☐ вернуть сервис ☐ убрать остатки
---
## 2.5. 22 сервиса без единого входа
Список: `ops/evolution/report-2026-11-05.md`, раздел 3.
**Ответ:** ☐ показать список, отмечу нужные ☐ не важно (всё локальное)
---
## 2.6. Память сервера
Хост постоянно на 10 из 15 ГБ.
**Ответ:** ☐ докупить RAM ☐ ограничить лимиты контейнерам ☐ оставить как есть
---
## 2.7. Права агента (пункт 5 контура — «агент как субъект»)
Сейчас агент умеет только предлагать (`dry_run: true`). Чтобы он реально перезапускал упавшие сервисы, нужно ваше разрешение.
**Что предлагаю разрешить автоматически (L2 — безопасные действия):**
| Действие | Риск |
|---|---|
| Перезапуск упавшего юнита | низкий |
| Запуск остановленного контейнера (не из maintenance) | низкий |
| Ротация логов | низкий |
| Возобновление qBittorrent | низкий |
| Перезапуск экспортёра/прокси | низкий |
**Что оставить только с подтверждением (L4):** удаление контейнеров, изменение compose, всё что касается данных и SSO.
**Ответ:** ☐ разрешаю L2 для перечисленного ☐ пока только предлагать
---
# 🟢 ЧАСТЬ 3. ЧТО УЖЕ СДЕЛАНО САМО (вам делать не нужно)
| Что | Проверка |
|---|---|
| Автовосстановление после перезагрузки | `systemctl is-enabled pve-start-all pve-ensure-rw` → `enabled` |
| `onboot: 1` у всех CT кроме CT160 | `pct list` после перезагрузки поднимается само |
| Гигиена (18 проверок, отчёт 07:20) | сводка в Matrix каждый день |
| Бэкапы (6 заданий, свежесть) | проверяется ежедневно |
| RAG-память: 741+ документ | `python3 ops/scripts/rag_query.py "вопрос"` |
| Лёджер: RAM, диск, возраст образов | `ops/topology/ledger.md` |
| Агент развития (tech-radar, 08:10) | `ops/evolution/report-*.md` |
| Статистика доверия (08:00) | `ops/trust/report-*.md` |
| Недельная сводка (08:05) | `ops/weekly/WEEKLY-*.md` |
| AI-дайджест с уверенностью (ежечасно) | Matrix |
| Мультиагентная схема (5 специалистов) | `ops/agents/SUPERVISOR.md` |
| Валидатор правил агента | `python3 ops/scripts/validate_hermes.py` |
| Секретарь отвечает по документации | спросите в Matrix «почему падал chronyd» |
**Заданий Hermes: 18.**
---
# 📋 ЧАСТЬ 4. ЧЕК-ЛИСТ (распечатать / держать под рукой)
```
[ ] BIOS: AC Power Loss = Power On (+ проверка выдёргиванием кабеля)
[ ] Проверить https://192.168.1.10:8006 (панель Proxmox)
[ ] Выбрать контент: A (debrid) / B (RuTracker) / C (Telegram)
[ ] netbox: нужен или нет
[ ] Дубли: nginx / mariadb / syncthing / mosquitto / server
[ ] paperless: вернуть или убрать
[ ] SSO: прислать список нужных сервисов
[ ] RAM: докупить или ограничить
[ ] Разрешить L2-автономию для безопасных действий
```
---
# 🆘 Если что-то сломалось
**Сервер не отвечает:** включить вручную (после настройки BIOS — не понадобится), подождать 2 минуты, всё поднимется само.
**Проверить состояние одной командой:**
```bash
ssh root@192.168.1.10 "uptime; free -h | head -2; pct list | grep -c running; systemctl --failed --no-legend"
```
**Спросить Секретаря в Matrix:** «что с сервером?» — он посмотрит через свои инструменты.
**Полный отчёт по порядку:** `/root/buryan-infra/ops/weekly/WEEKLY-*.md`
---
# 📌 ДОПОЛНЕНИЕ от 05.11 (закрыто без вас)
Пока вы отсутствовали, закрыто самостоятельно:
| Пункт контура | Что сделано | Проверка |
|---|---|---|
| **2. Гибридная память** | RAG теперь включает эпизодическую память: журнал действий + отчёты гигиены/развития/доверия | `752 документа, 3090 чанков`; источник `ops/rag/episodes-actions.txt` |
| **4. Живое исследование** | `research_alternatives.py` — факты из GitHub API со ссылками | `ops/evolution/research-2026-11-05.md`: 10 сервисов, 20 запросов |
| **7. GitOps** | валидатор правил подключён в CI Gitea (5 шагов) | `OK: ошибок нет` |
| — | задание живое исследование ежедневно 08:15 | заданий Hermes: **19** |
**По DNS-ошибкам Секретаря:** проверено — это были артефакты загрузки (до поднятия сети). Сейчас: ошибок за 5 минут — 0.
**По `pve-ssl.key`:** сертификат **в порядке** (CN=pve.example, действителен до 05.03.2027). Ошибка в журнале — от момента загрузки до remount rw. Действий не требуется.
## Осталось только то, что требует вас
1. **BIOS: AC Power Loss → Power On** (Часть 1.1)
2. **Источник контента** — debrid / RuTracker / Telegram (Часть 2.1)
3. **Разрешение на L2-автономию** (Часть 2.7)
4. Ответы на 5 вопросов о дублях/netbox/paperless/SSO/RAM