services v1.1.1 [extra]


Управление службами: Windows/Linux/Docker/локальные юниты, каталог, действия.

README

# services

Управление службами на всех хостах из одного места: что есть, что запущено, старт/стоп/рестарт.

Тип: Модуль. Категория: `extra`. Зависимостей нет.

## Что это

Службы живут на разных машинах и разных init-системах — Windows (`sc`), Linux (`systemctl` по SSH), Docker-контейнеры, локальные юниты. Спрашивать хочется одинаково, поэтому ядро держит реестр, а провайдеры отвечают каждый за свой тип:

- `services_windows` — службы Windows (`sc query/start/stop`, автозапуск через `sc config`);
- `services_linux` — юниты удалённых Linux-машин (`systemctl` по SSH, действия через sudo);
- `services_docker` — контейнеры (`docker ps/start/stop/restart`, включая healthy);
- `services_local` — юниты своей же машины (`systemctl` напрямую, без SSH).

Провайдеры видят только свой вайтлист: остальные службы хоста боту недоступны. Каждое действие пишется в аудит, статусы собираются best-effort (упавший хост не роняет весь список).

В кабинете — сводная таблица служб всех хостов со статусами, в Telegram — кнопка сервисов в меню (группировка по хостам).

## Каталог

Право `service_catalog` (старт/стоп/рестарт не даёт): все доступные службы хостов — из кеша `data/services/discovery_cache.json`, обновление только вручную по кнопке (по хосту или всё сразу). Чекбокс «вкл» — служба в общем списке, выкл — скрыта.

Списки хранятся в `data/services/hosts.json` (вне git, один файл на все типы: `type/alias/endpoint/services/...`), сохранение из кабинета — без рестарта (`hosts_set` + `reload` провайдеров). Нет `hosts.json` — провайдеры работают как раньше: один инстанс из своего `.env`.

Подключения — одна таблица перед каталогом: хост, тип, селект точки → привязка, кеш, действия (🔄 опрос, 💾 сохранить, 🗑 удалить точку). Новые точки создаются там же: windows/linux/docker → ssh-точка, local — новый хост без точки. SSH-пароль/ключ живёт в точке (`data/env/outbound.env`), здесь — только вайтлисты и sudo-пароли для удалённых команд. С ключом (`address.key`) пароль можно не вводить.

## Устройство (для разработчиков)

Провайдеры встроены в ядро: движки — `services/backends/` (`docker.py/linux.py/local.py/windows.py` + базовый `ProviderModule`), конфиги — `backends/<type>.schema.json`, примеры — `backends/<type>.env.example`. Значения читаются из `data/env/services_<type>.env` (имена сохранены). API-имена провайдеров (`services_docker.*` и т.д.) сохранены ради совместимости кабинета и внешних вызовов. Контракт провайдера — пять API-методов (`services_info/service_status/service_action/discover/reload`), ядро вызывает их по имени.

Отдельных модулей `services_*` больше нет (релиз 1.0.0): при первом старте ядро само сносит их каталоги с бекапом в `data/backups/modules-legacy/` и помечает записи в modstate как missing — обновление приезжает обычной заменой файлов.

## Возможности

- `register {provider: str}` → регистрация провайдера (зовут services_* в своём setup)
- `hosts_for {svc_type}` → инстансы типа из hosts.json (валидированные; [] — fallback на .env)
- `hosts_all {}` → весь hosts.json — для кабинета
- `hosts_set {entries, actor = ""}` → перезаписать hosts.json (атомарно) + reload провайдеров
- `discover {host = "", actor = ""}` → опросить хосты, перезаписать кеш каталога
- `catalog {query, type_, host, checked, page, per_page}` → каталог из кеша: фильтры + пагинация
- `endpoint_add {name, svc_type, address, secret, via?, note?}` → создать точку outbound (ssh) с пробой подключения
- `endpoint_delete {name}` → удалить точку; ссылки инстансов сбрасываются (reload)
- `host_add {alias, svc_type, endpoint?, sudo_pass?}` → новый хост в hosts.json (local — без точки, services пустой)
- `service_remove {host, name, actor = ""}` → убрать службу из вайтлиста инстанса (работает и для уже удалённых на хосте: снимает и `autostart`, чистит имя из кеша discovery)
- `host_delete {alias, actor = ""}` → удалить хост-инстанс целиком (бекап `hosts.json.bak-<ts>`, кеш хоста; точку outbound и потребителя не трогает)
- `providers {}` → провайдеры и их инстансы
- `list {}` → плоский список служб (имена + host/type)
- `status {}` → статусы всех служб (best-effort)
- `action {host: str, name: str, act: start|stop|restart}` → действие с маршрутизацией по host

## Права

- `service_manage` — управление службами (таблица статусов, старт/стоп/рестарт)
- `service_catalog` — каталог (hosts/точки/кеш), старт/стоп/рестарт не даёт

## Telegram

- Кнопка сервисов в меню (колбэки `service_*`, группировка по хостам); команд нет

## Web

