Сравнение страниц

Платформа поставляется в виде образов 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 (с которого должна работать платформа). Иначе запуск скрипта /wiki/spaces/v22/pages/2468732097 завершится с ошибкой.
Команда для ручной инициализации 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.0 \ ${UID} $(getent group ${USER} | awk -F: '{print $3}')

   Появится папка visiology_3_0.

5. Зайдите в неё, выполнив команду:
   cd visiology_3_0

6. Запустите скрипт load_from_release_dockerhubimages.sh:

   Блок кода
   ./load_images.sh

   -i ..

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

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

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

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

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

   Блок кода
   language json
   docker login \ --username oauth \ --password <token> \ cr.yandex

   
   где <token> -  токен, полученный из запроса https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fbНа сервере перейдите в скопированную папку с дистрибутивом и сделайте исполняемыми скрипты, выполнив команду:
   sudo chmod +x *.sh

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

   Блок кода
   docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/platform-deployment:3.0

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

   Блок кода
   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}')

5. Запустите скрипт load_from_release_dockerhub.sh с правами суперпользователя:

   Блок кода

   sudo

   ./load_from_release_dockerhub.sh -t 3.0

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

-t 3.0 означает, что скрипту необходимо загрузить образы релиза версии 3.0.

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

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

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

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