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

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

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

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

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

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

   -i ..

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

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

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

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

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

   Image Removed

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

3. На сервере перейдите в скопированную папку с дистрибутивом и сделайте исполняемыми скрипты, выполнив команду:
   

   Image Removed

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

   Image Removed

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

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

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

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

sudo usermod -aG docker $USER && \
newgrp docker

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

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

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

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

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

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

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

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

   Блок кода
   ./load_from_release_dockerhub.sh -t 3.0

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

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

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

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

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

2. Произойдет редирект на 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

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

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