Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.
Информация

В связи с переименованием docker-сущности для 2.30 с visiology на visiology2, при обновлении происходит копирование volume с данными database-backups, loki_data, grafana_data, prometheus_data.

Если эти volume занимают много места (больше 1 Гб), то обновление может занять продолжительное время.

Посмотреть их размер можно с помощью команды docker system df -v | grep visiology

В database-backups хранятся бэкапы сервиса mongodb. Их удаление не приведет ни к каким последствиям.

В loki_data, grafana_data и prometheus_data хранится индексированная история логов и метрик. При их удалении нельзя будет посмотреть историю логов в Grafana до текущего момента. Если вам нужна история логов, удалять эти сервисы нельзя! Но обновление может занять значительное время.

Удалить всё можно следующим образом:

  1. Остановить сервисы:

    Блок кода
    docker service scale visiology_admin=0 && \
    docker service scale visiology_loki=0 && \
    docker service scale visiology_grafana=0 && \
    docker service scale visiology_prometheus=0
  2. Удалить volume с помощью следующей команды:
    docker volume rm visiology_database-backups visiology_loki_data visiology_grafana_data visiology_prometheus_data

  3. Далее можно запустить обновление платформы.

При обновлении платформы необходимо учитывать, какой протокол обмена данными используется на сервере – HTTP или HTTPS.

При использовании HTTP:

панель
panelIconIdatlassian-warning
panelIcon:warning:
bgColor#FFEBE6
Раскрыть
titleОбновление версии 2.2930
Примечание
  • Если предполагается обновление платформы, используя Yandex Container Registry, то копирование файлов дистрибутива не требуется.

  • Перед обновлением важно убедиться, что у пользователя, из-под которого будет происходить обновление, есть все права на выполнение команды docker или производить обновление из-под суперпользователя. Подробнее здесь Общая часть обновления.

Обновление через

Yandex Container Registry

Войдите в Yandex Container Registry:

Блок кода
languagebash
docker login \
   --username oauth \
   --password <token> \
   cr.yandex 

где <token> -  токен, полученный из запроса https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fb

Установите образ обновления:

образы

  1. Скопируйте дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.

  2. На сервере перейдите в скопированную папку с дистрибутивом.

  3. Загрузите образ обновления в память.

    Блок кода
    languagebash
    docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.30_3.1
    Создать новую папку и перейти в неё
    load < update.tar.gz
  4. Запустите обновление. Скрипты запуска появятся в ней.Запустить обновлениетекущей директории.

    Блок кода
    languagebash
    docker run -it \
        -v /var/run/docker.sock:/var/run/docker.sock \
        -v /docker-volume:/docker-volume \
        -v /var/lib/visiology$(pwd):/mnt/visiologyvolume \
        -v $(pwd)$HOME/.docker:/mntroot/volume.docker \
        -v $HOME/home/visio/2.docker30:/root/.dockermnt/old-scripts \
        cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.3031_3.12 \
        -l hub $(pwd) \     $(id -u):$(cut -d: -f3 < <(getent group $(id -gn))) | \
    tee update-log-$(date +%Y-%m-%d-%H-%M-%z).txt
  5. Перейдите в раздел Зaпуск платформы

Обновление через образы

Примечание
  • Если предполагается обновление платформы, используя Yandex Container Registry, то копирование файлов дистрибутива не требуется.

  • Перед обновлением важно убедиться, что у пользователя, из-под которого будет происходить обновление, есть все права на выполнение команды docker или производить обновление из-под суперпользователя. Подробнее здесь Общая часть обновления.

  1. Скопировать дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.

  2. На сервере перейти в скопированную папку с дистрибутивом.

  3. Загрузить образ обновления в память.

    Блок кода
    languagebash
    docker load < update.tar.gz

    Перейти в папку с дистрибутивами и запустить обновление. Скрипты запуска появятся в текущей директории.

    Блок кода
    languagebash
    docker run -it -l local \
        -v /var/run/docker.sock:/var/run/docker.sock \     -v /docker-volume:/docker-volumem all \
        -v /var/lib/visiology:/mnt/visiology \     -v $(pwd):/mnt/volume \
        -v $HOME/.docker:/root/.docker \
        cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.30_3.1 \v2 \
          -l local $(pwd) \
        $(id -u):$(cut -d: -f3 < <(getent group $(id -gn))) | \
    tee update-log-$(date +%Y-%m-%d-%H-%M-%z).txt
  4. Перейдите в раздел Зaпуск платформы

