Конфигурации¶
Вопрос: Как наиболее корректно прописать HTTP-запрос для дальнейшего экспорта приложений, созданных с помощью Конструктора микрофронтов, чтобы избежать многократных изменений HTTP-запроса в части домена?
Ответ: Для этого рекомендуется организовать доменное имя как переменную окружения и далее использовать ее, тогда при изменении окружения достаточно будет изменить только данную переменную.
Работа с переменными окружения описана в документации: Переменные окружения
Вопрос: По каким причинам возможна потеря данных из файлового сервиса после перезагрузки пода или его обновления?
Ответ: Наиболее вероятная причина – неправильно прописанный путь к хранилищу в настройках. Использование пути внутри пода (например, /tmp), который очищается при перезапуске сервиса, приведет к потере данных. Необходимо убедиться, что в конфигурации используется постоянное хранилище (Persistent Volume), подключенное к стабильному пути.
Вопрос: Можно ли подключить новый тип хранилища к файловому сервису, кроме трех заявленных (File storage, MongoDB, Storage Replica)?
Ответ: Да, можно подключить к файловому сервису новый тип хранилища с помощью использования плагина. Новый тип хранилища описывается в соответствии с ожидаемой структурой для Платформы, затем происходит сборка проекта в JAR-фаил, после чего данный артефакт собранного хранилища необходимо поместить в определенную директорию файлового сервиса и перезагрузить под файлового сервиса. Предварительно в сервисе конфигурации необходимо указать две настройки:
- docshouse.files.plugins.enabled – настройка для подключения и поиска плагина;
- docshouse.files.plugins.folder – путь для поиска плагина.
Подключение собственного типа хранилища контента подробно описано в документации: Подключение своего типа хранилища контента
Вопрос: Как и где настраивается проксирование?
Ответ: Проксирование настраивается в разделе «Конструктор микрофронтов».
Если раздел «Конструктор микрофронтов» не отображается в интерфейсе Системы, необходимо в сервисе «Права доступа» создать ресурс «proxies» и выдать пользователю разрешения.
Также необходимо настроить проксирование на все маршруты. Настройка маршрутов проксирования описана в документации: Настройка маршрута проксирования
Вопрос: Должна ли Платформа работать, если в сервисе конфигураций нет конфигов?
Ответ: Да, Платформа должна запускаться и работать.
В настройках, используемых для микросервисов, применяются следующие правила:
- должно быть указано значение по умолчанию;
- должна быть возможность настраивать их через переменные окружения;
- должна быть возможность настраивать их через сервис конфигураций.
Вопрос: По каким причинам не удается активировать тумблер при создании связи между сущностями?
Ответ: Возможно, не заданы конфигурации для сервиса связей. Перед созданием связей необходимо создать требуемые конфиги в соответствии с документацией: Настройки сервиса «Связи»
Вопрос: Как осуществляется настройка федеративного поиска?
Ответ: Общая настройка сервиса «Федеративный поиск» приведена в документации: Настройки сервиса «Федеративный поиск»
Вопрос: Есть ли возможность импортировать json-файл всего realm DH в Keycloak?
Ответ: Да, возможность импорта существует, но не через веб-интерфейс Keycloak. Импорт можно выполнить следующими способами:
- Через автоматический импорт при запуске контейнера. Для этого необходимо:
1. Подмонтировать в контейнер директорию с реалмом в /opt/keycloak/data/import
2. Запустить контейнер с параметром --import-realm. Например:
/opt/keycloak/bin/kc.sh start-dev --import-realm --spi-login-protocol-openid-connect-legacy-logout-redirect-uri=true.
- Через разовый импорт реалма (однократный) с помощью команды:
/opt/keycloak/bin/kc.sh import --file /path/to/realm.json
Важно:
- При использовании встроенной базы данных Keycloak ее необходимо вынести в Persistent Volume (PVC);
- При однократном импорте сервер Keycloak должен быть остановлен.