{"type":"doc","content":[{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"paragraph","content":[{"text":"Платформа ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"76670ad4-1f29-401f-b2a5-bf7d4d15df90"}}]},{"text":"поставляется в виде образов Docker, содержащих в себе все компоненты с уже настроенным окружением и всеми внутренними зависимостями.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Примечание: Docker — программное обеспечение для автоматизации развёртывания и управления приложениями в среде виртуализации на уровне операционной системы. Суть и одно из предназначений Docker такое же, как и у виртуальных машин — это изоляция работы различных конфликтующих программ внутри одного сервера. Наглядно увидеть отличия между виртуальной машиной и контейнером можно, пройдя по ссылке: ","type":"text"},{"text":"What is a Container?","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.docker.com/what-docker"}}]},{"text":" ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Таким образом, установка платформы сводится к четырем шагам:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Установка ","type":"text"},{"text":"Docker Engine","type":"text","marks":[{"type":"strong"}]},{"text":" и ","type":"text"},{"text":"Docker Compose","type":"text","marks":[{"type":"strong"}]},{"text":" внутри ","type":"text"},{"text":"Ubuntu Linux","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Загрузка образов в среду Docker.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Подготовка скриптов.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Запуск готовых Docker сервисов с компонентами платформы с помощью скрипта. В любом варианте развертывания используется режим ","type":"text"},{"text":"Docker Swarm","type":"text","marks":[{"type":"strong"}]},{"text":" и Docker сервисы (а не просто контейнеры). Для подробной информации см. ","type":"text"},{"text":"https://docs.docker.com/engine/swarm/key-concepts","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.docker.com/engine/swarm/key-concepts/"}}]},{"text":".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Установка и настройка Docker","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Установить ","type":"text"},{"text":"Docker","type":"text","marks":[{"type":"strong"}]},{"text":" в соответствии с инструкцией: ","type":"text"},{"text":"Install Docker Engine on Ubuntu","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.docker.com/install/linux/docker-ce/ubuntu/"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-warning","text":":warning:","shortName":":warning:"}},{"text":" Версия должна быть не ниже 19.03.0.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Выполнить настройку Docker по инструкции: ","type":"text"},{"text":"Post-installation steps for Linux","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.docker.com/engine/install/linux-postinstall/"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Установить ","type":"text"},{"text":"Docker Compose","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"Установка версии 1.29.2","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"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\nsudo chmod +x /usr/local/bin/docker-compose","type":"text"}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-warning","text":":warning:","shortName":":warning:"}},{"text":" Версия должна ","type":"text"},{"text":"быть ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"d7635194-8657-48f5-b3b1-387d8adcdce1"}}]},{"text":"не ниже 1.26.2 и не выше 1.29.2.","type":"text"}]},{"type":"paragraph","content":[{"text":"Проверьте версию Docker. Проверить версию Docker можно следующими командами:","type":"text"}]},{"type":"codeBlock","content":[{"text":"docker --version\ndocker-compose --version","type":"text"}]},{"type":"paragraph","content":[{"text":"Для обновления Docker необходимо выполнить секцию ","type":"text"},{"text":"Upgrade Docker Engine ","type":"text","marks":[{"type":"strong"}]},{"text":"на странице ","type":"text"},{"text":"Install Docker Engine on Ubuntu","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository"}}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-info","text":":info:","shortName":":info:"}},{"text":" Если в системе присутствует два и более активных сетевых интерфейса (например, один для корпоративной внутренней сети, а второй для выхода в Интернет), то может потребоваться дополнительно инициализировать ","type":"text"},{"text":"Docker Swarm","type":"text","marks":[{"type":"strong"}]},{"text":" и указать желаемый IP (с которого должна работать платформа).","type":"text"},{"type":"hardBreak"},{"text":"Команда для ручной инициализации ","type":"text"},{"text":"Docker Swarm","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"paragraph","content":[{"text":"docker swarm init --advertise-addr ","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Установка через образы","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Шаги установки","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Скопируйте дистрибутив платформы на сервер, сохраняя структуру вложенных элементов.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"На сервере перейдите в скопированную папку с дистрибутивом.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Загрузите образ ","type":"text"},{"text":"platform-deployment.tar.gz","type":"text","marks":[{"type":"code"}]},{"text":" в память Docker:","type":"text"}]},{"type":"codeBlock","content":[{"text":"docker load < images/platform-deployment.tar.gz","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Запустите контейнер развёртки, который создаст скрипты в текущем каталоге:","type":"text"}]},{"type":"codeBlock","content":[{"text":"docker run -it --rm -v $(pwd):/mnt/volume \\\ncr.yandex/crpe1mi33uplrq7coc9d/visiology/release/platform-deployment:3.0 \\\n${UID} $(getent group ${USER} | awk -F: '{print $3}')","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Запустите скрипт ","type":"text"},{"text":"load_images.sh","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"./load_images.sh","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Установка через Yandex Container Registry","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Данный вариант установки возможен только после предоставления доступа к регистру. Поэтому пользоваться в большинстве случаев нужно вариантом выше (когда образы уже скачаны вместе с дистрибутивом в папке ","type":"text"},{"text":"images","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":" Шаги установки","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Создайте новый каталог XXX (любое произвольное название) и перейдите в него - в нём появятся скрипты для запуска платформы.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Войдите в Yandex Container Registry:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"docker login \\\n --username oauth \\\n --password \\\n cr.yandex","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"где ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" - токен, полученный из запроса ","type":"text"},{"text":"https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fb","type":"text","marks":[{"type":"link","attrs":{"href":"https://oauth.yandex.ru/authorize?response_type=token&client_id=1a6990aa636648e9b2ef855fa7bec2fb"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Выполните следующую команду:","type":"text"}]},{"type":"codeBlock","content":[{"text":"docker pull cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/platform-deployment:3.0","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Запустите контейнер развёртки, который создаст скрипты в текущем каталоге:","type":"text"}]},{"type":"codeBlock","content":[{"text":"docker run -it --rm -v $(pwd):/mnt/volume \\\ncr.yandex/crpe1mi33uplrq7coc9d/visiology/release/platform-deployment:3.0 \\\n${UID} $(getent group ${USER} | awk -F: '{print $3}')","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Запустите скрипт ","type":"text"},{"text":"load_from_release_dockerhub.sh","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"codeBlock","content":[{"text":"./load_from_release_dockerhub.sh -t 3.0","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Запуск платформы","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"В случае использования внешнего реверс-прокси в инфраструктуре клиента, перед первым запуском платформы необходимо закомментировать две строки в файле ","type":"text"},{"text":"/configs/nginx.conf ","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"},{"type":"hardBreak"},{"text":"#proxy_set_header X-Forwarded-Proto $scheme;","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"#proxy_set_header X-Scheme $scheme; ","type":"text","marks":[{"type":"code"}]}]}]},{"type":"paragraph","content":[{"text":"Для запуска платформы выполните следующие шаги:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Запустите скрипт ","type":"text"},{"text":"run.sh","type":"text","marks":[{"type":"code"}]},{"text":" с указанием IP-адреса, где ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" - IP-адрес или домен вашего сервера:","type":"text"},{"type":"hardBreak"},{"text":"./run.sh -p ","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Подождите, пока загрузится KeyCloak.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Введите в адресной строке браузера следующий URL:","type":"text"},{"type":"hardBreak"},{"text":"/v3","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Произойдет редирект на KeyCloak.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Для авторизации необходимо использовать следующие данные:","type":"text"}]},{"type":"paragraph","content":[{"text":"логин","type":"text","marks":[{"type":"strong"}]},{"text":" – ","type":"text"},{"text":"user","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"пароль ","type":"text","marks":[{"type":"strong"}]},{"text":"– ","type":"text"},{"text":"123456","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Перезапуск платформы","type":"text"}]},{"type":"paragraph","content":[{"text":"Для перезапуска платформы необходимо сначала остановить платформу:","type":"text"}]},{"type":"codeBlock","content":[{"text":"./run.sh --stop","type":"text"}]},{"type":"paragraph","content":[{"text":"и затем запустить заново со всеми необходимыми параметрами:","type":"text"}]},{"type":"codeBlock","content":[{"text":"./run.sh -p

--https -v2 ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Дополнительные параметры в run.sh","type":"text"}]},{"type":"paragraph","content":[{"text":"Список всех доступных параметров можно узнать, запустив следующую команду:","type":"text"}]},{"type":"codeBlock","content":[{"text":"./run.sh -h","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"9bc03a5e-5430-406a-89c0-358a4a641672"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Параметр","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[757.0]},"content":[{"type":"paragraph","content":[{"text":"Описание","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"-d","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[757.0]},"content":[{"type":"paragraph","content":[{"text":"Запуск в debug-режиме, отображает все запущенные команды.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"-p","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"

","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[757.0]},"content":[{"type":"paragraph","content":[{"text":"Здесь ","type":"text"},{"text":"

","type":"text","marks":[{"type":"code"}]},{"text":" – адрес сервера, который будет использоваться пользователями платформы для доступа через браузер. Значение параметра может быть как IP-адресом, так и доменным именем сервера с установленной платформой, в зависимости от настроек сетевого окружения.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"--https ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[757.0]},"content":[{"type":"paragraph","content":[{"text":"Здесь параметр ","type":"text"},{"text":"--https","type":"text","marks":[{"type":"code"}]},{"text":" определяет, работает платформа со схемой HTTPS или HTTP. Для использования HTTPS необходимо указать значение параметра ","type":"text"},{"text":"yes","type":"text","marks":[{"type":"strong"}]},{"text":". Для использования схемы HTTP необходимо указать значение параметра ","type":"text"},{"text":"no","type":"text","marks":[{"type":"strong"}]},{"text":" или не указывать параметр ","type":"text"},{"text":"--https","type":"text","marks":[{"type":"code"}]},{"text":". Обратите внимание, что для работы платформы по HTTPS необходимо пройти шаги конфигурирования в разделе ","type":"text"},{"text":"Работа по HTTPS","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":". Одно лишь указание этого флага приведет к недоступности платформы и по HTTP, и по HTTPS.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"-v2 ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[757.0]},"content":[{"type":"paragraph","content":[{"text":"Этот параметр указывает на необходимость одновременной работы и версии 2.xx, и версии 3.0. Для запуска одновременной работы необходимо пройти шаги конфигурирования в разделе ","type":"text"},{"text":"Одновременная работа версий 2.хх и 3.0","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":" и указать значение параметра ","type":"text"},{"text":"yes","type":"text","marks":[{"type":"strong"}]},{"text":". Для запуска только версии 3.0 указать значение параметра ","type":"text"},{"text":"no","type":"text","marks":[{"type":"strong"}]},{"text":", или не указывать параметр.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"--stop","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[757.0]},"content":[{"type":"paragraph","content":[{"text":"Запуск команды с этим параметром останавливает всю платформу 3.0.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"--force-pull","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[757.0]},"content":[{"type":"paragraph","content":[{"text":"Принудительно выкачивает новые образы 3.0, если таковые имеются.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"--force-regenerate-configs","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[757.0]},"content":[{"type":"paragraph","content":[{"text":"Удаляет config-файлы и создаёт их заново.","type":"text"}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Работа без авторизации","type":"text"}]},{"type":"paragraph","content":[{"text":"Для отключения авторизации необходимо в скрипте ","type":"text"},{"text":"run.sh","type":"text","marks":[{"type":"code"}]},{"text":" изменить значение параметра ","type":"text"},{"text":"USE_AUTHORIZATION","type":"text","marks":[{"type":"code"}]},{"text":" с ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" на ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":" и перезапустить платформу.","type":"text"}]},{"type":"codeBlock","content":[{"text":"sed -i 's|USE_AUTHORIZATION=true|USE_AUTHORIZATION=false|g' run.sh","type":"text"}]},{"type":"paragraph","content":[{"text":"Смотрите также","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"1f4c4","text":"📄","shortName":":page_facing_up:"}},{"text":" ","type":"text"},{"text":"Системные требования","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/v3/pages/2393208"}}]}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"На этой странице","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"9a7f0304-06fc-4d30-9a2f-fe69aeb1aadc"},"schemaVersion":{"value":"1"},"title":"Оглавление"}},"localId":"677ee06d-9537-4fb9-8268-723c1f915c1f"}},{"type":"rule"},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"1f551","text":"🕑","shortName":":clock2:"}},{"text":" Время чтения: 3 мин.","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"Нужна дополнительная помощь?","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Свяжитесь с технической поддержкой","type":"text","marks":[{"type":"link","attrs":{"href":"https://ru.visiology.su/products/support-contacts"}}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph"}],"version":1}

Браузер не поддерживается