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

Платформа поставляется в виде образов 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

1. Установить Docker в соответствии с инструкцией: Install Docker Engine on Ubuntu.

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

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

3. Установить 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 (с которого должна работать платформа).
Команда для ручной инициализации Docker Swarm:

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

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

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

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

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

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

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

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

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

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

   ./load_images.sh

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

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

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

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

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

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

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

   docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/platform-deployment:3.1

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

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

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

   ./load_from_release_dockerhub.sh -t 3.1

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

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

1. Запустите скрипт run.sh с указанием IP-адреса, где <IP> - IP-адрес или домен вашего сервера:
   ./run.sh -p <IP>

2. Подождите, пока загрузится KeyCloak.

3. Введите в адресной строке браузера следующий URL:
   <IP>/v3

4. Произойдет редирект на KeyCloak.

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

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

Перезапуск платформы

Для перезапуска платформы необходимо сначала остановить платформу:

./run.sh --stop

и затем запустить заново со всеми необходимыми параметрами:

./run.sh -p <address> --https <yes | no> -v2 <yes | no>

Дополнительные параметры в run.sh

Список всех доступных параметров можно узнать, запустив следующую команду:

./run.sh -h

Работа без авторизации

Для отключения авторизации необходимо в скрипте run.sh изменить значение параметра USE_AUTHORIZATION с true на false и перезапустить платформу.

sed -i 's|USE_AUTHORIZATION=true|USE_AUTHORIZATION=false|g' run.sh

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

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