Платформа 3V/Инструкция по работе с платформой: различия между версиями
Строка 11: | Строка 11: | ||
== Обновление версии == | == Обновление версии == | ||
− | При условии развернутой в docker-compose платформы для обновления на новую версию платформы необходимо изменить версии в конфигурационном файле «.env» и выполнить команду для запуска (docker-compose up). | + | При условии развернутой в docker-compose платформы для обновления на новую версию платформы необходимо: |
+ | 1. при необходимости проверить, что в вашем репозитории есть все актуальные конфигурационные файлы | ||
+ | 2. скачать недостающие конфиги новый репозиторий и поправить в конфигурационных файлах информацию о текущем стенде или скачать полностью новый репозиторий и в нем поправить по всем конфигурационным файлам информацию | ||
+ | изменить версии в конфигурационном файле «.env» и выполнить команду для запуска (docker-compose up). | ||
− | Для того, чтобы узнать актуальную версию | + | Для того, чтобы узнать текущую версию платформы (способ 1: [[Платформа_3V/Версия_платформы |описан в статье "Версия_платформы"]], способ 2: посмотреть имя/тег любого используемого докер-образа) |
+ | |||
+ | Для того, чтобы узнать актуальную версию, на которую требуется перейти: | ||
#Проанализировать исправленные ошибки и выполненные требования в рамках, которые были направлены от заинтересованных лиц в [https://trivium-group.atlassian.net/servicedesk '''техническую поддержку''']. Версия, в которой внесено исправление, будет указана в комментарии от администратора службы поддержки с примечанием является ли версия бэком (BACK) или вэбом (NAVI). | #Проанализировать исправленные ошибки и выполненные требования в рамках, которые были направлены от заинтересованных лиц в [https://trivium-group.atlassian.net/servicedesk '''техническую поддержку''']. Версия, в которой внесено исправление, будет указана в комментарии от администратора службы поддержки с примечанием является ли версия бэком (BACK) или вэбом (NAVI). | ||
#Зайти на '''РЕСУРС, ГДЕ БУДЕМ ПУБЛИКОВАТЬ ВЕРСИИ''' и посмотреть последнюю выпущенную версию ядра (BACK) и навигатора (NAVI) | #Зайти на '''РЕСУРС, ГДЕ БУДЕМ ПУБЛИКОВАТЬ ВЕРСИИ''' и посмотреть последнюю выпущенную версию ядра (BACK) и навигатора (NAVI) | ||
+ | |||
+ | '''Важно!''' При переходе на новую версию необходимо обязательно проверить наличие '''Критических изменений''' (Breaking changes) во всех версиях между вашей текущей и той, на которую требуется перейти и, соответственно, при необходимости провести работы на стенде, которые требуются в рамках этих критических изменений! | ||
+ | Перечень критических изменений вы найдете в https://gitlab.3v-group.org/open/demo-3v в папке '''«Release»''', а также в описании соответствующих релизов [[Описание_релизов|на их страницах]] | ||
== Обучение работе с платформой 3V == | == Обучение работе с платформой 3V == |
Версия 06:49, 11 августа 2021
Здесь вы найдете описание основных блоков по работе с платформой 3V, ссылки на инструкции и регламенты, а также информационные ресурсы по работе с платформой
Содержание
Разворачивание платформы 3V
Для разворачивания платформы с помощью docker-compose по ссылке https://gitlab.3v-group.org/open/demo-3v в папке «Manuals» вы найдете:
- Файл «Manual.txt» - инструкцию по разворачиванию платформы 3V с использованием существующего postgres-сервера БД и postgres-сервера БД в докер-образе
- Файл «Keycloak manual.pdf» - инструкция по разворачиванию и настройке системы авторизации Keycloak. При разворачивании образов с помощью Kubernetes и прочих средств запуска, см. страницу https://www.keycloak.org/getting-started.
- Прочие скрипты для подготовки сервера БД, требуемые по инструкции (папка «sql_scripts»)
Также в статье на Wiki вы найдете основные принципы работы с аутентификацией и авторизацией на платформе 3V. При возникновении проблем обращайтесь в техническую поддержку с типом обращения "Консультация".
Обновление версии
При условии развернутой в docker-compose платформы для обновления на новую версию платформы необходимо: 1. при необходимости проверить, что в вашем репозитории есть все актуальные конфигурационные файлы 2. скачать недостающие конфиги новый репозиторий и поправить в конфигурационных файлах информацию о текущем стенде или скачать полностью новый репозиторий и в нем поправить по всем конфигурационным файлам информацию изменить версии в конфигурационном файле «.env» и выполнить команду для запуска (docker-compose up).
Для того, чтобы узнать текущую версию платформы (способ 1: описан в статье "Версия_платформы", способ 2: посмотреть имя/тег любого используемого докер-образа)
Для того, чтобы узнать актуальную версию, на которую требуется перейти:
- Проанализировать исправленные ошибки и выполненные требования в рамках, которые были направлены от заинтересованных лиц в техническую поддержку. Версия, в которой внесено исправление, будет указана в комментарии от администратора службы поддержки с примечанием является ли версия бэком (BACK) или вэбом (NAVI).
- Зайти на РЕСУРС, ГДЕ БУДЕМ ПУБЛИКОВАТЬ ВЕРСИИ и посмотреть последнюю выпущенную версию ядра (BACK) и навигатора (NAVI)
Важно! При переходе на новую версию необходимо обязательно проверить наличие Критических изменений (Breaking changes) во всех версиях между вашей текущей и той, на которую требуется перейти и, соответственно, при необходимости провести работы на стенде, которые требуются в рамках этих критических изменений! Перечень критических изменений вы найдете в https://gitlab.3v-group.org/open/demo-3v в папке «Release», а также в описании соответствующих релизов на их страницах
Обучение работе с платформой 3V
На ресурсе Wiki вы найдете:
- вводный порядок обучения по работе с платформой с ссылками на видеоролики с настройкой простых информационных объектов
- статьи с описанием настройки различного функционала информационных объектов (см. внизу Главной страницы)
- различные рекомендации по использованию и оптимизации информационных объектов
- описание кейсов использования
Ответы на основные вопросы по работе с Wiki вы найдете на Welcome странице
Информационные ресурсы (техническая поддержка)
В статье "Информационные ресурсы" вы найдете всю подробную информацию о технической поддержке пользователей и порядке работы с ней, технической документации и прочих ресурсах, в которые возможно обратиться при возникновении тех или иных вопросов по работе с платформой 3V