Обновление AW¶

Внимание Перед переходом на релиз 1.34 и старше обязательно проверьте корректность формул на Вашем стенде. Для проверки нужно запустить специальный скрипт. Получить скрипт и файл с результатами проверки можно через службу поддержки AW.

Также рекомендуем заранее ознакомиться с описанием целевых и промежуточных релизов на нашем портале AW community

Технические изменения в выпуске AW 1.35¶

Изменения в конфигурации¶

Добавлены переменные:

Переменная	Новая?	Описание	Значение по умолчанию
BACKEND_PULLER_TIMEOUT	Да	Таймаут на соединение с с puller'ом на сторорне backend (в секундах)	600

Подготовка¶

обновить awctl на последнюю версию

сделать рез. копию конфигурации профиля:

cp $HOME/.awctl/profiles/<имя_профиля>/config.yml $HOME/.awctl/profiles/<имя_профиля>/config.yml.bak

В случае необходимости загрузить архив с новым релизом на сервер с awctl, выполнить рез. копирование БД AW

Для awctl начиная с версии 1.7.5 (автоматизированное обновление конфигурационного файла профиля)¶

Начиная с версии awctl - 1.7.5 доступна команда update. awctl update - анализирует текущий конфигурационный файл профиля, генерирует конфигурационный файл для новый версии AW и переносит все изменения сделанные в старом конфигурационном файле.

Обновление конфигурации профиля AW¶

Выполняем команду: - /opt/awctl/awctl update --version <номер новой версии AW> <имя профиля> Результатом выполнениия команды станет новый конфигурационный файл профиля с перенесенными изменениями из старого. Рез. копия старого конфигурационного профиля сохраняется под именем config.<старая версия AW>.yml.

рекомендуется проверить новый конфигурационный файл - корректность переноса секций env, настроек aw_host, aw_user и т.п.
выполнить команду gen - /opt/awctl/awctl gen <имя профиля>
выполнить команду install - /opt/awctl/awctl install <имя профиля>
выполнить команду migrate - /opt/awctl/awctl migrate <имя профиля>

Для awctl до версии 1.7.4 (ручное обновление конфигурационного файла профиля)¶

Подготовка нового конфигурационного файла профиля¶

Т.к. кол-во сервисов в составе AW может меняться от версии к версии, при обновлении распределенной установки требуется сгенерировать распределение сервисов по серверам заново:

/opt/awctl/awctl init --preset <кол-во серверов> --release-path <путь к архиву с релизом AW> <имя профиля>

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

aw_home, aw_host, aw_ssh_host, aw_user, aw_ssh_user, aw_ssh_password и т.п. для каждого сервера
секцию env для каждого сервера, если используется
значения with_extra_hosts, with_traefik из секции aw

Сделать это можно с помощью любого удобного текстового редактора.

Обновление AW¶

Для обновления установки AW выполните следующие действия:

Генерируем конфигурационные файлы для серверов:
```
/opt/awctl/awctl gen <имя_профиля>
```
При обновлении с версия 1.2* - останавливаем AW:
```
/opt/awctl/awctl stop <имя_профиля>
```
Удаляем содержимое директории db/rabbitmq
```
cd /opt/aw/db/rabbitmq
rm -rf ./*
```
Выполняем установку AW:
```
/opt/awctl/awctl install <имя_профиля>
```
Если установка выполняется из полного релизного архива (release-<версия AW>.tar), то выполнение команды может занять длительное время.

Выполняем миграции:

/opt/awctl/awctl migrate <имя_профиля>