Обновление в рамках одной версии

Онлайн обновление

Перед обновлением необходимо зайти на страницу: v1.2_1.5 Стабильные версии и определить, бы ли выпущен в рамках обновления новый архив плейбуков Ansible, который указан в колонке Онлайн установка.

Новый архив для плейбуков онлайн установки не выпускался

В этом случае обновление в рамках одной версии на новые пакеты не требует выполнения плейбука, достаточно выполнить следующие действия:

Зайти на сервер и перейти в папку, где установлен Eltex-NAICE (по умолчанию /etc/docker-naice):
cd /etc/docker-naice
Выполнить команды для остановки, скачивания новых образов и старта контейнеров на новой версии:
docker compose pull && docker compose down && docker compose up -d

При условии наличия на удалённом репозитории свежих сборок они обновятся. При использовании многохостовой установки с резервированием необходимо выполнить данные команды на каждом хосте, где развернута система.

Есть альтернативный вариант - использовать специальный плейбук, который выполняет означенные выше команды:

ansible-playbook update-naice-images.yml

Был выпущен новый архив для плейбуков онлайн установки

Необходимо повторно скачать архив с плейбуками установки и выполнить повторно установку в соответствии с инструкцией по установке:

для однохостовой установки: v1.2_3.4 Установка плейбуками Ansible (одиночная "Stand-Alone")
для установки с резервированием: v1.2_3.5 Установка с резервированием (c использованием VRRP) или v1.2_3.6 Установка с резервированием (без использования VRRP).

Если какие-либо переменные в groups/all.yml были изменены - необходимо перенести значения переменных all.yml из старого плейбука в новый перед установкой. Также необходимо проконтролировать, что в group_vars/networks.yml указаны те же самые подсети docker, с которыми работает текущая инсталляция.

После выполнения повторной установки необходимо выполнить обновление образов вручную, как описано выше, или выполнить для каждого хоста плейбук:

ansible-playbook update-naice-images.yml

Обновление образов контейнеров после повторной установки плейбуком необходимое действие, т.к. они не скачиваются автоматически при обновлении в рамках одной версии!

Обновление инсталляции в закрытом контуре

Обновление в рамках одной версии в режиме оффлайн установки требует повторного скачивания архива установки и обновление путем повторной установки, в соответствии с выбранным режимом и типом ОС.

для однохостовой установки: v1.2_3.4.1 Установка в закрытом контуре (одиночная "Stand-Alone").
для установки с резервированием: v1.2_3.5.1 Установка схемы с резервированием в закрытом контуре (с использованием VRRP) или v1.2_3.6.1 Установка схемы с резервированием в закрытом контуре (без использования VRRP).

Если какие-либо переменные в groups/all.yml были изменены - необходимо перенести значения переменных all.yml из старого плейбука в новый перед установкой. Также убедитесь, что в group_vars/networks.yml указаны те же самые сети, с которыми работает текущая инсталляция.

После выполнения повторной установки необходимо выполнить обновление образов вручную, как описано выше, или выполнить для каждого хоста плейбук:

ansible-playbook update-naice-images.yml

Обновление контейнеров инсталляции в закрытом контуре

В случае если не было значимых изменений в переменных и конфигурации (не выпускался новый архив с плейбуками онлайн установки) можно выполнить обновление контейнеров в закрытом контуре без запуска плейбуков Ansible. Для этого необходимо:

Скачать архив оффлайн-установки.
Распаковать его.
Перенести на машину с NAICE (все хосты, в случае установки с резервированием) архив naice_images.tar, расположенного по пути после распаковки архива:
naice_install/naice_images/naice_images.tar
Загрузить на каждом хосте образы контейнеров командой:
sudo docker load -i naice_images.tar
Остановить сервисы NAICE на каждой ноде (команда выполняется в папке установки, по умолчанию /etc/docker-naice):
sudo docker compose down

Если используется установка с резервированием, помимо сервисов NAICE потребуется остановить СУБД PostgreSQL на каждой ноде (команда выполняется в папке установки, по умолчанию /etc/docker-naice):

# для первой ноды СУБД
sudo docker compose -f docker-compose.repmgr.yml down postgres-1

# для второй ноды СУБД
sudo docker compose -f docker-compose.repmgr.yml down postgres-2

Для многохостовой установки последовательно запустить СУБД на каждой ноде:
sudo docker compose -f docker-compose.repmgr.yml up -d
Запустить сервисы NAICE:
sudo docker compose up -d