Перейти к содержанию

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

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

Для успешного развертывания приложения необходимы следующие условия:

  • Операционная система: Debian, Ubuntu, CentOS, Rocky Linux или AlmaLinux.

  • Права доступа: права суперпользователя (root) для установки пакетов и управления Docker.

  • Сетевые настройки: открытые порты 80 (HTTP) и 443 (HTTPS).

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

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

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

В системе используются следующие директории для хранения данных и конфигураций:

  • /root/grafana — рабочая директория приложения, содержащая файл compose.yml.

  • /data/nginx/user_conf.d — директория с конфигурационными файлами Nginx.

  • /data/nginx/nginx-certbot.env — файл переменных окружения для SSL-сертификатов.

  • /data/grafana/datasources — каталог для хранения источников данных (datasources).

  • grafana-data — именованный том Docker для хранения основных данных Grafana.

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

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

  1. Подготовка системы:

  2. Остановка фоновых процессов обновления пакетов (unattended-upgr) на системах семейства Debian/Ubuntu.

  3. Настройка сетевого экрана (firewalld для RHEL или аналогичные механизмы для Debian/Ubuntu) для разрешения трафика по портам 80 и 443.

  4. Установка среды: Установка Docker и подготовка конфигураций для работы с SSL-сертификатами через Nginx.

  5. Развертывание контейнеров:

  6. Создание рабочей директории /root/grafana.

  7. Создание именованного тома grafana-data командой docker volume create grafana-data.

  8. Генерация файла compose.yml и запуск сервисов через docker compose up -d.

  9. Первоначальная настройка: Сброс пароля администратора с помощью встроенной утилиты Grafana CLI внутри контейнера.

Версия приложения: 8.2.6.

Права доступа и безопасность

  • Брандмауэр: Порты 80/TCP и 443/TCP должны быть открыты для внешнего доступа.

  • Пользователь: Все файлы в директории /root/grafana принадлежат пользователю root.

  • Безопасность данных: Использование Docker-томов для изоляции данных приложения от основной файловой системы хоста.

Базы данных

Приложение использует внутреннее хранилище Grafana, данные которого сохраняются в Docker-томе grafana-data по пути /var/lib/grafana. Внешние источники данных подключаются через конфигурационные файлы в директории /data/grafana/datasources.

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

Приложение работает в составе двух контейнеров, управляемых через docker compose:

Nginx (Proxy & SSL)

  • Образ: 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

Grafana

  • Образ: grafana/grafana-oss:8.2.6

  • Порты: 3000:3000

  • Тома:

  • /data/grafana/datasources:/etc/grafana/provisioning/datasources (настройка источников данных)

  • grafana-data:/var/lib/grafana (постоянное хранилище данных)

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

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

Для обновления основного приложения необходимо выполнить следующие действия:

  1. Перейти в директорию с конфигурацией:

    cd /root/grafana
    

  2. Обновить образы и перезапустить контейнеры:

    docker compose pull && docker compose up -d
    

question_mark
Я могу вам чем-то помочь?
question_mark
ИИ Помощник ×