Общие сведения об обновлении SpaceVM
Процедуру установки обновлений рекомендуется выполнять на контроллере после проверки доступности всех узлов SpaceVM. При запуске установки обновлений на контроллере SpaceVM происходит синхронное обновление всех доступных контроллеру узлов SpaceVM.
Внимание!
Рекомендуется производить все работы с обновлениями SpaceVM на контроллере, убедившись в доступности всех узлов SpaceVM.
В случае отсутствия доступа к репозиториям SpaceVM, расположенным по адресу update.spacevm.ru, необходимо обеспечить такой доступ или развернуть собственный сервер обновлений с репозиториями SpaceVM. Как развернуть собственный сервер обновлений с репозиториями SpaceVM смотрите в разделе Использование собственного сервера обновлений.
Внимание!
Если во время обновления SpaceVM один или несколько узлов SpaceVM невозможно обновить, то необходимо выполнить обновление данных узлов в кратчайшее время до соответствующей версии.
Версионность SpaceVM
Модель версионности SpaceVM соответствует классической нумерации X.Y.Z-B:
-
X - мажорная версия. Меняется при крупных релизах. Выходит раз в год. Может не быть обратно совместима с прежними релизами. Требуется смена репозитория для получения обновлений. Требуется перезагрузка после обновления.
-
Y - минорная версия. Меняется при промежуточных релизах. Выходит раз в 3-4 месяца. Обязательно должна быть обратная совместимость. Требуется смена репозитория для получения обновлений. Иногда (не всегда) рекомендуется перезагрузка после обновления. Перед сменой репозиторией всегда рекомендуется сначала обновиться до последних версий патчей в рамках текущего репозитория.
-
Z - версия патча. Меняется при исправлении ошибок промежуточных релизов и добавлении нового небольшого функционала. Выходит раз в 2 недели/месяц.
-
B - номер сборки. Меняется при каждой сборке пакета. Иногда необходима команде SpaceVM для сверки фактического пакета и сборочного задания.
Порядок обновлений
Все обновления выполняются последовательно, начиная снизу вверх. Сначала обновляется версия патча X.Y.Z, далее минорная версия X.Y.Z, далее мажорная версия X.Y.Z.
В общем случае порядок действий следующий:
-
Обновить текущую версию ПО, до последней версии патча в текущем репозитории (см. установка патчей).
-
Для обновления минорной версии ПО сменить текущий репозиторий на репозиторий со следующей минорной версией. Обновить минорную версию до последней версии патча. Повторить действия необходимое количество раз, и последовательно обновить минорную версию ПО до последней минорной версии (см. установка минорного обновления).
-
Для обновления мажорной версии ПО сменить репозиторий с последней минорной версией на репозиторий со следующей мажорной версией. Обновить мажорную версию до последней версии патча. Повторить действие необходимое количество раз, и последовательно обновить мажорную версию ПО до последней мажорной версии (см. установка мажорного обновления).
Последовательность обновлений
Необходимо соблюдать последовательность обновлений. Запрещено обновлять минорные и мажорные версии, пропуская нумерацию. То есть нельзя обновляться, например, с версии 6.2 сразу до версии 6.4. Также крайне рекомендуется перед обновлением минорной версии обновиться до последней доступной на данный момент версии патча. Причиной является необходимость последовательного применения миграций базы данных и возможные подготовительные этапы перед минорным обновлением.
Стабильность обновлений
Каждый последующий релиз стабильнее предыдущего в общем случае, так как обычно больше времени между релизами тратится над исправлением ошибок и расширением вариаций поведения ПО, чем на добавление нового функционала. Поэтому обновляться всегда рекомендуется до последней версии. В случае выявления ошибок после обновления рекомендуется сразу обратиться к вендору для выпуска оперативного патча.
Обновляться или нет
Если вас всё устраивает и нужным вам функционал работает корректно, то обновляться не стоит. В остальных случаях рекомендуем обновиться до последней версии.
Текущий цикл жизни ПО предусматривает поддержку релизов в течение года.
Базовая версия ПО
Берётся из версии пакета utils, как базового для любого типа инсталляции.
Определение версии SpaceVM
Версию установленного SpaceVM можно узнать через Web-интерфейс или при помощи CLI.
Определение версии в Web-интерфейсе контроллера
Определить версию установленного SpaceVM можно несколькими способами:
-
В правом нижнем углу Web-интерфейса указана версия SpaceVM.
-
Перейти в раздел Настройки - Контроллер основного меню, в открывшемся окне выбрать пункт ПО и Сервисы - ПО. В открывшемся окне будут указаны версия контроллера SpaceVM и версии основных модулей.
-
Перейти в раздел Серверы основного меню, выбрать сервер, версию SpaceVM которого необходимо узнать. В открывшемся окне выбрать пункт ПО и Сервисы - ПО. В данном разделе будет указаны версия SpaceVM и версии основных модулей.
Определение версии в Web-интерфейсе узла
Чтобы определить версию SpaceVM, необходимо перейти в раздел Версия ПО основного меню и в открывшемся окне будут указаны версия SpaceVM и версии основных модулей.
Определение версии в CLI
Определить версию SpaceVM можно выполнив в CLI следующую команду:
version
Пример вывода определения версии контроллера командой version
:
SpaceVM V6.0.3, LLC “DACOM M”
controller-app: 6.0.3-3148
controller-env: 6.0.3-1090
controller-ui: 6.0.3-1075
cli-app: 6.0.3-1128
cli-env: 6.0.3-1024
node-app: 6.0.3-1057
node-env: 6.0.3-874
node-ui: 6.0.3-135
docs: 6.0.3-1217
utils: 6.0.3-1425
Пример вывода определения версии узла командой version
:
SpaceVM V6.0.3, LLC “DACOM M”
cli-app: 6.0.3-1128
cli-env: 6.0.3-1024
node-app: 6.0.3-1057
node-env: 6.0.3-874
node-ui: 6.0.3-135
utils: 6.0.3-1425
Описание пакетов
utils - базовый пакет со всеми основными зависимостями, необходимыми для работы основных компонентов SpaceVM. По нему определяется базовая версия и от него зависят все остальные пакеты. Обновляется всегда первый. Включает в себя систему автотестирования узла.
docs - документация в Web-интерфейсе. Есть только на контроллере. На официальный сайт выкладывается последняя документация из общей ветки разработки каждый раз при сборке пакета.
cli-env - зависимости CLI.
cli-app - CLI.
node-env - зависимости узла.
node-app - супервизор и Web-сервер узла.
node-ui - Web-интерфейс узла.
controller-env - зависимости контроллера.
controller-app - супервизор и Web-сервер контроллера.
controller-ui - Web-интерфейс контроллера.
Механизм обновления SpaceVM
Во время обновления SpaceVM выполняет следующие действия:
- Блокируется Web-интерфейс с выводом сообщения о том, что идет процесс обновления.
- Происходит повторная проверка наличия обновлений.
- Если происходит обновление контроллера, то останавливаются все сервисы. В том числе перестают работать Высокая доступность и Динамическое распределение ресурсов между серверами.
- Обновляется пакетная база SpaceVM.
- Происходит автотестирование системы.
- После завершения обновления контроллера запускаются все сервисы. Высокая доступность и Динамическое распределение ресурсов работают в штатном режиме.
- Возобновляется штатная работа Web-интерфейса SpaceVM.
Безопасность обновлений
Для обеспечения безопасности используется проверка целостности пакетов в репозиториях SpaceVM на основе хеш-суммы, а файл, содержащий контрольные суммы, подписан закрытым ключом с алгоритмом шифрования RSA 4096. При обновлении производится сверка хеш-сумм и проверка подписи с использованием открытого ключа, который поставляется в комплекте с SpaceVM. Таким образом, при повреждении пакета или его подмены установка выполнена не будет.