- `GET /api/admin/services` — статусы служб всех хостов
- `POST /api/admin/service` — действие (`start|stop|restart`)
- `GET /api/admin/services_catalog` — каталог из кеша
- `POST /api/admin/services_discover` — обновить кеш (в фоне)
- `GET/POST /api/admin/services_hosts` — инстансы и чекбоксы
- `POST /api/admin/services_endpoint` — создать точку outbound
- `POST /api/admin/services_endpoint_delete` — удалить точку
- `POST /api/admin/services_host_add` — добавить хост
- `POST /api/admin/services_service_delete` — убрать службу из вайтлиста (`{host, name}`, `service_catalog`)
- `POST /api/admin/services_host_delete` — удалить хост-инстанс (`{alias}`, `service_catalog`)

## Конфигурация (`config.schema.json`)

- обязательных и опциональных нет (настройки провайдеров — в их `.env`, см. ниже)

Манифест

{
  "name": "services",
  "version": "1.1.1",
  "category": "extra",
  "description": "Управление службами: Windows/Linux/Docker/локальные юниты, каталог, действия.",
  "requires": [],
  "rights": [],
  "api_methods": [],
  "web_routes": [],
  "commit": "1d4718523a0d2264efce8c4e586df9d5a5381f76",
  "updated": "2026-10-19 13:55:47 +0300",
  "history": [
    {
      "version": "0.1.0",
      "date": "2026-09-08 17:27:33 +0300",
      "commit": "28de83498e1031bd4dbb88a47a422a2ecb54ec92"
    },
    {
      "version": "0.2.0",
      "date": "2026-09-10 15:02:22 +0300",
      "commit": "44b5beb4213ed7a72c4a9b436ee69a80f1d229d7"
    },
    {
      "version": "0.3.0",
      "date": "2026-09-11 10:17:26 +0300",
      "commit": "c86c8b6fe14b77d3a6c763be84f1c247a2caaa2a"
    },
    {
      "version": "0.3.1",
      "date": "2026-09-12 23:22:16 +0300",
      "commit": "db9c47f797b3a96a29b646f86025a87d1eb4d645"
    },
    {
      "version": "0.4.0",
      "date": "2026-09-18 09:31:34 +0300",
      "commit": "a73441e889e15108d49129a365df8986fe429862"
    },
    {
      "version": "0.5.0",
      "date": "2026-09-19 15:31:32 +0300",
      "commit": "c8849e697d4fed0647b3f00649be7404e1d435c0"
    },
    {
      "version": "0.6.0",
      "date": "2026-09-19 15:36:04 +0300",
      "commit": "1423089dcbc187307704a350d4042f6a1de5a981"
    },
    {
      "version": "0.7.0",
      "date": "2026-09-19 15:49:16 +0300",
      "commit": "a5bd1c27e7e636ddda98066b16e0d81811579ced"
    },
    {
      "version": "0.8.0",
      "date": "2026-09-19 16:07:18 +0300",
      "commit": "5d2de85ab525be1bdcacdad2180bd6e43affc064"
    },
    {
      "version": "0.9.0",
      "date": "2026-10-07 09:41:51 +0300",
      "commit": "dacc5dce1c2d08e2a8708251fb45867ff6d0cfc8"
    },
    {
      "version": "1.0.0",
      "date": "2026-10-07 10:00:57 +0300",
      "commit": "8c15e4d68659850405ecb08860eebe6d3a4d2f45"
    },
    {
      "version": "1.1.0",
      "date": "2026-10-18 22:48:49 +0300",
      "commit": "b8397cac488aec845ea865d4d22374f0a6afebdd"
    },
    {
      "version": "1.1.1",
      "date": "2026-10-19 13:55:47 +0300",
      "commit": "1d4718523a0d2264efce8c4e586df9d5a5381f76"
    }
  ],
  "integrity": "sha256:26ae156b71c9b18085aa69a8d768c5b8d083475b7593ec68c73006f6a2f69c18",
  "files": "[23 файлов — см. вкладки ниже]",
  "note": "",
  "wdesc": "",
  "wbody": "",
  "_extra": {
    "api": "",
    "events_emitted": "[]",
    "events_subscribed": "[]",
    "audit_allow": "",
    "shared_routes": "",
    "config_schema": "config.schema.json",
    "env_example": ".env.example"
  }
}

Файлы и исходники

Дерево файлов

  • · корень
    • 7.5 КБ
    • 0.0 КБ
    • 7.1 КБ
    • 42.6 КБ
    • 6.6 КБ
    • 0.8 КБ
    • 13.4 КБ
  • backends/
    • 0.6 КБ
    • 0.7 КБ
    • 3.2 КБ
    • 0.1 КБ
    • 0.7 КБ
    • 6.0 КБ
    • 0.1 КБ
    • 0.4 КБ
    • 4.8 КБ
    • 0.1 КБ
    • 11.6 КБ
    • 0.7 КБ
    • 9.5 КБ
    • 0.2 КБ
  • web/
    • 5.3 КБ
    • 17.0 КБ

Предпросмотр

Выберите файл в дереве выше — код откроется здесь.

История версий

versiondatecommit
1.1.12026-10-191d4718523a0d
1.1.02026-10-18b8397cac488a
1.0.02026-10-078c15e4d68659
0.9.02026-10-07dacc5dce1c2d
0.8.02026-09-195d2de85ab525
0.7.02026-09-19a5bd1c27e7e6
0.6.02026-09-191423089dcbc1
0.5.02026-09-19c8849e697d4f
0.4.02026-09-18a73441e889e1
0.3.12026-09-12db9c47f797b3
0.3.02026-09-11c86c8b6fe14b
0.2.02026-09-1044b5beb4213e
0.1.02026-09-0828de83498e10