Локальный UI

Встроенный редактор YAML на порту 8765. Это не кабинет WaveGrid: он крутится рядом с агентом, без логина, и пишет в тот же файл, что и CLI.

Четыре раздела в шапке: Configuration, Plugins, Marketplace, Operations.

Запуск

Docker — в environment сервиса agent в docker-compose.yml:

WGFLOW_UI_ENABLED: "true"

Затем docker compose up -d.

CLI:

wg-flow-agent ui              # 127.0.0.1:8765
wg-flow-agent run --ui

Откройте http://127.0.0.1:8765. Не публикуйте порт наружу.

После Save планировщик подхватывает YAML сам (следит за mtime). Контейнер пересобирать не нужно.

---

Configuration

Подключение к платформе, имя агента и интервал по умолчанию.

Configuration

Блок	Зачем
Connection	api_url, tenant_id, tenant_token. Баннер Connected / ошибка + Test now (пробный POST на /sync/ с пустым списком ресурсов).
Agent identity	agent.name, agent.host. Agent ID (agent.id) выдаётся при первом запуске и не редактируется — по нему платформа узнаёт тот же экземпляр.
Scheduler	scheduler.sync_interval_seconds, минимум 300. Это default и heartbeat, если ни один source не due. Интервал конкретной площадки — на карточке source.
Save configuration	Пишет YAML. Пустой tenant token не затирает сохранённый.

Токен в форме маскируется (wgf_…). Значение один раз берёте в кабинете: Подключение.

---

Plugins

Список уже установленных интеграций. Клик по карточке — настройки плагина.

Plugins

На карточке: версия wheel, сколько source активны, ready / ошибка, ссылка Configure. Browse marketplace — если нужен ещё провайдер.

Настройки плагина

Форма строится из schema плагина (не хардкод в UI). Несколько подключений — вкладки source слева, Add connection.

Identity, расписание, URL

Аутентификация и TLS

Типичные поля source:

• Source ID — ключ в YAML (plugins.proxmox.sources[].id)
• Provider account — так площадка называется в инвентаре
• Sync interval — минимум 300 с
• Поля API (URL, токен, TLS…) — свои у каждого плагина, см. каталог

Внизу липкая панель Cancel / Save settings.

---

Marketplace

Каталог с платформы (тот же tenant token, что для sync). Поиск по имени, провайдеру, категории.

Marketplace

• Wheel ещё не стоит — Install (скачивает пакет в том плагинов).
• Уже стоит — Configure (то же, что карточка на Plugins).
• Coming soon — пакет ещё не опубликован, кнопка установки неактивна.

Подробности провайдера — в каталоге плагинов.

---

Operations

Разовые действия без правки YAML. Результат — в блоке Output.

Operations

Действие	Что делает
Check status	Валидация конфига + health включённых плагинов (wg-flow-agent status).
Run dry run	Collect → JSON в Output, без POST в SaaS.
Sync now	Collect всех enabled source → POST /sync/. Интервалы не фильтруют one-shot.

Планировщик при этом продолжает работать в фоне.

---

Чего нельзя

• Выставлять :8765 в интернет без своей авторизации
• Считать UI кабинетом WaveGrid: инвентарь, затраты и алерты — только в SaaS