Установка компонентов на разные серверы

Установка основной части платформы

1. Содержимое дистрибутива из поставки кроме файлов /images/viqube.tar.gz, /images/data-collection-db.tar.gz, /images/data-collection-app.tar.gz скопировать на основной сервер, сохраняя структуру вложенных элементов.

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

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

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

   sudo chmod +x *.sh

4. Установка

   1. Для локальной установки:

      на основном сервере перейти в скопированную папку с дистрибутивом и запустить скрипт load_images.sh с правами суперпользователя:

      sudo ./load_images.sh -m platform

      • -m platform

      здесь параметр -m platform означает, что на данном сервере будут установлены компоненты платформы кроме ViQube и Data-Collection

   2. Для установки из Yandex Container Registry:

      Перед запуском скрипта необходимо авторизоваться в Yandex Container Registry, используя следующую команду:

      sudo docker login \
               --username oauth \
               --password <token> \
               cr.yandex

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

      на основном сервере перейти в скопированную папку с дистрибутивом и запустить скрипт load_from_release_dockerhub.sh с правами суперпользователя:

      Установка версии 2.21

      sudo ./load_from_release_dockerhub.sh -t 2.21 -m platform

      • -m platform

      здесь параметр -m platform означает, что на данном сервере установлены компоненты платформы кроме ViQube

      • -t 2.21

      здесь -t 2.21 означает, что скрипту необходимо загрузить образы релиза версии 2.21

5. Настроить сервер с основной частью платформы

   1. Выполнить инициализацию сервера

      docker swarm init

      Требудется сохранить вывод этой команды, он потребуется для установки ViQube и Data-Collection на отдельных серверах

   2. Настроить метки

      1. Выполнить

         docker node ls

      2. В строчке со звёздочкой указан айдишник "мастер" ноды. Его необходимо сохранить для дальнейших пунктов.

      3. Выполнить

         docker node update --label-add platform=true <master_node_id>
         docker node update --label-add nginx=true <master_node_id>

         <master_node_id> - айдишник "мастер" ноды

Установка Data Collection на отдельный сервер

1. Содержимое дистрибутива из поставки скопировать на сервер Data Colection- из папки images необходимо скопировать только файл viqube.tar.gz - сохраняя структуру вложенных элементов

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

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

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

   sudo chmod +x *.sh

4.  Установка

   1. Для локальной установки:

      на основном сервере перейти в скопированную папку с дистрибутивом и запустить скрипт load_images.sh с правами суперпользователя:

      sudo ./load_images.sh -m data-collection

      • -m data-collection

      здесь параметр -m data-collection означает, что на данном сервере будут установлены только компоненты Data Collection
      

   2. Для установки из Yandex Container Registry:

      Перед запуском скрипта необходимо авторизоваться в Yandex Container Registry, используя следующую команду:

      sudo docker login \
               --username oauth \
               --password <token> \
               cr.yandex

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

      на основном сервере перейти в скопированную папку с дистрибутивом и запустить скрипт load_from_release_dockerhub.sh с правами суперпользователя:

      Установка версии 2.21

      sudo ./load_from_release_dockerhub.sh -t 2.21 -m data-collection

      • -m data-collection
        

      здесь параметр -m data-collection означает, что на данном сервере будут установлены только компоненты Data Collection
      

      • -t 2.21

      здесь -t 2.21 означает, что скрипту необходимо загрузить образы релиза версии 2.21

5. Настроить сервер с Data Collection
   

   1. На сервере с основной частью платформы выполнить

      docker swarm join-token worker

      если команда вернула ошибку, то выполнить команду ниже и повторить предыдущую

      docker swarm init --force-new-cluster

      Из вывода сохранить строчку вида "docker swarm join --token <TOKEN> <IP>"

   2. На сервере Data Collection выполнить сохранённую команду из предыдущего пункта
