Обзор развертывания VictoriaMetrics на сервере¶

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

Для корректной работы приложения требуются следующие условия:

Операционная система с установленным Docker и Docker Compose.
Доступ к портам 80, 443 (для HTTPS) и 8427, 8428, 8427 (внутренние порты сервисов).
Наличие прав суперпользователя для управления директориями в /root/.

FDQN итоговой панели на домене hostkey.in¶

Параметр	Значение
Префикс	`victoriametrics`
Домен	`hostkey.in`
Полный шаблон	`victoriametrics{Server_ID_from_Invapi}.hostkey.in`

Структура файлов и каталогов¶

Все основные данные и конфигурации сосредоточены в следующей директории:

/root/victoria-metrics-data/ — корневая директория приложения.
compose.yml — файл конфигурации Docker Compose.
authconfig.yml — файл конфигурации аутентификации vmauth.
/data/nginx/user_conf.d/ — директория с конфигурациями прокси-сервера Nginx.

Процесс установки приложения¶

Развертывание выполняется путем создания необходимых директорий, генерации файлов конфигурации (compose.yml и authconfig.yml) и запуска контейнеров через Docker Compose. Приложение разворачивается в среде Docker с использованием актуальных образов из реестров разработчиков.

Контейнеры Docker и их запуск¶

Приложение состоит из трех взаимодействующих контейнеров:

Имя сервиса	Образ	Порты	Тома (volumes)	Переменные окружения	Политика перезапуска
`nginx`	`jonasal/nginx-certbot:latest`	`80:80`, `443:443`	`nginx_secrets:/etc/letsencrypt`, `/data/nginx/user_conf.d:/etc/nginx/user_conf.d`	`CERTBOT_EMAIL=hkadm@hostkey.com`	`unless-stopped`
`victoriametrics`	`victoriametrics/victoria-metrics:latest`	`8428:8428`	`/root/victoria-metrics-data:/victoria-metrics-data`, `victoriametrics:/victoria-metrics`	—	`unless-stopped`
`vmauth`	`victoriametrics/vmauth`	`8427:8427`	`/root/victoria-metrics-data:/root/victoria-metrics-data`	Команда запуска с путем к конфигу: `-auth.config=/root/victoria-metrics-data/authconfig.yml`	`unless-stopped`

Базы данных¶

VictoriaMetrics использует локальное хранилище данных, которое монтируется через Docker volume под названием victoriametrics. Данные физически располагаются внутри контейнера и сохраняются в директории /victoria-metrics.

Инструкция по обновлению приложения¶

Обновление выполняется_pull и перезапуск контейнеров. Для обновления необходимо выполнить команды:

cd /root/victoria-metrics-data
docker compose pull
docker compose up -d

Настройки прав¶

Для работы сервисов установлены следующие права на директории:

Директория /root/victoria-metrics-data имеет владельца root, группа root и режим доступа 0644.

Расположение конфигурационных файлов и данных¶

Файл / Ресурс	Путь
Конфигурация Docker Compose	`/root/victoria-metrics-data/compose.yml`
Конфигурация аутентификации	`/root/victoria-metrics-data/authconfig.yml`
Данные VictoriaMetrics (Volume)	`victoriametrics` (Docker Volume)

Доступные порты для подключения¶

80 — HTTP (для получения сертификатов Certbot).
443 — HTTPS (основной доступ через прокси).
8427 — Порт сервиса аутентификации vmauth.
8428 — Порт базы данных VictoriaMetrics.