Обзор развертывания Plane на сервере¶
Предварительные требования¶
Для успешного развертывания приложения требуются следующие условия:
-
Операционная система: Ubuntu.
-
Доступ к интернету для загрузки пакетов и образов Docker.
-
Права суперпользователя (root) для установки системных пакетов и управления контейнерами.
-
Наличие установленного Docker и Docker Compose.
FDQN итоговой панели на домене hostkey.in¶
Для работы приложения используется следующий шаблон доменного имени:
| Параметр | Значение |
|---|---|
| Префикс | plane |
| Домен | hostkey.in |
| Полный шаблон | plane{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
В процессе развертывания создаются следующие директории:
-
/opt/plane— основное хранилище данных приложения. -
/root/nginx— конфигурационные файлы для прокси-сервера. -
/root/plane-app— рабочая директория приложения и его окружение.
Процесс установки приложения¶
Установка выполняется в несколько этапов с использованием автоматизированного скрипта:
-
Обновление системных пакетов через
apt updateиapt upgrade. -
Создание директории для данных
/opt/plane. -
Загрузка установочного скрипта версии
v1.0.0по адресуhttps://github.com/makeplane/plane/releases/download/v1.0.0/setup.sh. -
Запуск установочного скрипта
./install.shс параметром для выполнения первичной настройки (Action 1). -
Модификация конфигурационного файла
/root/plane-app/plane.env: -
Установка порта Nginx на
8080. -
Настройка параметра
CORS_ALLOWED_ORIGINSв соответствии с установленным доменом приложения. -
Повторный запуск установочного скрипта
./install.shдля запуска сервисов (Action 2).
Контейнеры Docker и их запуск¶
Приложение использует контейнерную среду для работы прокси-сервера и обеспечения SSL-сертификатов.
Nginx Certbot
-
Имя образа:
jonasal/nginx-certbot:latest -
Сетевой режим:
host -
Тома (volumes):
-
nginx_secrets:/etc/letsencrypt— для хранения сертификатов SSL. -
/data/nginx/user_conf.d:/etc/nginx/user_conf.d— пользовательские конфигурации Nginx. -
Переменные окружения:
-
CERTBOT_EMAIL=hkadm@hostkey.com -
Политика перезапуска:
unless-stopped
Инструкция по обновлению приложения¶
Для обновления основного приложения необходимо выполнить следующие действия:
-
Перейти в директорию с приложением.
-
Запустить установочный скрипт повторно для применения изменений или использования встроенных функций обновления:
./install.sh.