Обновление модуля ADP

Обновление модуля ADP с более ранней версии (например 5.0) до актуальной версии (например 6.0) требует временной остановки сервиса. При расчете времени простоя необходимо учитывать создание резервной копии каталога mongo_data/.

Для обновления модуля ADP необходимо:

создать резервную копию файла переменных окружения текущей версии:

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

перейти в директорию проекта с текущей версией модуля ADP:
```
cd <директория_папки_с_прошлой_версией>
```
создать резервную копию файла .env:
```
cp .env .env.v5.0.backup
```

остановить текущую версию модуля ADP (например 5.0):
```
docker compose -f docker-compose-v5.0.0.yml down
```
создать резервную копию данных MongoDB:
```
sudo tar -czf mongo_data_v5.0_backup.tar.gz ./mongo_data
```
загрузить файлы дистрибутива новой версии (6.0) и разместить в той же директории проекта на уровне каталога mongo_data/
проверить целостность загруженных файлов:
```
md5sum -c md5sum_v6.txt
```
убедиться, что для всех файлов выведено состояние OK
получить архив языковой модели triva_llm_instruct.tar.gz вместе с файлами дистрибутива и разместить его в той же директории, что и файл docker-compose-v6.0.0.yml. Скрипт развертывания распакует архив в каталог ./models/triva_llm_instruct

Сохранившийся архив из поставки версии 5.0 можно использовать повторно
настроить файл переменных окружения:
- переименовать файл env в .env:
  mv env .env
- открыть файл .env и перенести из резервной копии .env.v5.0.backup значения параметров, измененные в предыдущей версии, например <ADP_API_PORT>, <CUDA_VISIBLE_DEVICES>, ключи и пароли. Значения MONGODB_USERNAME и MONGODB_PASSWORD необходимо сохранить из предыдущей версии. Существующая база данных MongoDB использует эти учетные данные
  
  Остальные параметры изменять без технической необходимости не рекомендуется
запустить обновленную версию модуля ADP (6.0), выполнив команды:
```
chmod +x deploy.adp_v6.0.0.sh
```
```
./deploy.adp_v6.0.0.sh
```
Скрипт проверит файлы, загрузит Docker-образы, распакует архив модели в каталог ./models/triva_llm_instruct и запустит сервисы

проверить работоспособность обновленной версии (6.0), выполнив команды:
```
docker compose -f docker-compose-v6.0.0.yml ps
```
```
docker compose -f docker-compose-v6.0.0.yml logs -f adp_worker_client
```

убедиться, что все проверки пройдены успешно, а обновленная версия функционирует корректно

Образы версии 5.0 необходимо сохранить до завершения проверки новой версии и на все время, пока требуется возможность отката

Процедура отката к предыдущим версиям

В случае некорректной работы обновленной версии модуля ADP следует выполнить процедуру отката к предыдущей версии. Откат к предыдущей версии выполняется путем повторного развертывания контейнеров приложения с использованием Docker-образов соответствующей версии.

Для отката версии модуля ADP к более ранней версии:

остановить текущую версию (например 6.0):
```
docker compose -f docker-compose-v6.0.0.yml down
```
восстановить резервную копию файла переменных окружения:
```
cp .env.v5.0.backup .env
```
восстановить резервную копию базы данных MongoDB:
```
sudo rm -rf mongo_data && sudo tar -xzf mongo_data_v5.0_backup.tar.gz
```
запустить предыдущую версию модуля ADP (например 5.0):
```
docker compose -f docker-compose-v5.0.0.yml up -d
```