Разворачивание платформы

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

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

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

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

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

Установить Docker в соответствии с инструкцией: Install Docker Engine on Ubuntu.
Версия должна быть не ниже 19.03.0.
Сделать настройку Docker по инструкции: Post-installation steps for Linux.
Установить Docker Compose.
Установка версии 1.29.2:
```
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
```
Версия должна быть не ниже 1.26.2 и не выше 1.29.2.
Проверьте версию Docker. Проверить версию Docker можно следующими командами:
```
docker --version
docker-compose --version
```
Для обновления Docker необходимо выполнить секцию Upgrade Docker Engine на странице Install Docker Engine on Ubuntu.

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

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

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

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

Скопируйте дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.
На сервере перейдите в скопированную папку с дистрибутивом.
Загрузите образ platform-deployment.tar.gz в память Docker:
```
docker load < platform-deployment.tar.gz
```

Запустите контейнер развёртки:

docker run -it --rm -v $(pwd):/mnt/volume \
cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/platform-deployment:3.0 \
${UID} $(getent group ${USER} | awk -F: '{print $3}')

Появится папка visiology_3_0.
Зайдите в неё, выполнив команду:
cd visiology_3_0
Запустите скрипт load_from_release_dockerhub.sh:
./load_images.sh -i ..

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

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

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

Скопируйте дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.
Если предполагается установка платформы, используя Yandex Container Registry, копировать папку images дистрибутива не требуется.
Войдите в 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:3.0

Запустите контейнер развёртки:

docker run -it --rm -v $(pwd):/mnt/volume \
cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/platform-deployment:3.0 \
${UID} $(getent group ${USER} | awk -F: '{print $3}')

Появится папка visiology_3_0, перейдите в неё, выполнив команду:
```
cd visiology_3_0
```
Запустите скрипт load_from_release_dockerhub.sh:
```
./load_from_release_dockerhub.sh -t 3.0
```

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

Для запуска платформы выполните следующие шаги:

Запустите скрипт run.sh с правами суперпользователя и с указанием IP-адреса, где <IP> - IP-адрес или домен вашего сервера:
./run.sh -p <IP>
Подождите, пока загрузится KeyCloak.
Введите в адресной строке браузера следующий URL:
<IP>/v3
Произойдет редирект на KeyCloak.

Для авторизации необходимо использовать следующие данные:

логин – user
пароль – 123456.

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

📄 Системные требования

На этой странице

🕑 Время чтения: 3 мин.

Нужна дополнительная помощь?

Свяжитесь с технической поддержкой.