Сравнение версий
Ключ
- Эта строка добавлена.
- Эта строка удалена.
- Изменено форматирование.
Платформа поставляется в виде образов 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 < images/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}')
Запустите скрипт
load_images.sh
:Блок кода ./load_images.sh
Установка через Yandex Container Registry
Примечание |
---|
Данный вариант установки возможен только после предоставления доступа к регистру. Поэтому пользоваться в большинстве случаев нужно вариантом выше (когда образы уже скачаны вместе с дистрибутивом в папке |
Шаги установки
Создайте новый каталог XXX (любое произвольное название) и перейдите в него - в нём появятся скрипты для запуска платформы.
Войдите в 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Выполните следующую команду:
Блок кода 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}')
Запустите скрипт
load_from_release_dockerhub.sh
:Блок кода ./load_from_release_dockerhub.sh -t 3.0
Запуск платформы
Примечание |
---|
В случае использования внешнего реверс-прокси в инфраструктуре клиента, перед первым запуском платформы необходимо закомментировать две строки в файле <distrib>/configs/nginx.conf : |
Для запуска платформы выполните следующие шаги:
Запустите скрипт
run.sh
с указанием IP-адреса, где<IP>
- IP-адрес или домен вашего сервера:./run.sh -p <IP>
Подождите, пока загрузится KeyCloak.
Введите в адресной строке браузера следующий URL:
<IP>/v3
Произойдет редирект на 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> |
Здесь |
. Значение параметра может быть как IP-адресом, так и доменным именем сервера с установленной платформой, в зависимости от настроек сетевого окружения. |
--https <yes | no> |
Здесь параметр |
HTTPS необходимо пройти шаги конфигурирования в разделе |
. Одно лишь указание этого флага приведет к недоступности платформы и по |
HTTP, и по |
HTTPS. |
-v2 <yes | no> |
Этот параметр указывает на необходимость одновременной работы и версии 2.xx, и версии 3.0. Для запуска одновременной работы необходимо пройти шаги конфигурирования в разделе |
0 и указать значение параметра yes. Для запуска только версии 3.0 указать значение параметра no, или не указывать параметр. |
--stop |
Запуск команды с этим параметром останавливает всю платформу 3.0. |
--force-pull |
Принудительно выкачивает новые образы 3.0, если таковые имеются. |
--force-regenerate-configs |
Удаляет config-файлы и создаёт их заново. |
Работа без авторизации
Для отключения авторизации необходимо в скрипте run.sh
изменить значение параметра USE_AUTHORIZATION
с true
на false
и перезапустить платформу.
Блок кода |
---|
sed -i 's|USE_AUTHORIZATION=true|USE_AUTHORIZATION=false|g' run.sh |
Смотрите также
На этой странице
Оглавление |
---|
🕑 Время чтения: 3 мин.
Нужна дополнительная помощь?