Обзор развертывания 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.
Процесс установки приложения¶
Процесс развертывания включает в себя несколько этапов:
-
Подготовка системы:
-
Остановка фоновых процессов обновления пакетов (
unattended-upgr) на системах семейства Debian/Ubuntu. -
Настройка сетевого экрана (firewalld для RHEL или аналогичные механизмы для Debian/Ubuntu) для разрешения трафика по портам 80 и 443.
-
Установка среды: Установка Docker и подготовка конфигураций для работы с SSL-сертификатами через Nginx.
-
Развертывание контейнеров:
-
Создание рабочей директории
/root/grafana. -
Создание именованного тома
grafana-dataкомандойdocker volume create grafana-data. -
Генерация файла
compose.ymlи запуск сервисов черезdocker compose up -d. -
Первоначальная настройка: Сброс пароля администратора с помощью встроенной утилиты 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
Инструкция по обновлению приложения¶
Для обновления основного приложения необходимо выполнить следующие действия:
-
Перейти в директорию с конфигурацией:
-
Обновить образы и перезапустить контейнеры: