Skip to content

Плагины ​

В образе агента нет провайдеров. Каталог — тот же, что во вкладке Marketplace локального UI и в кабинете WaveGrid: агент скачивает wheel по tenant token, затем в YAML появляется секция.

Сейчас ставятся Proxmox, Prometheus, SpaceWeb, Cloudflare, Hetzner Cloud, REG.RU, REG.RU Cloud, VK Cloud, Selectel, Miran, Yandex Cloud и Cloud.ru. AWS описан в каталоге (wheel — по мере публикации). Остальные карточки — «скоро».

Доступны ​

ПлагинКатегорияЧто собирает
Proxmox VEВиртуализацияНоды, VM, LXC, хранилища
PrometheusМониторингScrape-targets как серверы и домены
SpaceWebОблако / хостингVPS, домены, DNS
CloudflareDNSЗоны, DNS, R2/KV, D1/Hyperdrive, балансировщики
Hetzner CloudОблакоСерверы, volumes, LB, IP, сети, firewall, сертификаты
REG.RUОблако / регистраторДомены, DNS, хостинг, VPS
REG.RU CloudОблакоReglet’ы cloud.reg.ru, доп. IP, приватные сети
VK CloudОблакоСерверы, диски, сети, floating IP, группы безопасности, балансировщики
SelectelОблакоИнстансы, выделенные серверы, диски, сети, floating IP, группы безопасности, балансировщики
MiranОблако / дата-центрВыделенные серверы, VDS, домены, хостинг, колокация, IP
Yandex CloudОблакоВиртуальные машины, диски, сети, публичные IP, группы безопасности, балансировщики
Cloud.ruОблакоВиртуальные машины, диски, подсети, VPC, публичные IP, группы безопасности, балансировщики Evolution
Amazon Web ServicesОблакоCompute, БД, балансировщики, хранилища

Поля конкретного провайдера рисует schema плагина в локальном UI после Install.

Скоро ​

Wheel ещё не опубликован. В Marketplace кнопка Install неактивна; страница описывает, что появится.

ПлагинКатегорияПлан сбора
DigitalOceanОблакоDroplets, volumes, LB
Google CloudОблакоCompute, SQL, балансировщики
Microsoft AzureОблакоVM, диски, LB
KubernetesОркестрацияНоды и нагрузки кластера

Установка ​

После того как агент подключён и видит API:

bash
# Docker
docker compose exec agent wg-flow-agent plugin marketplace list
docker compose exec agent wg-flow-agent plugin install proxmox
docker compose exec agent wg-flow-agent plugin install prometheus
docker compose exec agent wg-flow-agent plugin install sweb
docker compose exec agent wg-flow-agent plugin install cloudflare
docker compose exec agent wg-flow-agent plugin install hetzner
docker compose exec agent wg-flow-agent plugin install regru
docker compose exec agent wg-flow-agent plugin install regcloud
docker compose exec agent wg-flow-agent plugin install vkcloud
docker compose exec agent wg-flow-agent plugin install selectel
docker compose exec agent wg-flow-agent plugin install miran
docker compose exec agent wg-flow-agent plugin install yandex
docker compose exec agent wg-flow-agent plugin install cloudru
docker compose exec agent wg-flow-agent plugin list

# pip / хост
wg-flow-agent plugin marketplace list
wg-flow-agent plugin install proxmox

То же из локального UI: вкладка Marketplace → Install.

Wheel кладётся в ~/.wg-flow-agent/plugins (в контейнере — /var/lib/wg-flow-agent/plugins, том agent_data).

Обновить: wg-flow-agent plugin update proxmox. Снять: plugin uninstall.

Включить в YAML ​

После install добавьте секцию plugins.<name>. Поля конкретного провайдера — на его странице. Минимальный каркас:

yaml
plugins:
  proxmox:
    enabled: true
    sources:
      - id: dc1
        provider_account: "proxmox-dc1"
        sync_interval_seconds: 300
        # дальше — поля API, см. страницу плагина

Несколько sources — несколько аккаунтов одного провайдера. Ресурсы в инвентаре различаются по provider_account.

Форму без правки YAML даёт локальный UI после install (схема с маркетплейса).

Расписание ​

У каждого source свой sync_interval_seconds (минимум 300). Если несколько source «созрели» в один тик — агент склеивает их в один POST /sync/. Если никто не due, раз в интервал планировщика уходит пустой heartbeat, чтобы агент не стал offline.