Обновление платформы и её агентов

Эта инструкция описывает обновление Платформы и агентов подсистемы топологии до версии 2.2.1.

Подготовка к обновлению

Создайте резервную копию действующей конфигурации:

Создайте директорию для хранения файлов резервной копии:
```
mkdir backup/
```
Скопируйте в директорию с резервными копиями:
- файлы из дистрибутива предыдущего развёртывания:
  - foliage-config.yml;
  - foliage-inventory.ini;
  - platform_env+config.yml;
- директории с конфигурационными файлами действующей конфигурации:
  - /opt/skala-r/platform-services/configs/;
  - /opt/skala-r/platform-services/wssh/.
Запустите установщик версии 2.2.0:
```
./genome-2.0.0.run
```
Выберите пункт Резервное копирование платформы.

Установщик создаст архив полной резервной копии.
Выберите пункт Выход.

Чтобы обновить сервер Платформы:

Загрузите на установочный узел архив genome-v2.2.1.tar.gz.
Распакуйте загруженный архив:
```
tar xvfz genome-v2.2.1.tar.gz
```
Запустите установщик. Он распакует свои файлы в новую директорию и проверит их контрольные суммы.
Выберите пункт Выход.
Скопируйте в директорию с файлами нового дистрибутива файл platform_env+config.yml из резервной копии:
```
cp -f backup/platform_env+config.yml genome-2.2.1/
```
Запустите файл start.sh, передав в значении аргумента -f путь к файлу конфигурации:
./start.sh -f platform_env+config.yml
В терминале отобразится мастер интерактивного обновления платформы:
======================================== УПРАВЛЕНИЕ УСТАНОВКОЙ ГЕНОМ ======================================== Обновление Геном Обновление с 2.2.0 на 2.2.1
На этапе Обновить конфигурацию? введите да и нажмите Enter.
На этапе Вы уверены? (да/нет) введите да и нажмите Enter.

Чтобы восстановить конфигурацию из резервной копии:

Скопируйте из резервной копии файлы foliage-config.yml и foliage-inventory.ini в директорию с файлами установщика версии 2.2.1:
```
cp -f backup/foliage-config.yml    ./genome-2.2.1/
cp -f backup/foliage-inventory.ini ./genome-2.2.1/
```
Скопируйте из резервной копии директории configs/ и wssh/ в исходное расположение:
```
cp -r backup/configs/ /opt/skala-r/platform-services/
cp -r backup/wssh/    /opt/skala-r/platform-services/
```

Перезапустите контейнеры:

Перейдите в директорию с файлами установщика версии 2.2.1:
```
cd ./genome-2.2.1/
```
Запустите установщик:
```
./genome-2.2.1.run
```
Выберите пункт Перезапустить сервисы.
Выберите пункт Выход.
Проверьте статус контейнеров:
docker service ls
Проверка считается успешной, если запущены все необходимые сервисы, а количество реплик соответствует ожидаемому.

Чтобы обновить агенты платформы:

Перейдите в директорию с файлами установщика версии 2.2.1:
```
cd ./genome-2.2.1/
```

Запустите плейбук удаления старых версий агента:

ansible-playbook \
   foliage-agent.yml \
   --tags foliage_agent_uninstall \
   -e @./foliage-config.yml \
   -i ./foliage-inventory.ini

Запустите плейбук установки новой версии агента:

ansible-playbook \
   foliage-agent.yml \
   --tags foliage_agent_install \
   -e @./foliage-config.yml \
   -i ./foliage-inventory.ini

Выполняйте этот шаг только при критических ошибках на этапах обновления сервера и агентов платформы.

Перейдите и директорию с файлами установщика версии 2.2.1:
```
cd ./genome-2.2.1/
```
Запустите скрипт start.sh с аргументом -a, в значении которого укажите путь к файлу с полным архивом резервной копии, например:
```
./start.sh -a full-backup-2.2.1-20260904-165457.tar.gz
```