Начало работы
Обновление Maran
Как обновить сервер: резервная копия панели и повторный запуск установщика, что он сохраняет и мигрирует, как проверить результат и что делать при сбое.
Обновить Maran значит запустить установщик ещё раз на сервере, где он уже установлен. Команд
maran update и maran rollback нет, а в самой панели нет обновления одним нажатием, поэтому
описанные ниже шаги и есть вся процедура. Выполняйте их от root, в оболочке на самом сервере.
1. Сначала сделайте резервную копию панели
Установщик ничего не умеет откатывать, поэтому путь назад даёт только эта копия. Создайте её так, как описано в разделе Резервная копия и восстановление панели:
sudo /usr/local/sbin/maran panel-backup --passphrase-file /root/maran-backup.passphrase
Скопируйте архив с сервера и храните парольную фразу не на сервере и не рядом с архивом. Панель
продолжает работать, пока копия создаётся. В архиве лежат база данных панели, два её ключа, лицензия
и /etc/maran; файлы и базы данных клиентов входят в резервные копии учётных записей, а не сюда.
2. Запустите установщик ещё раз
Выполните ту же команду, которой устанавливали:
curl -sSL https://get.maran.innovayse.com | sudo bash
Установщик можно безопасно запускать повторно. Он загружает актуальный подписанный выпуск, проверяет
подпись манифеста и контрольную сумму каждого архива до распаковки, а затем проверяет её ещё раз
непосредственно перед распаковкой этого архива. Канал выпусков выбирается запуском распакованного
установщика с --channel stable или --channel beta. Сервер без доступа в интернет использует
офлайн-пакет, описанный в разделе Установка:
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 установлен и доступен по адресу панели. Затем проверьте с самого сервера:
sudo /usr/local/sbin/maran status
Все службы должны быть активны и включены, а отчёт панели должен показывать доступную базу данных, подключённого агента, отсутствие ожидающих миграций и ожидаемую версию. Код завершения равен 0, если всё в порядке, и 1 в остальных случаях; что означает каждая часть, описано в разделе Восстановление доступа и диагностика. После этого войдите в панель и откройте главную страницу.
Если обновление не удалось
Установщик не откатывает изменения. Он останавливается на шаге, который не удался, и сообщает, на каком именно. Шаги до него уже выполнены, шаги после него нет.
- Прочитайте конец файла
/var/log/maran/install.logи сообщение, которое вывел установщик. - Устраните причину и запустите установщик снова. Каждый шаг сначала проверяет текущее состояние, поэтому повторный запуск продолжает с того места, где остановился предыдущий.
- Если панель не запускается, прочитайте
journalctl -u maran-apiиjournalctl -u maran-agentи выполнитеmaran status: эта команда работает и при остановленной панели.maran collect-diagnosticsсоздаёт архив с вычищенными секретами, который можно отправить тому, кто вам помогает.
Если сервер не удаётся починить, вернитесь к резервной копии из шага 1. Установите Maran на чистый
сервер, того же выпуска, что и копия, или более нового, не создавая администратора в браузере, и
выполните там maran panel-restore. При восстановлении к старой базе применяются миграции этого
выпуска. Шаги и то, от чего команда отказывается, описаны в разделе Резервная копия и восстановление
панели. Не восстанавливайте архив более нового выпуска на более старую
установку. Файлы, сайты и базы данных клиентов возвращаются из резервных копий учётных записей.