Раскрыть
titleОбновление версий 2.29 и 3.0 одновременно
  1. где в 6 строке нужно заменить /home/visio/2.30 на ваш путь к каталогу с предыдущими скриптами 2.30 и

    в 10 строке выбрать, на какую версию необходимо обновить: -v v2 - обновит на версию 2.31, -v all - обновит на версии 2.31 и 3.2

  2. Перейдите в раздел Зaпуск платформы

Обновление через Yandex Container Registry

  1. Войдите в Yandex Container Registry:

    Блок кода
    languagebash
    docker login \
       --username oauth \
       --password <token> \
       cr.yandex 

    где <token> -  токен, полученный из запроса https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fb

  2. Установите образ обновления:

    Блок кода
    languagebash
    docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.3031_3.12
  3. Создать Создайте новую папку и перейти перейдите в неё. Скрипты запуска появятся в ней.

  4. Запустить Запустите обновление.

    Блок кода
    languagebash
    docker run -it \
        -v /var/run/docker.sock:/var/run/docker.sock \
        -v /docker-volume:/docker-volume \
        -v /var/lib/visiology$(pwd):/mnt/visiologyvolume \
        -v $(pwd)$HOME/.docker:/mntroot/volume.docker \
        -v $HOME/home/visio/2.docker30:/root/.dockermnt/old-scripts \
        cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.3031_3.12 \
        -l hub $(pwd) \     $(id -u):$(cut -d: -f3 < <(getent group $(id -gn))) | \
    tee update-log-$(date +%Y-%m-%d-%H-%M-%z).txt
  5. Перейдите в раздел Зaпуск платформы

Обновление через образы

  1. Скопировать дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.

  2. На сервере перейти в скопированную папку с дистрибутивом.

  3. Загрузить образ обновления в память.

    Блок кода
    languagebash
    docker load < update.tar.gz
  4. Перейти в папку с дистрибутивами и запустить обновление. Скрипты запуска появятся в текущей директории.

    Блок кода
    languagebash
    docker run -it \
        -v /var/run/docker.sock:/var/run/docker.sock \-l hub \
            -v /docker-volume:/docker-volumem all \
    
       -v /var/lib/visiology:/mnt/visiology \     -v $(pwd):/mnt/volumev2 \
        -v $HOME/.docker:/root/.docker \     cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.30_3.1 \
        -l local $(pwd) \
        $(id -u):$(cut -d: -f3 < <(getent group $(id -gn))) | \
    tee update-log-$(date +%Y-%m-%d-%H-%M-%z).txt

    где в 6 строке нужно заменить /home/visio/2.30 на ваш путь к каталогу с предыдущими скриптами 2.30 и

    в 10 строке выбрать, на какую версию необходимо обновить: -v v2 - обновит на версию 2.31, -v all - обновит на версии 2.31 и 3.2

  5. Перейдите в раздел Зaпуск платформы

