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

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

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

   Появится папка visiology_3_0, перейдите в неё, выполнив команду:

   Блок кода
   cd visiology_3_0

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

   Блок кода
   ./load_from_release_dockerhub.sh -t 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

• -d
  запуск в debug-режиме, отображает все запущенные команды

• -p <address>
  здесь <address> – адрес сервера, который будет использоваться пользователями платформы для доступа через браузер, значение параметра может быть как IP-адресом, так и доменным именем сервера с установленной платформой, в зависимости от настроек сетевого окружения.

• --https <yes | no>
  здесь параметр --https определяет, работает платформа со схемой HTTPS или HTTP. Для использования HTTPS необходимо указать значение параметра yes. Для использования схемы HTTP необходимо указать значение параметра no или не указывать параметр --https. Обратите внимание, что для работы платформы по https необходимо пройти шаги конфигурирования в разделе "Работа по HTTPS". Одно лишь указание этого флага приведет к недоступности платформы и по http, и по https.

• -v2 <yes | no>
  этот параметр указывает на необходимость одновременной работы и версии 2.xx, и версии 3.0. Для запуска одновременной работы необходимо указать значение параметра yes и пройти шаги конфигурирования в разделе “Одновременная работа версий 2.хх и 3.0”. Для запуска только версии 3.0 указать значение параметра no или не указывать параметр.

• --stop
  запуск команды с этим параметром останавливает всю платформу 3.0.

• --force-pull
  принудительно выкачает новые образы 3.0, если таковые имеются

• --force-regenerate-configs
  удаляет config-файлы и создаёт их заново
  

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

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