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

Обновление модуля ADP с более ранней версии (например, 4.0) до актуальной версии (например, 5.0) требует временной остановки сервиса — ориентировочно на 10-15 минут.

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

cоздать резервные копии текущей версии:

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

перейти в директорию проекта с текущей версией модуля ADP:
```
cd <директория_папки_с_прошлой_версией>
```
создать резервные копии файлов текущей установленной версии модуля ADP, выполнив команды:
```
cp .env .env.v4.0.backup
```
```
sudo tar -czf mongo_data_v4.0_backup.tar.gz ./mongo_data
```

остановить текущую версию модуля ADP (например, 4.0):
```
docker compose -f docker-compose-v4.0.0.yml down
```
загрузить файлы дистрибутива новой версии (5.0) и разместить в той же директории проекта на уровне каталога mongo_data/
проверить целостность загруженных файлов:
```
md5sum -c md5sum_v5.txt
```
убедиться, что для всех файлов выведено состояние OK
распаковать архив с языковой моделью:
```
tar -xzf triva_llm_instruct.tar.gz
```
настроить файл переменных окружения:
- переименовать файл env в .env:
  mv env .env
- открыть файл .env и проверить соответствие значений параметров, измененных в предыдущей версии (например, <ADP_API_PORT>, <CUDA_VISIBLE_DEVICES>, а также ключи и пароли), с резервной копией .env.v4.backup
  
  Остальные параметры изменять без технической необходимости не рекомендуется
запустить обновленную версию модуля ADP (5.0), выполнив команды:
```
chmod +x deploy.adp_v5.0.0.sh
```
```
./deploy.adp_v5.0.0.sh
```
Скрипт выполнит загрузку Docker-образов и запуск сервисов

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

убедиться, что все проверки пройдены успешно, а обновленная версия функционирует корректно
удалить старые Docker-образы:
```
docker image prune -a -f
```

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

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

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

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