feat(runner): tgit-runner — сервисы в песочнице на хосте, деплой после push (#13)
CI / ruff · mypy · pytest (pull_request) Successful in 4m3s
CI / ruff · mypy · pytest (pull_request) Successful in 4m3s
- infra/runner/tgit-runner: deploy/restart/remove/list по SSH forced command; аргументы не исполняются и не глобятся; архив — только файлы и папки, без «..», ≤ 20 МБ, есть main.py; health_url — только localhost - песочница: uid 10001, read-only, tmpfs noexec, cap-drop ALL, no-new-privileges, 128 МБ без swap, 0.25 CPU, 64 PID, --network none (сеть — только по egress-allow админа), лимит 10 сервисов, 2 образа - новая версия стартует рядом (-next) и заменяет старую, только став healthy; иначе удаляется, старая работает, exit 3 - бот: после push git archive изменённых services/<name>/ → runner; автору — «🚀 работает» или «⛔ не развёрнут» с логом, команде — алерт ⛔; удалённая папка → remove; «♻️ Перезапустить» в «Статусе» для админа (S-5) - examples/escape_attempts: все попытки выбраться — BLOCKED на живом Docker - install.sh, authorized_keys.example; CD бота обновляет runner на хосте Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
@@ -41,6 +41,7 @@
|
||||
| **📜 Логи** | хвост 50/200 строк или 5 мин/1 ч/24 ч; свой grep (`-i -v -E -c -C N`), выполняется в Python, не в shell; длинный ответ — файлом; журнал поисков | L-1…L-6 |
|
||||
| **🤖 Агент** | вопрос словами → фильтр → LLM-страж → LLM строит только `LogQuery` → валидация → grep; показывает построенную команду и строки; атака — отказ и 🛡 админам; 30 вопросов в сутки | L-10…L-17 |
|
||||
| **🚨 Алерты** | 💥 краш, 🧠 OOM, 🔁 цикл рестартов, 🩺 unhealthy, 🔥 перегрузка, 💾 мало места, 🔌 Docker недоступен, 🛡 атака; всем участникам, с хвостом лога и кнопками; повторы — счётчик, «✅ восстановлено» ответом; список за 7 дней | AL-1…AL-6 |
|
||||
| **🚀 Деплой сервисов** | после push бот отправляет изменённые `services/<name>/` в `tgit-runner` на хосте: сборка образа, запуск в песочнице (uid 10001, read-only, без capabilities и сети, 128 МБ / 0.25 CPU / 64 процесса); старая версия заменяется только здоровой новой, иначе ⛔ с логом; «♻️ Перезапустить» в «Статусе» для админа | #13, S-5 |
|
||||
| **CI/CD бота** | Gitea Actions: ruff, mypy strict, миграции up/down/up на PostgreSQL, pytest с порогом покрытия 80 %; автодеплой `dev` на сервер с проверкой health | ADR-015 |
|
||||
|
||||
Качество: 296 тестов, покрытие 92 %, `mypy --strict`, `ruff`. Telegram в тестах — фейковая сессия aiogram,
|
||||
@@ -148,6 +149,7 @@ make cov # pytest с покрытием (порог 80 %)
|
||||
| git (SSH) | чтение и коммиты в репозиторий загрузок | `git` подпроцессом со своим ключом, без shell |
|
||||
| Docker Engine API | контейнеры, stats, логи | только GET через `docker-socket-proxy` |
|
||||
| OpenAI-совместимый `/chat/completions` | страж и планировщик агента | httpx, `response_format: json_schema` |
|
||||
| SSH → `tgit-runner` | деплой и перезапуск сервисов на хосте | `ssh` подпроцессом, ключ с forced command |
|
||||
| SourceCraft REST API | статус прогонов CI репозитория загрузок | httpx, клиент готов, в UI — #11 |
|
||||
|
||||
## 5. Ограничения и особенности
|
||||
@@ -176,8 +178,8 @@ make cov # pytest с покрытием (порог 80 %)
|
||||
| повтор алерта | в течение 10 мин — счётчик, а не новое сообщение |
|
||||
|
||||
**Что пока не сделано** (открытые задачи):
|
||||
- запуск сервисов из репозитория загрузок в песочнице (`--cap-drop ALL`, read-only FS, лимиты) и перезапуск из бота —
|
||||
`tgit-runner`, #13. Сейчас сервисы поднимаются Compose, как в `examples/`;
|
||||
- проверки CI репозитория загрузок (ruff, bandit, тесты) перед деплоем: сейчас бот разворачивает сервис сразу после
|
||||
push, проверив только синтаксис; ожидание зелёного CI появится вместе с #11;
|
||||
- уведомления о прогонах CI/CD репозитория загрузок и алерты 📦/⛔ — #11, ждут возврата к SourceCraft;
|
||||
- «🔕 Тишина на час» для алертов (P2);
|
||||
- prod-окружение: нужен отдельный бот, деплой `main` пропускается, пока его нет.
|
||||
@@ -193,12 +195,13 @@ app/
|
||||
logs/ grep-движок и журнал
|
||||
agent/ фильтр, страж, планировщик, схема LogQuery
|
||||
alerts/ детекторы, сервис алертов, рассылка, монитор
|
||||
runner/ SSH-клиент tgit-runner и деплой после push
|
||||
llm/ провайдеры: OpenAI-совместимый, mock
|
||||
sourcecraft/ клиент API прогонов
|
||||
db/ модели, миграции Alembic, очистка
|
||||
config/ тексты интерфейса, пороги проверок и алертов, правила и промпты агента
|
||||
tests/ pytest; фейки Telegram, Docker и LLM
|
||||
examples/ демо-сервисы и сценарии
|
||||
infra/ деплой на сервер, шаблон репозитория загрузок
|
||||
infra/ деплой бота, tgit-runner (песочница сервисов), шаблон репозитория загрузок
|
||||
docs/ ТЗ, архитектура, ADR, процесс
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user