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

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

Для корректной работы приложения требуются следующие условия:

Операционная система: Ubuntu.
Доступ к интернету для загрузки установочных пакетов и скриптов.
Права суперпользователя (root) для выполнения установки и управления системными службами.
Наличие установленного Docker.

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

Для доступа к панели управления используется следующий шаблон доменного имени:

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

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

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

Подготовка системы: установка пакета wget и загрузка установочного скрипта из репозитория по адресу http://core.brainycp.com/install.sh.
Запуск установки: выполнение установочного скрипта install.sh в автоматическом режиме (с подтверждением всех запросов).
Перезагрузка системы: после завершения процесса установки сервер автоматически перезагружается для применения изменений.
Настройка проксирования: создание конфигурации Nginx и запуск контейнера для обеспечения работы через SSL.

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

Для обеспечения работы веб-сервера и автоматического получения SSL-сертификатов используется следующий контейнер:

Имя образа	Порты	Тома (volumes)	Переменные окружения	Политика перезапуска
`jonasal/nginx-certbot:latest`	`network_mode: host`	`- nginx_secrets:/etc/letsencrypt` `- /data/nginx/user_conf.d:/etc/nginx/user_conf.d`	`CERTBOT_EMAIL=hkadm@hostkey.com` (из файла `/data/nginx/nginx-certbot.env`)	`unless-stopped`

Кастомные скрипты и дополнительные настройки¶

В процессе развертывания выполняются следующие действия:

Загрузка установочного скрипта в директорию /root/install.sh.
Автоматическая модификация конфигурационных файлов Nginx: в файлах, расположенных по пути /data/nginx/user_conf.d/{prefix}{server_id}.hostkey.in.conf, удаляется старая директива proxy_pass и добавляется новая: proxy_pass http://127.0.0.1:8002;. Это необходимо для перенаправления трафика на внутренний порт приложения.

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

Для обновления основного приложения BrainyCP рекомендуется использовать стандартные методы обновления пакетов вашей операционной системы или повторно запустить установочный скрипт из /root/install.sh, если это предусмотрено разработчиком приложения.

Расположение конфигурационных файлов и данных¶

Основные пути к данным и файлам:

Директория установки приложения: /usr/local/brainycp.
Конфигурационные файлы Nginx: /data/nginx/user_conf.d/.
Файл окружения для Docker: /data/nginx/nginx-certbot.env.
Рабочая директория прокси-сервера: /root/nginx.

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

Порт	Назначение	Протокол
`8002`	Внутренний порт приложения (локальный)	TCP
`443`	Внешний доступ к панели управления	HTTPS