Начало работы
Установка
Установка Maran на чистый сервер, что установщик проверяет первым делом и как создаётся первый администратор.
Устанавливайте на сервер, которым управляете сами, с доступом root и одной из поддерживаемых платформ.
Запустить установщик
curl -sSL https://get.maran.innovayse.com | sudo bash
Установщик проверяет систему до того, как что-то изменить: дистрибутив и его версию по матрице поддержки, пороги по памяти и диску и нужные порты. Он собирает все отказы и выходит один раз, так что список исправляется целиком, а не по одной проблеме за запуск. Нехватка места для резервных копий не останавливает установку, это предупреждение: если на файловой системе, где они будут лежать, свободно меньше 10 ГиБ, установщик сообщает об этом и продолжает работу.
Если проверки пройдены, он ставит подписанные артефакты релиза, ужесточает systemd-юниты и разворачивает то, что нужно хостинговому серверу: веб-сервер, PostgreSQL для данных самой панели, сервер баз данных для аккаунтов, передачу файлов, брандмауэр и планировщик.
Установщик записывает имя хоста сервера в panel.env (Panel__HostName) и использует его как
server_name панели. Если имя хоста непригодно (пустое, localhost или содержит символы, кроме букв,
цифр, точек и дефисов), ничего не записывается, и панель отвечает на localhost. Повторный запуск
установщика после исправления имени хоста обновляет и то и другое.
Установка без доступа в интернет
Сервер, который не может обратиться к узлу загрузки, ставится из пакета, доставленного на него вручную. Пакет представляет собой один файл, который команда maran release package собирает из релиза, построенного под архитектуру сервера (maran release build) и подписанного (maran release sign). Скопируйте его на сервер и из распакованного пакета установщика передайте установщику:
sudo bash install.sh --offline-tarball <bundle>.tar.gz
Пакет содержит подписанный манифест, список целостности кода с его подписью и три архива (API, агент и интерфейс панели). Установщик до распаковки проверяет подпись манифеста и контрольную сумму каждого архива по его записи в манифесте, а непосредственно перед извлечением каждого архива проверяет её ещё раз. Пакет, не прошедший любую из проверок, останавливает установку.
Первый администратор
По завершении установщик печатает ссылку на страницу настройки, а на отдельной строке одноразовый
токен настройки. Откройте ссылку и вставьте токен в соответствующее поле: это единственный способ
создать первого администратора, больше его не создать ничем. Токен намеренно не входит в ссылку и
перестаёт действовать, как только в панели появляется пользователь. Если вы его потеряли, прочитайте
Setup__Token из /etc/maran/panel.env от имени root.
После первого входа
Включите двухфакторную аутентификацию и создайте первый аккаунт хостинга. Аккаунт здесь является настоящим пользователем Linux со своим домашним каталогом, своим пулом php-fpm и квотой по тарифу. Создание через панель разворачивает его на хосте.
Обновления
Обновление выполняется повторным запуском установщика, который безопасно повторять: он получает текущий
подписанный релиз, до распаковки проверяет подпись и каждую контрольную сумму и до запуска панели
применяет миграции базы данных каждого модуля. Обновления в один щелчок в панели пока нет, как нет и
команды maran rollback, поэтому сначала сделайте резервную копию панели (см. Резервная копия и
восстановление панели). Путь назад один: восстановить этот архив на чистую
установку. Maran не настраивает автоматическую установку обновлений операционной системы.