Обзор развертывания Open vAIR на сервере¶
Предварительные требования¶
Для корректной работы приложения требуются следующие параметры и системные условия:
-
Операционная система: Ubuntu.
-
Пользователь системы:
aero. -
Права доступа: Пользователь
aeroдолжен иметь праваsudoбез пароля для выполнения административных действий. -
Порты:
-
80/443: Внешний доступ (HTTP/HTTPS). -
8000: Внутренний порт веб-интерфейса приложения. -
9090: Порт Prometheus API. -
5672: Порт RabbitMQ. -
5432: Порт базы данных PostgreSQL.
FQDN итоговой панели на домене hostkey.in¶
| Параметр | Значение |
|---|---|
| Префикс | opvr |
| Домен | hostkey.in |
| Полный шаблон | opvr{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
Основные директории, используемые в системе:
-
/opt/aero: Корневая директория приложения (home для пользователяaero). -
/opt/aero/openvair: Директория репозитория приложения. -
/opt/aero/data: Основное хранилище данных приложения. -
/opt/aero/data/storage: Локальное файловое хранилище (backend). -
/opt/aero/data/mnt: Точки монтирования для внешних хранилищ. -
/opt/aero/restic: Репозиторий для резервного копирования. -
/opt/nginx: Директория конфигураций прокси-сервера Nginx. -
/data/nginx/user_conf.d: Каталог пользовательских конфигурационных файлов Nginx.
Процесс установки приложения¶
Развертывание Open vAIR выполняется в несколько этапов с использованием автоматизированного процесса:
-
Подготовка системы: Обновление пакетов
apt, установка необходимых зависимостей (git,python3-venv,tmux,curl,acl,lsof,ca-certificates) и настройка автоматического перезапуска сервисов при обновлении ядра. -
Создание окружения: Создание пользователя
aeroс домашней директорией/opt/aeroи установка прав доступа (включая ACL для пользователяlibvirt-qemu). -
Клонирование репозитория: Загрузка исходного кода Open vAIR из GitHub в директорию
/opt/aero/openvair. -
Конфигурация: Создание файла конфигурации
project_config.tomlна основе шаблона. -
Основная установка: Запуск установочного скрипта
./install.shвнутри сессииtmux. Процесс выполняется в фоновом режиме, а статус установки отслеживается через лог-файл/opt/aero/openvair/install.log. -
Патчинг системы:
-
Модификация Python-скриптов для поддержки проксирования VNC через WebSocket.
-
Настройка конфигурации виртуальных машин для корректной работы с публичным хостом (public_host).
Права доступа и безопасность¶
-
Пользователь приложения:
aeroимеет полный контроль над своей домашней директорией/opt/aero. -
Безопасность данных: Директория репозитория restic (
/opt/aero/restic) ограничена правами0700. -
ACL (Access Control Lists): Для обеспечения работы виртуальных машин установлены расширенные права доступа для пользователя
libvirt-qemuна директорию/opt/aero/data. -
Sudo: Пользователю
aeroразрешено выполнение команд черезsudoбез ввода пароля.
Базы данных¶
Приложение использует следующие компоненты баз данных:
| Компонент | Тип / Метод подключения | Хост | Порт |
|---|---|---|---|
| PostgreSQL | Docker-контейнер (postgres) | localhost | 5432 |
| RabbitMQ | Локальный сервис | localhost | 5672 |
Контейнеры Docker и их запуск¶
Для обеспечения работы веб-сервера с SSL-сертификатами используется контейнерный стек Nginx.
Контейнер Nginx (Certbot Proxy)
-
Образ:
jonasal/nginx-certbot:latest -
Режим сети:
host -
Тома (volumes):
-
nginx_secrets:/etc/letsencrypt(для хранения сертификатов) -
/data/nginx/user_conf.d:/etc/nginx/user_conf.d(конфигурации виртуальных хостов) -
Политика перезапуска:
unless-stopped
Кастомные скрипты и дополнительные настройки¶
В процессе развертывания выполняются следующие действия:
-
Установочный скрипт (
install.sh): Выполняет основную установку компонентов приложения, включая настройку зависимостей. -
Скрипт патчинга VNC: Python-скрипт, который изменяет файл
libs/network/utils.py, чтобы перенаправлять трафик VNC через прокси-сервер (websockify). -
Скрипт настройки IP: Python-скрипт, модифицирующий
modules/virtual_machines/config.pyдля поддержки использования публичного доменного имени вместо прямого IP-адреса сервера.
Инструкция по обновлению приложения¶
Для обновления основного приложения Open vAIR необходимо:
-
Перейти в директорию проекта
/opt/aero/openvair. -
Запустить процесс обновления (в зависимости от версии, может потребоваться повторный запуск установочного скрипта или выполнение команд
git pull). -
После завершения обновления перезапустить системные службы:
-
vm-domain.service -
vm-service-layer.service -
web-app.service
Расположение конфигурационных файлов и данных¶
| Тип данных | Путь к файлу / директории |
|---|---|
| Конфигурация приложения | /opt/aero/openvair/project_config.toml |
| Лог установки | /opt/aero/openvair/install.log |
| Данные приложения | /opt/aero/data |
| Резервные копии (restic) | /opt/aero/restic |
| Конфигурация Nginx | /data/nginx/user_conf.d/opvr{Server_ID_from_Invapi}.hostkey.in.conf |
Доступные порты для подключения¶
-
HTTPS (Web UI):
443 -
Prometheus API:
9090 -
VNC Proxy: Порты в диапазоне
60000-60999(через WebSocket)
Запуск, остановка приложения¶
Управление основными компонентами осуществляется через systemd:
-
Запуск всех сервисов:
-
Остановка сервисов:
-
Перезапуск (после обновлений):
Прокси серверы¶
Для обеспечения безопасного доступа к приложению используется Nginx с поддержкой SSL через Certbot.
-
SSL: Сертификаты управляются через контейнер
nginx-certbot. -
Проксирование VNC: Настроен WebSocket-прокси для работы VNC в браузере через URL
/vnc-proxy/. -
Prometheus API: Доступ к API Prometheus осуществляется через проксирование запросов на порт
9090.