Установка основной части платформы
Содержимое дистрибутива из поставки кроме файлов images/viqube.tar.gz, images/data-collection-db.tar.gz, images/data-collection-app.tar.gz скопировать на основной сервер, сохраняя структуру вложенных элементов.
Предупреждение Если предполагается обновление платформы, используя Yandex Container Registry, копировать папку images дистрибутива не требуется.
- На сервере перейти в скопированную папку с дистрибутивом
Сделать исполняемыми скрипты load_images.sh, load_from_release_dockerhub.sh, run.sh, update.sh, выполнив команду:
Блок кода language bash theme RDark sudo chmod +x *.sh
- Установка
Для локальной установки:
на основном сервере перейти в скопированную папку с дистрибутивом и запустить скрипт load_images.sh с правами суперпользователя:
Блок кода language bash theme RDark sudo ./load_images.sh -m dashboard_server
Примечание - -m dashboard_server
-with-dashboard-server yes --with-viqube no --with-data-collection no
Примечание Установка с указанными параметрами означает, что на данном сервере будут установлены компоненты платформы кроме ViQube и Data-Collection
Для установки из Yandex Container Registry:
Предупреждение Перед запуском скрипта необходимо авторизоваться в Yandex Container Registry, используя следующую команду:
Блок кода language bash theme RDark 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 с правами суперпользователя:
Блок кода language bash theme RDark title Установка версии 2.21 sudo ./load_from_release_dockerhub.sh -t 2.21 -m dashboard_server
Примечание - -m dashboard_server
--with-dashboard-server yes --with-viqube no --with-data-collection no
Примечание Установка с указанными параметрами означает, что на данном сервере будут установлены компоненты платформы кроме ViQube и Data-Collection - -t 2.21
здесь -t 2.21 означает, что скрипту необходимо загрузить образы релиза версии 2.21
Настроить сервер с основной частью платформы
Выполнить инициализацию сервера
Блок кода language bash theme RDark docker swarm init
Информация Требудется сохранить вывод этой команды, он потребуется для установки ViQube и Data-Collection на отдельных серверах
- Настроить метки
Выполнить
Блок кода language bash theme RDark docker node ls
- В строчке со звёздочкой указан айдишник "мастер" ноды. Его необходимо сохранить для дальнейших пунктов.
Выполнить
Блок кода language bash theme RDark 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 на отдельный сервер
Содержимое дистрибутива из поставки скопировать на сервер Data Colection- из папки images необходимо скопировать файлы data-collection-app.tar.gz, data-collection-db.tar.gz, promtail.tar.gz - сохраняя структуру вложенных элементов
Предупреждение Если предполагается обновление платформы, используя Yandex Container Registry, копировать папку images дистрибутива не требуется.
- На сервере перейти в скопированную папку с дистрибутивом
Сделать исполняемыми скрипты load_images.sh, load_from_release_dockerhub.sh, run.sh, update.sh, выполнив команду:
Блок кода language bash theme RDark sudo chmod +x *.sh
- Установка
Для локальной установки:
на основном На сервере Data-Collection перейти в скопированную папку с дистрибутивом и запустить скрипт load_images.sh с правами суперпользователя:
Блок кода language bash theme RDark sudo ./load_images.sh --with-m data-collection
Примечание - -m data-collection
yes --with-dashboard-server no --with-viqube no
Примечание Установка с указанными параметрами означает, что на данном сервере будут установлены только компоненты Data-Collection Для установки из Yandex Container Registry:
Предупреждение Перед запуском скрипта необходимо авторизоваться в Yandex Container Registry, используя следующую команду:
Блок кода language bash theme RDark sudo docker login \ --username oauth \ --password <token> \ cr.yandex
где <token> - токен, полученный из запроса
https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fbна основном сервере перейти На сервере Data-Collection перейти в скопированную папку с дистрибутивом и запустить скрипт load_from_release_dockerhub.sh с правами суперпользователя:
Блок кода language bash theme RDark title Установка версии 2.21 sudo ./load_from_release_dockerhub.sh -t 2.21 -m -with-data-collection
Примечание - -m data-collection
yes --with-dashboard-server no --with-viqube no
Примечание Установка с указанными параметрами означает, что на данном сервере будут установлены только компоненты Data-Collection - -t 2.21
здесь -t 2.21 означает, что скрипту необходимо загрузить образы релиза версии 2.21
- -m data-collection
- Настроить сервер с Data Collection
На сервере с основной частью платформы выполнить
Блок кода language bash theme RDark docker swarm join-token worker
если команда вернула ошибку, то выполнить команду ниже и повторить предыдущую
Блок кода language bash theme RDark docker swarm init --force-new-cluster
Из вывода сохранить строчку вида "docker swarm join --token <TOKEN> <IP>"
- На сервере Data Collection выполнить сохранённую команду из предыдущего пункта
- Добавить метку для сервера с Data Collection
На основном сервере выполнить
Блок кода language bash theme RDark docker node ls
- В выводе должны быть несколько нод. В строчке со звёздочкой указан айдишник "мастер" ноды, в других "воркер" ноды, на которые можно установить Data Collection.
Выполнить
Блок кода language bash theme RDark 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)
Создать необходимые папки на сервере Data Collection:
Блок кода language bash theme RDark sudo mkdir -p /docker-volume/data-collection && \ sudo mkdir -p /docker-volume/data-collection/postgresql && \ sudo mkdir -p /docker-volume/proxy/proxy.crt
Выполнить Запуск платформы
Предупреждение В параметры запуска run.sh необходимо выставить ключ --remote-dc yes
Установка ViQube на отдельный сервер
Содержимое дистрибутива из поставки скопировать на сервер ViQube - из папки images необходимо скопировать только файл viqube.tar.gz, promtail.tar.gz - сохраняя структуру вложенных элементов
Предупреждение Если предполагается обновление платформы, используя Yandex Container Registry, копировать папку images дистрибутива не требуется.
- На сервере перейти в скопированную папку с дистрибутивом
Сделать исполняемыми скрипты load_images.sh, load_from_release_dockerhub.sh, run.sh, update.sh, выполнив команду:
Блок кода language bash theme RDark sudo chmod +x *.sh
- Установка
Для локальной установки:
на сервере ViQube перейти в скопированную папку с дистрибутивом и запустить скрипт load_images.sh с правами суперпользователя:
Блок кода language bash theme RDark sudo ./load_images.sh -m viqube
Примечание - -m viqube
sh --with-viqube yes --with-dashboard-server no --with-data-collection no
Примечание Установка с указанными параметрами означает, что на данном сервере будет установлен будут установлены только компонент компоненты ViQube Для установки из Yandex Container Registry:
Предупреждение Перед запуском скрипта необходимо авторизоваться в Yandex Container Registry, используя следующую команду:
Блок кода language bash theme RDark 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 с правами суперпользователя:
Блок кода language bash theme RDark title Установка версии 2.21 sudo ./load_from_release_dockerhub.sh -t 2.21 --with-viqube yes --with-dashboard-server -m viqube
Примечание - -m viqube
no --with-data-collection no
Примечание Установка с указанными параметрами означает, что на данном сервере будет установлен будут установлены только компонент компоненты ViQube - -t 2.21
здесь -t 2.21 означает, что скрипту необходимо загрузить образы релиза версии 2.21
- -m viqube
- Настроить сервер с ViQube
На сервере с основной частью платформы выполнить
Блок кода language bash theme RDark docker swarm join-token worker
если команда вернула ошибку, то выполнить команду ниже и повторить предыдущую
Блок кода language bash theme RDark docker swarm init --force-new-cluster
Из вывода сохранить строчку вида "docker swarm join --token <TOKEN> <IP>"
- На сервере ViQube выполнить сохранённую команду из предыдущего пункта
- Добавить метку для сервера с ViQube
На основном сервере выполнить
Блок кода language bash theme RDark docker node ls
- В выводе должны быть несколько нод. В строчке со звёздочкой указан айдишник "мастер" ноды, в других "воркер" ноды, на которые можно установить ViQube.
Выполнить
Блок кода language bash theme RDark 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)
Создать необходимые папки на сервере ViQube:
Блок кода language bash theme RDark 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
Выполнить Запуск платформы
Предупреждение В параметры запуска run.sh необходимо выставить ключ --remote-viqube yes