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

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

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

• Права root или доступ sudo для выполнения команд Docker.

• Установленные и работающие на хост-системе Docker и Docker Compose.

• Сетевой доступ к домену hostkey.in для разрешения DNS.

• Порты 80, 443, 8427 и 8428 должны быть доступны и не блокироваться внешними межсетевыми экранами (firewalls).

FQDN конечной панели¶

Приложение доступно по следующему полностью квалифицированному доменному имени (FQDN):

• victoriametrics<Server ID>.hostkey.in:443

Внешний путь для приложения установлен как /.

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

Все файлы конфигурации, данные и сертификаты расположены в структуре корневого каталога следующим образом:

• Базовый каталог: /root/victoria-metrics-data

• Файл Docker Compose: /root/victoria-metrics-data/compose.yml

• Конфигурация аутентификации: /root/victoria-metrics-data/authconfig.yml

• Хранилище данных: /root/victoria-metrics-data (подключено к контейнеру)

• Конфигурация пользователя Nginx: /data/nginx/user_conf.d (подключено к контейнеру Nginx)

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

Приложение развертывается с использованием Docker Compose со следующими компонентами и версиями:

• VictoriaMetrics: victoriametrics/victoria-metrics:latest

• vmauth: victoriametrics/vmauth (последняя версия)

• Nginx с Certbot: jonasal/nginx-certbot:latest

Процесс развертывания включает:

1. Создание базового каталога /root/victoria-metrics-data.

2. Генерацию файлов compose.yml и authconfig.yml.

3. Создание внешнего тома Docker с именем victoriametrics.

4. Запуск сервисов с помощью команды docker compose up -d из каталога /root/victoria-metrics-data.

Контейнеры Docker и их развертывание¶

Система использует три основных контейнера, управляемых через Docker Compose:

• nginx:

• Образ: jonasal/nginx-certbot:latest

• Функция: Обработка SSL-терминации и обратного проксирования.

• Политика перезапуска: unless-stopped

• Переменные окружения: CERTBOT_EMAIL=hkadm@hostkey.com

• victoriametrics:

• Образ: victoriametrics/victoria-metrics:latest

• Функция: Основное хранилище и обработка метрик.

• Политика перезапуска: unless-stopped

• Подключенные тома: /root/victoria-metrics-data и victoriametrics

• vmauth:

• Образ: victoriametrics/vmauth

• Функция: Слой аутентификации для VictoriaMetrics.

• Политика перезапуска: unless-stopped

• Команда: -auth.config=/root/victoria-metrics-data/authconfig.yml

• Зависимости: Запускается после контейнера victoriametrics.

Прокси-серверы¶

Развертывание включает контейнер Nginx, настроенный с Certbot для управления SSL:

• Провайдер SSL: Let's Encrypt через Certbot.

• Email для продления: hkadm@hostkey.com.

• Путь конфигурации: /data/nginx/user_conf.d на хосте подключен к /etc/nginx/user_conf.d внутри контейнера.

• Хранилище секретов: Том nginx_secrets хранит сертификаты и ключи Let's Encrypt.

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

Права доступа к файлам и каталогам установлены следующим образом:

• Каталог: /root/victoria-metrics-data

• Владелец: root

• Группа: root

• Режим: 0644

• Файлы конфигурации: compose.yml и authconfig.yml

• Владелец: root

• Группа: root

• Режим: 0644

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

Следующие порты открыты и используются развертыванием:

Запуск, остановка и обновление¶

Управление сервисами осуществляется с помощью команд Docker Compose, выполняемых из каталога /root/victoria-metrics-data:

• Запуск сервисов:

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

• Остановка сервисов:

  cd /root/victoria-metrics-data
  docker compose down
  

• Обновление образов и перезапуск:

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

• Просмотр логов:

  cd /root/victoria-metrics-data
  docker compose logs -f