Руководство прикладного разработчика продукта Platform V Product 360#
Основные понятия#
В таблице приведены основные аббревиатуры и сокращения:
Аббревиатура, сокращение |
Определение |
|---|---|
API |
Application programming interface |
HTTP |
Hypertext Transfer Protocol |
REST |
Representational State Transfer |
TTL |
Time to live |
ПРОМ |
Промышленная эксплуатация |
Системные требования#
Системных требований для успешного функционирования продукта не предъявляется.
Подключение и конфигурирование#
Подключение#
Для подключения продукта используется публичное api. (В данный момент находится в разработке).
Конфигурация параметров#
Конфигурация параметров запуска#
Описание параметров:
Параметр |
Краткое описание |
Тип |
|---|---|---|
product360.starter.client.app-api.url |
URL до REST-API APP-API |
STRING |
spring.datasource.jdbcUrl |
Адрес мастера БД |
STRING |
standin.datasource.jdbcUrl: |
Адрес стенда БД |
STRING |
spring.profiles.active: |
Активные профиля для запуска |
STRING |
spring.datasource.username: |
Имя пользователя БД |
STRING |
clipas.spas_server_url: |
УРЛ API SPAS |
STRING |
standin.datasource.driver-class-name: |
Драйвер БД для подключения |
STRING |
extend.clipas.tech.user: |
ТехУЗ для работы в СПАСе |
STRING |
SSL_KEYSTORE_LOCATION: |
Путь до кейстора кафки |
STRING |
SSL_TRUSTSTRE_LOCATION: |
Путь до трансфера кафки |
STRING |
standin.module.id |
Имя модуля в ПЖ |
STRING |
module.id: |
Имя модуля в системе логгирования |
STRING |
standin.cloud.client.zone-id: |
Зона ПЖ |
STRING |
standin.cloud.client.stub: |
Флаг заглушки ПЖ |
STRING |
standin.cloud.client.kafka.bootstrapServers: |
Адреса серверов кафки ПЖ |
STRING |
AUDIT_HOST |
URL API аудита |
STRING |
AUDIT_USER |
Пользователь для отправки в аудит |
STRING |
SSL_IDENTIFICATION_ALGORITHM |
Алгоритм идентификации для кафки ПЖ |
STRING |
product360.starter.client.auth-api.url |
URL до REST-API APP-API |
STRING |
Конфигурация кэша#
Описание параметров:
Параметр |
Краткое описание |
Тип |
|---|---|---|
ufsdictionary.module.cache.ttl |
Время жизни кэша платформенного модуля |
LONG |
Конфигурация мониторинга#
Описание параметров:
Название метрики |
Точка мониторинга |
Тип метрики |
Название сервиса |
|---|---|---|---|
system_load_average_1m |
Загрузка системы за последнюю минуту |
Состояние |
App-api |
jvm_memory_used_bytes |
Использованная ОЗУ в байтах |
Состояние |
App-api |
hikaricp_connections_active |
Количество активных коннектов к БД |
Состояние |
App-api |
process_uptime_seconds |
Общее время работы пода |
Состояние |
App-api |
process_cpu_usage |
Загрузка ЦПУ |
Состояние |
App-api |
jvm_threads_states_threads |
Количество активных тредов |
Состояние |
App-api |
select_product_offers_getAll_seconds_max |
Общее время получения списка оферов |
Состояние |
App-api |
select_product_offers_getAll_seconds_count |
Количество оферов получаемых за секунду |
Состояние |
App-api |
http_server_requests_seconds_count |
Количество выполняемых запросов в секунду |
Состояние |
App-api |
process_files_open_files |
Количество открытых файлов |
Состояние |
App-api |
select_product_specifications_view_siblings_seconds_count |
Количество продуктовых спецификаций |
Состояние |
App-api |
cache_gets_total |
Объем кэша |
Состояние |
App-api |
Миграция на текущую версию#
Миграция на текущую версию представляет собой ее подключение в соответствии с п. Подключение и конфигурирование настоящего руководства.
Для миграции БД создан отдельный скрипт в Jenkins. Скрипт параметризирован и при запуске попросит следующие параметры:
gitSshUrl – в качестве переменной необходимо указать адрес репозитория в BitBucket;
gitBranchSource – ветка, в которой лежат миграции, это может быть как отдельная ветка, содержащая в себе только миграции, так и папочка в репозитории проекта;
dbStand – стенд, на котором будет производиться установка миграций. В данный момент ПЖ не позволяет устанавливать StandIN с помощью api. Установка производится вручную через UI, поэтому данная строка ожидается к заполнению пользователем, чтобы избежать наката на мастер стенд.
Миграции допускаются в любом совместимом с liquibase формате.
Разработка первого приложения с использованием программного продукта#
После подключения продукта в соответствии с п. Подключение и конфигурирование настоящего руководства необходимо получить у администратора публичный ключ, см. Руководство оператора пункт Пользователи API.
Использование программного продукта#
Примеры использования API:
App-api:
https://\<stand-url\>/app-api/swagger-ui.html
Auth-api:
https://\<stand-url\>/auth-api/swagger-ui.html
Datamart-api:
https://\<stand-url\>/datamart-api/swagger-ui.html
Inner-connector-api:
https://\<stand-url\>/inner-connector-api/swagger-ui.html
<stand-url> для Вашего домена можно уточнить у команды разработки.
Часто встречающиеся проблемы и пути их устранения#
При ошибке получения от продукта целевого контура канала, в который должен быть перенаправлен пользователь, проверьте корректность настройки baseurl и работоспособность самой настройки baseurl, наличие сетевого доступа и сверьтесь со страничкой сваггера приложения, все ли требуемые параметры заполнены в соответствии со сваггером и корректно.
В случае недоступности стенда проверьте корректность работы СУДИРа.
В случае получения 401-403 ошибок проверьте корректность логина и пароля, а так же наличие их в системе авторизации (СУДИР/SPAS).