Перейти к содержимому

Начало работы

Обновление Maran

Как обновить сервер: резервная копия панели и повторный запуск установщика, что он сохраняет и мигрирует, как проверить результат и что делать при сбое.

Обновить Maran значит запустить установщик ещё раз на сервере, где он уже установлен. Команд maran update и maran rollback нет, а в самой панели нет обновления одним нажатием, поэтому описанные ниже шаги и есть вся процедура. Выполняйте их от root, в оболочке на самом сервере.

1. Сначала сделайте резервную копию панели

Установщик ничего не умеет откатывать, поэтому путь назад даёт только эта копия. Создайте её так, как описано в разделе Резервная копия и восстановление панели:

bash
sudo /usr/local/sbin/maran panel-backup --passphrase-file /root/maran-backup.passphrase

Скопируйте архив с сервера и храните парольную фразу не на сервере и не рядом с архивом. Панель продолжает работать, пока копия создаётся. В архиве лежат база данных панели, два её ключа, лицензия и /etc/maran; файлы и базы данных клиентов входят в резервные копии учётных записей, а не сюда.

2. Запустите установщик ещё раз

Выполните ту же команду, которой устанавливали:

bash
curl -sSL https://get.maran.innovayse.com | sudo bash

Установщик можно безопасно запускать повторно. Он загружает актуальный подписанный выпуск, проверяет подпись манифеста и контрольную сумму каждого архива до распаковки, а затем проверяет её ещё раз непосредственно перед распаковкой этого архива. Канал выпусков выбирается запуском распакованного установщика с --channel stable или --channel beta. Сервер без доступа в интернет использует офлайн-пакет, описанный в разделе Установка:

bash
sudo bash install.sh --offline-tarball <bundle>.tar.gz

При повторном запуске предварительная проверка принимает порт самой панели как занятый этой же установкой, а весь вывод дописывается в /var/log/maran/install.log, так что в журнале хранится история всех запусков.

Что установщик сохраняет, а что меняет

ЧтоПри повторном запуске
Security__EncryptionKey в /etc/maran/panel.envСохраняется. Ключ никогда не заменяется, потому что после замены сохранённые секреты нельзя было бы прочитать.
Jwt__SigningKey в /etc/maran/panel.envСохраняется, поэтому пользователи остаются в системе после обновления.
Минимум свободного места агента в /etc/maran/agent.envСохраняется, если это целое число от 1.
Остальное содержимое panel.envУстановщик записывает его заново; сведения о сервере, например порты SSH, определяются снова. Запишите значения, которые вы меняли вручную, и проверьте их после обновления.
Одноразовый токен настройкиЗаменяется новым. Он важен только пока нет первого администратора.
База данных панелиСохраняется и приводится к новой версии миграциями нового выпуска.
Программы панели и агентаЗаменяются программами нового выпуска.

Миграции базы данных

Установщик применяет миграции базы данных всех модулей отдельным шагом: после записи конфигурации и до запуска любой службы. Он запускает собственный исполняемый файл панели в режиме миграции от имени служебной учётной записи maran, поэтому миграция, которую не смогла бы выполнить сама панель, завершается ошибкой сразу, пока вы наблюдаете за процессом, а не через час. Если шаг не удался, установщик останавливается, и ничего не перезапускается.

Панель и агент обновляются вместе

Панель и серверный агент общаются по версионируемому контракту, и выпуск может менять его ревизию. В таком случае в заметках о выпуске есть раздел «Перед обновлением». Установщик заменяет оба компонента за один запуск, затем перезапускает сначала агент, потом панель, поэтому запускайте установщик целиком и не заменяйте только один из двух. При старте панель также приводит пул и виртуальный хост каждого PHP-сайта в соответствие с новым выпуском.

3. Проверьте результат

Когда установщик завершится, он напишет, что Maran установлен и доступен по адресу панели. Затем проверьте с самого сервера:

bash
sudo /usr/local/sbin/maran status

Все службы должны быть активны и включены, а отчёт панели должен показывать доступную базу данных, подключённого агента, отсутствие ожидающих миграций и ожидаемую версию. Код завершения равен 0, если всё в порядке, и 1 в остальных случаях; что означает каждая часть, описано в разделе Восстановление доступа и диагностика. После этого войдите в панель и откройте главную страницу.

Если обновление не удалось

Установщик не откатывает изменения. Он останавливается на шаге, который не удался, и сообщает, на каком именно. Шаги до него уже выполнены, шаги после него нет.

  1. Прочитайте конец файла /var/log/maran/install.log и сообщение, которое вывел установщик.
  2. Устраните причину и запустите установщик снова. Каждый шаг сначала проверяет текущее состояние, поэтому повторный запуск продолжает с того места, где остановился предыдущий.
  3. Если панель не запускается, прочитайте journalctl -u maran-api и journalctl -u maran-agent и выполните maran status: эта команда работает и при остановленной панели. maran collect-diagnostics создаёт архив с вычищенными секретами, который можно отправить тому, кто вам помогает.

Если сервер не удаётся починить, вернитесь к резервной копии из шага 1. Установите Maran на чистый сервер, того же выпуска, что и копия, или более нового, не создавая администратора в браузере, и выполните там maran panel-restore. При восстановлении к старой базе применяются миграции этого выпуска. Шаги и то, от чего команда отказывается, описаны в разделе Резервная копия и восстановление панели. Не восстанавливайте архив более нового выпуска на более старую установку. Файлы, сайты и базы данных клиентов возвращаются из резервных копий учётных записей.