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

Обновления

MonoPbx сам проверяет, есть ли новый выпуск, и на большинстве установок обновляется одной кнопкой. На этой странице описано, что делает проверка, что делает кнопка и что выполнить вручную, если кнопки нет.

Как узнать, есть ли обновление​

Откройте Система, Обновления (/admin/upgrades, системные администраторы). Карточка Обновление программы показывает один из ответов:

  • Установлена последняя версия (1.2.0).
  • Доступна версия 1.3.0 (установлена: 1.2.0). со ссылкой Примечания к выпуску.
  • Проверка обновлений выключена. (см. «Установки без интернета» ниже).
  • Краткая причина, если не удалось связаться с каналом выпусков.

PBX проверяет раз в сутки, а Проверить сейчас проверяет немедленно. Проверка только читает небольшой общедоступный файл (release.json) из канала выпусков. Она ничего не устанавливает и ничего не отправляет о вашей установке и ваших звонках. Пока есть новая версия, пункт Обновления в меню консоли отмечен значком Обновление.

Канал (stable, beta или nightly) — тот, из которого сделана установка.

Обновление одним щелчком​

Нажмите Обновить сейчас. В окне сказано, что произойдёт:

  1. Сначала делается полная резервная копия (снимок), чтобы всегда можно было вернуться.
  2. Новый выпуск загружается, проверяется и запускается, и он должен пройти самопроверку.
  3. Если самопроверка не пройдена, 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). Страница «Обновления» показывает расписание и итог последнего запуска.

Откат​

Перед каждым обновлением хост сохраняет снимок. Откатить (на той же странице) возвращает выпуск и данные снимка; для подтверждения введите идентификатор снимка. Всё, что записано после него, покидает работающую систему, но сохраняется в базах данных, которые откат переименовывает; ничего не удаляется.