Перейти к основному содержимому

Установка через Docker

Docker — самый быстрый способ запустить Agent на одном хосте: одна команда, автообновление внутри образа, состояние в именованном томе. Для production на одном VPS используйте вариант с docker-compose.

Предварительные требования​

  • Docker Engine 20.10+ (для compose — Docker Compose v2).
  • Исходящий HTTPS:443 до api.flaree.ru.
  • Токен агента из дашборда (показывается один раз).

Установка​

docker run -d \
  --name flaree-agent \
  --restart unless-stopped \
  -e FLAREE_AGENT_TOKEN=<token> \
  -e FLAREE_AGENT_SERVER=https://api.flaree.ru \
  -v flaree-agent-state:/var/lib/flaree-agent \
  -p 127.0.0.1:9090:9090 \
  registry.flaree.ru/agent:1
  • Образ distroless, процесс не под root, где применимо.
  • Том flaree-agent-state хранит persistent buffer и файл состояния между перезапусками.
  • -p 127.0.0.1:9090:9090 открывает метрики Prometheus только на loopback хоста.
  • Для сбора метрик Docker-контейнеров смонтируйте -v /var/run/docker.sock:/var/run/docker.sock:ro.
warning

Привязывайте порт 9090 к 0.0.0.0 только если Prometheus работает на другой машине — и закройте порт файрволом.

Вариант docker-compose с готовым файлом — в быстром старте.

Управление​

docker restart flaree-agent
docker stop flaree-agent
docker logs -f flaree-agent

Проверка​

docker logs flaree-agent | head -20
curl -s http://127.0.0.1:9090/metrics | grep flaree_agent_checks_total

Ожидаемый вывод curl:

flaree_agent_checks_total{type="http",ok="true"} 4

В дашборде агент появится со статусом Online в течение ~30 секунд.

Обновление и удаление​

Агент обновляется автоматически: при выходе новой версии процесс завершается с кодом 0, и --restart unless-stopped перезапускает контейнер. Обновить образ вручную:

docker pull registry.flaree.ru/agent:1
docker rm -f flaree-agent
# затем повторите docker run из раздела «Установка»

Удаление:

docker rm -f flaree-agent
docker volume rm flaree-agent-state

Дальше​