6. Добавить метку для сервера с Data Collection
   

   1. На основном сервере выполнить

      docker node ls

   2. В выводе должны быть несколько нод. В строчке со звёздочкой указан айдишник "мастер" ноды, в других "воркер" ноды, на которые можно установить Data Collection.

   3. Выполнить

      docker node update --label-add data-collection=true <worker_node_id>

      <worker_node_id> - айдишник нужной "воркер" ноды

      Для более подробного вывода по "воркер" нодам, можно воспользоваться:

      docker inspect -f "{{.ID}} {{.Status.Addr}} {{.Spec.Labels}}" $(docker node ls -q)

7. Создать необходимые папки на сервере Data Collection:

   sudo mkdir -p /docker-volume/data-collection && \
   sudo mkdir -p /docker-volume/data-collection/postgresql && \
   sudo mkdir -p /docker-volume/proxy/proxy.crt

8. Выполнить Запуск платформы

   В параметры запуска run.sh необходимо выставить ключ --remote-dc yes

Установка ViQube на отдельный сервер

1. Содержимое дистрибутива из поставки скопировать на сервер ViQube - из папки images необходимо скопировать только файл viqube.tar.gz - сохраняя структуру вложенных элементов

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

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

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

   sudo chmod +x *.sh

4.  Установка

   1. Для локальной установки:

      на сервере ViQube перейти в скопированную папку с дистрибутивом и запустить скрипт load_images.sh с правами суперпользователя:

      sudo ./load_images.sh -m viqube

      • -m viqube

      здесь параметр -m viqube означает, что на данном сервере будет установлен только компонент ViQube

   2. Для установки из Yandex Container Registry:

      Перед запуском скрипта необходимо авторизоваться в Yandex Container Registry, используя следующую команду:

      sudo docker login \
               --username oauth \
               --password <token> \
               cr.yandex

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

      на сервере ViQube перейти в скопированную папку с дистрибутивом и запустить скрипт load_from_release_dockerhub.sh с правами суперпользователя:

      Установка версии 2.21

      sudo ./load_from_release_dockerhub.sh -t 2.21 -m viqube

      • -m viqube
        

      здесь параметр -m viqube означает, что на данном сервере будет установлен только компонент ViQube

      • -t 2.21

      здесь -t 2.21 означает, что скрипту необходимо загрузить образы релиза версии 2.21

5. Настроить сервер с ViQube
   

   1. На сервере с основной частью платформы выполнить

      docker swarm join-token worker

      если команда вернула ошибку, то выполнить команду ниже и повторить предыдущую

      docker swarm init --force-new-cluster

      Из вывода сохранить строчку вида "docker swarm join --token <TOKEN> <IP>"

   2. На сервере ViQube выполнить сохранённую команду из предыдущего пункта
6. Добавить метку для сервера с ViQube
   

   1. На основном сервере выполнить

      docker node ls

   2. В выводе должны быть несколько нод. В строчке со звёздочкой указан айдишник "мастер" ноды, в других "воркер" ноды, на которые можно установить ViQube.

   3. Выполнить

      docker node update --label-add viqube-master=true <worker_node_id>

      <worker_node_id> - айдишник нужной "воркер" ноды

      Для более подробного вывода по "воркер" нодам, можно воспользоваться:

      docker inspect -f "{{.ID}} {{.Status.Addr}} {{.Spec.Labels}}" $(docker node ls -q)

7. Создать необходимые папки на сервере ViQube:

   sudo mkdir -p /docker-volume/viqube/config && \
   sudo mkdir -p /docker-volume/viqube/apiLog && \
   sudo mkdir -p /docker-volume/viqube/crashdumps && \
   sudo mkdir -p /docker-volume/viqube/drivers && \
   sudo mkdir -p /docker-volume/viqube/log && \
   sudo mkdir -p /docker-volume/viqube/snapshots && \
   sudo mkdir -p /docker-volume/viqube/storage

8. Выполнить Запуск платформы

   В параметры запуска run.sh необходимо выставить ключ --remote-viqube yes