Для кого: администратор панели / SRE. Требуемые права: сессия администратора; для запуска апгрейда из консоли — root на хосте панели.
Как панель узнаёт о новых версиях
- Нестампованные dev-сборки панель сравнивать отказывается — это защита от ложных «обновлений» на сборках без версии.
Безопасный порядок обновления
Сделайте бэкап
Запустите бэкап панели и проверьте его (
verify) — см. Резервные копии панели. Апгрейд умеет откатываться сам, но проверенный бэкап — ваша страховка от любых сценариев.Запустите апгрейд
Из консоли на хосте панели:Скрипт запускается в отдельной сессии и переживает остановку службы панели. Он скачивает архив релиза, сверяет SHA-256 (при несовпадении — отказ), сохраняет текущий бинарь и каталог миграций как резервные копии, останавливает службу, подменяет файлы и запускает службу снова.
Проверка
- Лог апгрейда лежит в каталоге данных панели; системные события — в
journalctl -u axottle.service.
Откат
- Автоматический: при неуспешном старте или неуспешной health-проверке скрипт сам возвращает предыдущий бинарь и миграции и перезапускает службу.
- Ручной: после успешного апгрейда скрипт печатает точные команды ручного отката (восстановление сохранённых бинаря и миграций). Помните: бинарь и миграции откатываются только вместе.
- Если и откат не помог — восстановите панель из проверенного бэкапа (Резервные копии панели).
Обновления агентов
Агенты на нодах обновляются отдельным механизмом: панель раздаёт проверенные по SHA-256 бинари, а задание считается успешным только после того, как агент отчитается целевой версией. Подробно — в Обновлении агентов.Ограничения и риски
- Апгрейд из панели доступен только для стампованных релизных сборок.
- Флаг отключения проверки контрольной суммы у скрипта существует, но настоятельно не рекомендуется.
- Пока идёт апгрейд, панель может быть недоступна несколько десятков секунд — планируйте окно.
Статус апгрейда — failed, но панель работает
Статус апгрейда — failed, но панель работает
Панель не поднялась после апгрейда и отката
Панель не поднялась после апгрейда и отката
Смотрите
journalctl -u axottle.service и лог апгрейда в каталоге данных панели. Крайняя мера — восстановление из бэкапа.Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-11.
