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

Owned by Эдуард Столяр, created
Last updated: мая 12, 2023 by Денис Лихачев
2 min read

Платформа поставляется в виде образов Docker, содержащих в себе все компоненты с уже настроенным окружением и всеми внутренними зависимостями.

Примечание: Docker — программное обеспечение для автоматизации развёртывания и управления приложениями в среде виртуализации на уровне операционной системы. Суть и одно из предназначений Docker такое же, как и у виртуальных машин — это изоляция работы различных конфликтующих программ внутри одного сервера. Наглядно увидеть отличия между виртуальной машиной и контейнером можно, пройдя по ссылке: What is a Container?

Таким образом, установка платформы сводится к четырем шагам:

  1. Установка Docker Engine и Docker Compose внутри Ubuntu Linux.

  2. Загрузка образов в среду Docker.

  3. Подготовка скриптов.

  4. Запуск готовых Docker сервисов с компонентами платформы с помощью скрипта. В любом варианте развертывания используется режим Docker Swarm и Docker сервисы (а не просто контейнеры). Для подробной информации см. https://docs.docker.com/engine/swarm/key-concepts.

Установка и настройка Docker

Проверьте версию Docker. Проверить версию Docker можно следующими командами:

docker --version docker compose --version

Для обновления Docker необходимо выполнить секцию Upgrade Docker Engine на странице Install Docker Engine on Ubuntu.

Если в системе присутствует два и более активных сетевых интерфейса (например, один для корпоративной внутренней сети, а второй для выхода в Интернет), то может потребоваться дополнительно инициализировать Docker Swarm и указать желаемый IP (с которого должна работать платформа).
Команда для ручной инициализации Docker Swarm:

docker swarm init --advertise-addr <ip address>

Установка через образы

Шаги установки

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

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

  • Загрузите образ platform-deployment.tar.gz в память Docker:

    docker load < images/platform-deployment.tar.gz

  • Запустите контейнер развёртки, который создаст скрипты в текущем каталоге:

    docker run -it --rm \ -u $(id -u):$(id -g) \ -v "$(pwd)":/mnt/volume \ -v /var/lib/visiology/certs:/mnt/visiology/certs \ -v /var/lib/visiology/v3/dashboard-viewer/customjs:/mnt/visiology/dashboard-viewer/customjs \ cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/platform-deployment:2.31_3.2

    в случае установки версии 2.31.1 необходимо в 6 строке заменить 2.31_3.2 на 2.31.1_3.2

  • Запустите скрипт load_images.sh:

При необходимости установить две версии одновременно (2.31 и 3.2), выполните следующую команду:

./load_images.sh --version all

Чтобы узнать, как установить версию 2.31 отдельно, см. раздел https://visiology-doc.atlassian.net/wiki/spaces/v31/pages/65339426.

Установка через Yandex Container Registry

  • Данный вариант установки возможен только после предоставления доступа к регистру. Поэтому пользоваться в большинстве случаев нужно вариантом выше (когда образы уже скачаны вместе с дистрибутивом в папке images).

 Шаги установки

  • Создайте новый каталог XXX (любое произвольное название) и перейдите в него - в нём будут находиться скрипты для запуска платформы.

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

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

  • Выполните следующую команду:

в случае установки версии 2.31.1 необходимо заменить 2.31_3.2 на 2.31.1_3.2

  • Запустите контейнер развёртки, который создаст скрипты в текущем каталоге:

в случае установки версии 2.31.1 необходимо в 6 строке заменить 2.31_3.2 на 2.31.1_3.2

  • Запустите скрипт load_from_release_dockerhub.sh:

Смотрите также

Запуск платформы