Обновление

Дарья Барышева, Аделя Звягинцева
ВНИМАНИЕ

  • Перед выполнением обновления рекомендуется сделать резервную копию данных ADCM. Дополнительную информацию можно получить в статье Backup & Restore.

  • Понижение версии ADCM не поддерживается.

  • Не рекомендуется обновлять ADCM более, чем на 5 минорных версий (см. <minor> в описании формата версионирования ниже).

  • Перед обновлением ADCM до версии 2.7.0 выполните миграцию данных из SQLite в PostgreSQL. Миграцию можно осуществить в ADCM любой версии (до 2.6.0 включительно).

Online-обновление

Для обновления ADCM до нужной версии выполните следующие шаги:

  1. Остановите Docker-контейнер adcm:

    $ sudo docker stop adcm

  2. Удалите Docker-контейнер adcm:

    $ sudo docker container rm adcm

  3. Загрузите из Arenadata Docker Registry необходимый Docker-образ:

    $ sudo docker pull hub.arenadata.io/adcm/adcm:<version>

    где <version> — это версия Docker-образа в одном из следующих форматов:

    • <major>.<minor>.<patch> — если необходим конкретный патч ADCM. Пример: 2.0.0.

    • <major>.<minor> — если необходим последний патч в рамках выбранной версии ADCM. Пример: 2.0.

    ВАЖНО

    • latest использовался для ранних версий ADCM и начиная с версии 2.0.0 больше не поддерживается.

    • До выпуска ADCM 2.0.0 для версионирования использовался следующий формат: YYYY.MM.DD.HH.

  4. Создайте новый Docker-контейнер на базе загруженного образа:

    $ sudo docker create --name adcm -p 8000:8000 -v /opt/adcm:/adcm/data -e DB_HOST="<DATABASE_HOSTNAME_OR_IP_ADDRESS>" -e DB_PORT="<DATABASE_TCP_PORT>" -e DB_USER="<DATABASE_USERNAME>" -e DB_NAME="<DATABASE_NAME>" -e DB_PASS="<DATABASE_USER_PASSWORD>" -e DB_OPTIONS="<DATABASE_OPTIONS>" hub.arenadata.io/adcm/adcm:<version>
    ПРИМЕЧАНИЕ
    Подробная информация о переменных окружения DB_HOST, DB_PORT, DB_USER, DB_NAME, DB_PASS и DB_OPTIONS приведена в статье Установка.

  5. Запустите новый Docker-контейнер adcm:

    $ sudo docker start adcm

Offline-обновление

Если хосты не имеют доступ к Интернету, то доступно offline-обновление ADCM. Чтобы выполнить offline-обновление ADCM до нужной версии, сделайте следующее:

  1. Остановите Docker-контейнер adcm:

    $ sudo docker stop adcm

  2. Удалите Docker-контейнер adcm:

    $ sudo docker container rm adcm

  3. Загрузите Docker-образ из Arenadata Docker Registry на хост, который имеет доступ в Интернет.

    $ sudo docker pull hub.arenadata.io/adcm/adcm:<version>

    где <version> — это версия Docker-образа в одном из следующих форматов:

    • <major>.<minor>.<patch> — если необходим конкретный патч ADCM. Пример: 2.0.0.

    • <major>.<minor> — если необходим последний патч в рамках выбранной версии ADCM. Пример: 2.0.

    ВАЖНО

    • latest использовался для ранних версий ADCM и начиная с версии 2.0.0 больше не поддерживается.

    • До выпуска ADCM 2.0.0 для версионирования использовался следующий формат: YYYY.MM.DD.HH.

  4. Сохраните загруженный Docker-образ в файл с расширением .tar.

    $ sudo docker save -o <file_name> hub.arenadata.io/adcm/adcm:<version>

    где <file_name> — имя создаваемого файла с расширением (например, adcm_2.5.0_arenadata.tar).

    ПРИМЕЧАНИЕ
    Выполнение команды может занять некоторое время. Пожалуйста, дождитесь ее завершения.

  5. Скопируйте сохраненный файл с текущего хоста на хост без доступа к Интернету любым из доступных способов.

    ВАЖНО
    Убедитесь в наличии настроенного доступа к хостам и необходимых прав доступа к файлу.

  6. Загрузите Docker-образ из сохраненного файла.

    $ sudo docker load -i <file_path>

    где <file_path> — абсолютный путь к сохраненному файлу с Docker-образом.

    Пример результата успешного выполнения команды:

    Loaded image: hub.arenadata.io/adcm/adcm:2.5.0

  7. Создайте новый Docker-контейнер на базе загруженного образа:

    $ sudo docker create --name adcm -p 8000:8000 -v /opt/adcm:/adcm/data -e DB_HOST="<DATABASE_HOSTNAME_OR_IP_ADDRESS>" -e DB_PORT="<DATABASE_TCP_PORT>" -e DB_USER="<DATABASE_USERNAME>" -e DB_NAME="<DATABASE_NAME>" -e DB_PASS="<DATABASE_USER_PASSWORD>" -e DB_OPTIONS="<DATABASE_OPTIONS>" hub.arenadata.io/adcm/adcm:<version>
    ПРИМЕЧАНИЕ
    Подробная информация о переменных окружения DB_HOST, DB_PORT, DB_USER, DB_NAME, DB_PASS и DB_OPTIONS приведена в статье Установка.

  8. Запустите новый Docker-контейнер adcm:

    $ sudo docker start adcm
Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней