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

Обзор развертывания 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 выполняется в несколько этапов с использованием автоматизированного процесса:

  1. Подготовка системы: Обновление пакетов apt, установка необходимых зависимостей (git, python3-venv, tmux, curl, acl, lsof, ca-certificates) и настройка автоматического перезапуска сервисов при обновлении ядра.

  2. Создание окружения: Создание пользователя aero с домашней директорией /opt/aero и установка прав доступа (включая ACL для пользователя libvirt-qemu).

  3. Клонирование репозитория: Загрузка исходного кода Open vAIR из GitHub в директорию /opt/aero/openvair.

  4. Конфигурация: Создание файла конфигурации project_config.toml на основе шаблона.

  5. Основная установка: Запуск установочного скрипта ./install.sh внутри сессии tmux. Процесс выполняется в фоновом режиме, а статус установки отслеживается через лог-файл /opt/aero/openvair/install.log.

  6. Патчинг системы:

  7. Модификация Python-скриптов для поддержки проксирования VNC через WebSocket.

  8. Настройка конфигурации виртуальных машин для корректной работы с публичным хостом (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 необходимо:

  1. Перейти в директорию проекта /opt/aero/openvair.

  2. Запустить процесс обновления (в зависимости от версии, может потребоваться повторный запуск установочного скрипта или выполнение команд git pull).

  3. После завершения обновления перезапустить системные службы:

  4. vm-domain.service

  5. vm-service-layer.service

  6. 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:

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

    sudo systemctl start vm-domain.service vm-service-layer.service web-app.service
    

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

    sudo systemctl stop vm-domain.service vm-service-layer.service web-app.service
    

  • Перезапуск (после обновлений):

    sudo systemctl restart vm-domain.service vm-service-layer.service web-app.service
    

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

Для обеспечения безопасного доступа к приложению используется Nginx с поддержкой SSL через Certbot.

  • SSL: Сертификаты управляются через контейнер nginx-certbot.

  • Проксирование VNC: Настроен WebSocket-прокси для работы VNC в браузере через URL /vnc-proxy/.

  • Prometheus API: Доступ к API Prometheus осуществляется через проксирование запросов на порт 9090.

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