При использовании HTTPS:

  • Если предполагается обновление платформы, используя Yandex Container Registry, то копирование файлов дистрибутива не требуется.

  • Перед обновлением важно убедиться, что у пользователя, из-под которого будет происходить обновление, есть все права на выполнение команды docker или производить обновление из-под суперпользователя. Подробнее здесь Общая часть обновления.
    1. Скопировать дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.

    2. На сервере перейти в скопированную папку с дистрибутивом.

    3. Загрузить образ обновления в память.

    Раскрыть
    titleОбновление версии версий 2.2930 и 3.1 одновременно
    Примечание
    • Если предполагается обновление платформы, используя Yandex Container Registry, то копирование файлов дистрибутива не требуется.

    • Перед обновлением важно убедиться, что у пользователя, из-под которого будет происходить обновление, есть все права на выполнение команды docker или производить обновление из-под суперпользователя. Подробнее здесь Общая часть обновления.

    Обновление через

    Yandex Container Registry

    Войдите в Yandex Container Registry:

    Блок кода
    languagebash
    docker login \
       --username oauth \
       --password <token> \
       cr.yandex 

    где <token> -  токен, полученный из запроса https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fb

    Установите образ обновления:

    образы

    1. Скопируйте дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.

    2. На сервере перейдите в скопированную папку с дистрибутивом.

    3. Загрузите образ обновления в память.

      Блок кода
      languagebash
      docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.30_3.1
      Создать новую папку и перейти в неё
      load < update.tar.gz
    4. Запустите обновление. Скрипты запуска появятся в ней.Запустить обновлениетекущей директории.

      Блок кода
      languagebash
      docker run -it \
          -v /var/run/docker.sock:/var/run/docker.sock \
          -v /docker-volume:/docker-volume \
          -v /var/lib/visiology$(pwd):/mnt/visiologyvolume \
          -v $HOME/.docker-volume/proxy:/mntroot/certs.docker \
          -v $(pwd):/mnt/volume \
          -v $HOME/.docker:/root/.dockerhome/visio/2.30+3.1:/mnt/old-scripts \
          cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.3031_3.12 \
          -l hub $(pwd)
      \     $(id -u):$(cut -d: -f3l < <(getent group $(id -gn))) | \
      tee update-log-$(date +%Y-%m-%d-%H-%M-%z).txt
    5. Перейдите в раздел Зaпуск платформы

    Обновление через образы

    Примечание
    Блок кода
    languagebash
    docker load < update.tar.gz

    Перейти в папку с дистрибутивами и запустить обновление. Скрипты запуска появятся в текущей директории.

    Блок кода
    languagebash
    docker run -it \local \
            -v /var/run/docker.sock:/var/run/docker.sockm all \
        -v /docker-volume:/docker-volume \     -v /var/lib/visiology:/mnt/visiologyall \
      
     -v /docker-volume/proxy:/mnt/certs \     -v $(pwd):/mnt/volume \
        -v $HOME/.docker:/root/.docker \
        cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.30_3.1 \
        -l local $(pwd) \
        $(id -u):$(cut -d: -f3 < <(getent group $(id -gn))) | \
    tee update-log-$(date +%Y-%m-%d-%H-%M-%z).txt
  • Перейдите в раздел Зaпуск платформы

  • Раскрыть
    titleОбновление версий 2.29 и 3.0 одновременно
    1. где в 6 строке нужно заменить /home/visio/2.30+3.1 на ваш путь к каталогу с предыдущими скриптами 2.30 и 3.1

    2. Перейдите в раздел Зaпуск платформы

    Обновление через Yandex Container Registry

    1. Войдите в Yandex Container Registry:

      Блок кода
      languagebash
      docker login \
         --username oauth \
         --password <token> \
         cr.yandex 

      где <token> -  токен, полученный из запроса https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fb

    2. Установите образ обновления:

      Блок кода
      languagebash
      docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.3031_3.12
    3. Создать Создайте новую папку и перейти перейдите в неё. Скрипты запуска появятся в ней.

    4. Запустить Запустите обновление.

      Блок кода
      languagebash
      docker run -it \
          -v /var/run/docker.sock:/var/run/docker.sock \
          -v /docker-volume:/docker-volume \
          -v /var/lib/visiology:/mnt/visiology \
          -v /home/visio/visio3.0/visiology-certs:/mnt/certs \
          -v $(pwd):/mnt/volume \
          -v $HOME/.docker:/root/.docker \
          cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:-v /home/visio/2.30_+3.1 \
          -l hub $(pwd) :/mnt/old-scripts \
          $(id -u):$(cut -d: -f3 < <(getent group $(id -gn))) | \
      tee update-log-$(date +%Y-%m-%d-%H-%M-%z).txt
      • где вместо /home/visio/visio3.0/visiology-certs в 5 строке укажите ваш каталог с сертификатами 3.0

    5. Перейдите в раздел Зaпуск платформы

    Обновление через образы

    1. Скопировать дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.

    2. На сервере перейти в скопированную папку с дистрибутивом.

    3. Сделать исполняемыми скрипты load_images.sh, load_from_release_dockerhub.sh, run.sh, выполнив команду:

      Блок кода
      languagebash
      sudo chmod +x *.sh

      Загрузить образ обновления в память.

      Блок кода
      languagebash
      docker load < update.tar.gz

      Перейти в папку с дистрибутивами и запустить обновление. Скрипты запуска появятся в текущей директории.

      Блок кода
      languagebash
      docker run -it cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.31_3.2 \
          -v /var/run/docker.sock:/var/run/docker.sock \
          -v /docker-volume:/docker-volumel hub \
       
        -v /var/lib/visiology:/mnt/visiology \     -v /home/visio/visio3.0/visiology-certs:/mnt/certsm all \
          -v $(pwd):/mnt/volume \     -v $HOME/.docker:/root/.dockerall \
          cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:2.30_3.1 \
          -l local $(pwd) \
          $(id -u):$(cut -d: -f3 < <(getent group $(id -gn))) | \
      tee update-log-$(date +%Y-%m-%d-%H-%M-%z).txt

      где

      вместо

      в 6 строке нужно заменить /home/visio/

      visio3.0/visiology-certs в 5 строке укажите ваш каталог с сертификатами 3.0

      2.30+3.1 на ваш путь к каталогу с предыдущими скриптами 2.30 и 3.1

    4. Перейдите в раздел Зaпуск платформы

    (warning) При возникновении неполадок, см. Возможные неполадки и пути их устранения в разделе Настройка HTTPS.