WaveGrid Docs

Русский

English

Русский

English

Тема

Установка агента ​

Агент ставится на вашей инфраструктуре. Git и доступ в GitLab не нужны.

Основной путь — Docker Hub. Если Docker нельзя — Python wheel со страницы Релизы.

В терминале команда CLI называется wg-flow-agent.

Что потребуется ​

  • Docker Engine + Compose v2 или Python 3.12+
  • Tenant API token (wgf_…) из кабинета — Подключение

Полный стек WaveGrid на хосте агента не нужен. Файлы (docker-compose.yml, config.yaml, wheel) и список версий — Релизы.

Docker (рекомендуется) ​

Создайте каталог, положите туда docker-compose.yml и config.yaml. Скопируйте блоки ниже или скачайте нужную версию на Релизах.

bash
mkdir agent && cd agent

docker-compose.yml с тегом :latest (конкретную версию берите на Релизах):

yaml
services:
  agent:
    image: wavegrid/agent:latest
    container_name: agent
    environment:
      WGFLOW_CONFIG: /etc/wg-flow-agent/config.yaml
      WGFLOW_PLUGINS_DIR: /var/lib/wg-flow-agent/plugins
      WGFLOW_INSTALLED_PLUGINS: /var/lib/wg-flow-agent/installed_plugins.json
      WGFLOW_UI_ENABLED: "false"
      WGFLOW_UI_HOST: "0.0.0.0"
      WGFLOW_UI_PORT: "8765"
    ports:
      - "8765:8765"
    volumes:
      - ./config.yaml:/etc/wg-flow-agent/config.yaml
      - agent_data:/var/lib/wg-flow-agent
    restart: unless-stopped
    read_only: true
    tmpfs:
      - /tmp
    security_opt:
      - no-new-privileges:true
    healthcheck:
      test:
        [
          "CMD-SHELL",
          "wg-flow-agent plugin list >/dev/null && test -f /tmp/wg-flow-agent.last-sync",
        ]
      interval: 60s
      timeout: 10s
      retries: 3
      start_period: 120s

volumes:
  agent_data:

В config.yaml пропишите tenant_id, tenant_token, api_url из кабинета — Подключение.

bash
docker compose up -d
docker compose logs -f agent

Образ wavegrid/agent:latest Docker подтянет с Docker Hub. Контейнер сразу делает sync, затем работает по расписанию (минимум 5 минут на source).

Локальный UI (только в своей сети) — в том же environment поставьте WGFLOW_UI_ENABLED: "true" и перезапустите: docker compose up -d. Браузер: http://127.0.0.1:8765. Не публикуйте :8765 наружу — UI без пароля.

Плагины:

bash
docker compose exec agent wg-flow-agent plugin marketplace list
docker compose exec agent wg-flow-agent plugin install proxmox

pip (без Docker) ​

Python 3.12+. Скачайте wheel нужной версии на Релизах и поставьте в venv:

bash
python3.12 -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install ./wg_flow_agent-0.1.0-py3-none-any.whl

Скопируйте config.yaml с той же страницы, заполните поля, затем:

bash
export WGFLOW_CONFIG="$PWD/config.yaml"
wg-flow-agent run            # планировщик
wg-flow-agent run --ui       # + UI на 127.0.0.1:8765
wg-flow-agent sync           # один прогон без демона

Что дальше ​

  1. Подключить workspace — токен и api_url.
  2. Установить плагины.
  3. В кабинете: Инвентарь → Агенты — статус online.