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

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

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

Удалены два сервиса: clickhouse-parser, etl-stats

Удалены следующие переменные: CLICK_PARSER_HOST, CLICK_PARSER_OPTIONS, CLICK_PARSER_PORT, CLICK_PARSER_TIMEOUT

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

Для обновления Системы выполните следующие действия:

Подключитесь к серверу через ssh
Перейдите в рабочую директорию приложения, в дальнейшем ожидается, что остальные команды выполняются из рабочей директории приложения:
```
cd /opt/aw/app
```
Загрузите на сервер дистрибутив AW BI.
Создайте резервную копию файла конфигурации, а также сформируйте список изменений в файле конфигурации по сравнению с шаблоном:
```
cp .env ../env.backup.$(date +'%Y-%m-%d_%H%M%S')
diff -wu .env.dist .env > ../env.diff
```
Остановите AW:
```
docker compose down -v
```
Удалите папку rabbitmq для корректного обновления версии:
```
rm -rf ../db/rabbitmq
```
Распакуйте дистрибутив:
```
tar xvf ./release-VERSION.tar
```
Файл дистрибутива можно удалить, если есть дефицит дискового пространства
Скопируйте шаблон файла конфигурации .env.dist в файл конфигурации .env и примените изменения в нем (автоматически или вручную):
```
cp .env.dist .env
# автоматическое применение изменений:
patch < ../env.diff
```
Автоматическое применение изменений может не сработать в некоторых случаях. В этом случае необходимо будет вручную повторно внести изменения в файле .env.

Убедитесь, что произведены все изменения в конфигурации между старой и новой версиями.

Загрузите в Docker обновленные образы компонентов AW.

Для закрытого контура перейдите в каталог установки Системы и выполните скрипт ./install.sh:

chmod +x install.sh
./install.sh

Для открытого контура: Подключите Docker Registry:

docker login registry.analyticworkspace.ru
# Отобразится запрос о необходимости ввести учетную запись. Введите данные учетной записи, ранее использованной для скачивания дистрибутива

Запустите скрипт create_project_dirs.sh для того чтобы создать необходимые директории:
```
chmod +x create_project_dirs.sh
./create_project_dirs.sh
```

Выполните запуск Системы и примените миграции:

docker compose up -d
docker compose exec backend php yii migrate --interactive=0 | tee ./backend_migration.log
docker compose exec backend php yii run-code-migrations | tee ./backend_code_migration.log
docker compose exec etl-api /app/manage migrate | tee ./etl_api_migration.log

Выполните очистку docker от старых образов.

Данный пункт не обязателен, но является рекомендацией. Данная операция позволяет избежать лишнего использования дискового пространства.
```
set -e; TAG=$(grep "^AW_VERSION" .env | cut -f2 -d '='); REG=$(grep "^LOCAL_REGISTRY" .env | cut -f 2 -d '='); for i in $(docker images --format "{{.Repository}}:{{.Tag}}" "${REG}/*" | grep -v ${TAG} ); do docker rmi ${i}; done
```