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

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

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

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 в соответствии с инструкцией: Install Docker Engine on Ubuntu.

  Версия должна быть не ниже 20.10.13.

• Выполнить настройку Docker по инструкции: Post-installation steps for Linux.

• Установить Docker Compose.
  Версия должна быть не ниже 2.10.2

Проверьте версию 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>

Подготовка системы

Важно! Шаги, описанные ниже, должны быть выполнены обязательно!

• Залогиньтесь в систему от имени пользователя, который будет запускать скрипты платформы (убедитесь, что пользователь имеет права на запуск докер контейнеров)

• Создайте папки и установите на них права пользователя

  sudo mkdir -p \
    /var/lib/visiology/scripts \
    /var/lib/visiology/certs \
    /var/lib/visiology/v3/dashboard-viewer/customjs && \
  sudo chown -R "$(id -u):$(id -g)" /var/lib/visiology

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

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

• Выполните шаги из раздела Подготовка системы

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

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

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

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

• Запустите контейнер развёртки, который создаст скрипты в каталоге /var/lib/visiology/scripts/:

  docker run -it --rm \
    -u "$(id -u):$(id -g)" \
    -v /etc/passwd:/etc/passwd:ro \
    -v /var/lib/visiology:/mnt/volume \
    cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/platform-deployment:2.33_3.4

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

  /var/lib/visiology/scripts/load_images.sh --version v2 -i <path_to_distrib>/images

  где path_to_distrib - абсолютный путь к дистрибутиву платформы

• Перейдите к разделу Подготовка к запуску

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

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

• Выполните шаги из раздела Подготовка системы

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

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

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

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

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

• docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/platform-deployment:2.33_3.4

• Запустите контейнер развёртки, который создаст скрипты в каталоге /var/lib/visiology/scripts/:

  docker run -it --rm \
    -u "$(id -u):$(id -g)" \
    -v /etc/passwd:/etc/passwd:ro \
    -v /var/lib/visiology:/mnt/volume \
    cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/platform-deployment:2.33_3.4

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

  /var/lib/visiology/scripts/load_from_release_dockerhub.sh --version v2

• Перейдите к разделу Подготовка к запуску

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

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