Обновления
MonoPbx сам проверяет, есть ли новый выпуск, и на большинстве установок обновляется одной кнопкой. На этой странице описано, что делает проверка, что делает кнопка и что выполнить вручную, если кнопки нет.
Как узнать, есть ли обновление
Откройте Система, Обновления (/admin/upgrades, системные администраторы). Карточка Обновление программы показывает один из ответов:
- Установлена последняя версия (1.2.0).
- Доступна версия 1.3.0 (установлена: 1.2.0). со ссылкой Примечания к выпуску.
- Проверка обновлений выключена. (см. «Установки без интернета» ниже).
- Краткая причина, если не удалось связаться с каналом выпусков.
PBX проверяет раз в сутки, а Проверить сейчас проверяет немедленно. Проверка только читает небольшой общедоступный файл (release.json) из канала выпусков. Она ничего не устанавливает и ничего не отправляет о вашей установке и ваших звонках. Пока есть новая версия, пункт Обновления в меню консоли отмечен значком Обновление.
Канал (stable, beta или nightly) — тот, из которого сделана установка.
Обновление одним щелчком
Нажмите Обновить сейчас. В окне сказано, что произойдёт:
- Сначала делается полная резервная копия (снимок), чтобы всегда можно было вернуться.
- Новый выпуск загружается, проверяется и запускается, и он должен пройти самопроверку.
- Если самопроверка не пройдена, MonoPbx сам возвращается к прежнему выпуску с данными, которые были до обновления.
PBX будет недоступна несколько минут, текущие звонки завершатся, поэтому выберите спокойное время. Пока PBX перезапускается, консоль недоступна; страница продолжает опрашивать и показывает шаги: запрошено, загрузка, проверка, резервная копия, установка, запуск и обновление данных, самопроверка. В конце вы увидите один из трёх результатов:
| Результат | Что это значит |
|---|---|
| Обновление до 1.3.0 выполнено | Новый выпуск работает и прошёл самопроверку. |
| Обновление не прошло самопроверку | Снова работает прежний выпуск с данными, которые были до обновления. Ничего не потеряно. Прежде чем пробовать снова, обратитесь в поддержку, приложив пакет поддержки. |
| Обновление не завершено | Показана причина. Если сказано, что ничего не менялось, прежний выпуск продолжает работать. |
Нужно право system.operations:write (System Owner). Каждый запрос записывается в журнал аудита (upgrade.requested). После успешного обновления снимок сохраняется, поэтому Откатить на этой же странице остаётся доступным.
Если кнопки нет
Кнопка показывается, только когда выпуск можно установить напрямую (не более двух выпусков назад, тот же канал, без объявленных несовместимых изменений) и эта установка умеет обновлять себя. Иначе страница показывает Обновление из командной строки с точной командой и объясняет причину:
| Ваша установка | Обновление одним щелчком | Что выполнить |
|---|---|---|
| Установщик для виртуальной машины или пакет Debian | Да, начиная со второго обновления (первое после установки выпуска, который старше этой функции, выполняется вручную и подготавливает её). | sudo mpbx-ctl upgrade --channel stable |
Docker Compose без утилиты хоста (mpbx-ctl) | Нет | Команда, показанная на странице; нужен mpbx-ctl из пакета Compose. |
| Kubernetes | Нет | deploy/k8s/scripts/upgrade.sh upgrade --overlay overlays/ВАШ-ОВЕРЛЕЙ --release release.json; страница показывает строку целиком, включая загрузку release.json. |
Выпуск, для которого нужно ваше решение (несовместимое изменение, более двух выпусков, другой канал), показывается с причинами и никогда не запускается из консоли. Прочитайте примечания к выпуску и обновите из командной строки с опцией, которую они называют.
Установки без интернета
Установка без доступа в интернет может выключить проверку: задайте MPBX_UPDATE_CHECK=off в файле .env установки (установщик для виртуальной машины: /opt/mpbx/compose/prod/.env) и выполните sudo mpbx-ctl up; в Kubernetes задайте переменную окружения в Deployment mpbx-api. Тогда страница покажет Проверка обновлений выключена, и с хоста ничего не уходит. Такую установку обновляйте из пакета, который вы скопировали: sudo mpbx-ctl upgrade <mpbx-bundle.tar.gz>.
Если вы размещаете копию канала выпусков внутри своей сети, укажите её адрес (https://...) в MPBX_UPDATE_BASE_URL и при необходимости MPBX_UPDATE_CHANNEL.
Обновления по расписанию
Чтобы установка обновлялась сама в окно обслуживания, см. «Плановые автоматические обновления» в руководстве по обновлению (mpbx-ctl auto-update). Страница «Обновления» показывает расписание и итог последнего запуска.
Откат
Перед каждым обновлением хост сохраняет снимок. Откатить (на той же странице) возвращает выпуск и данные снимка; для подтверждения введите идентификатор снимка. Всё, что записано после него, покидает работающую систему, но сохраняется в базах данных, которые откат переименовывает; ничего не удаляется.