Создание файла с базовой конфигурацией#
Необходимо создать пустой файл с расширением .yml, в котором требуется прописать следующие параметры и их значения (содержимое конфигурационного файла является группой):
Обязательные параметры:
versionВ значении параметра указывается текущая версия нотации YML. Значение параметра version представляет собой три, разделенных точками, целых числа. Данное значение может отличаться от версии конфигуратора, для которого создается конфигурационный файл. Если версия отличается, то запускается механизм нормализации.
version: 2.0.3Версию конфигуратора можно посмотреть, используя CLI команду:
sowa-config --versionТип параметра: текстовое значение.
profileВ значении параметра profile определяется имя профиля, для которого создается конфигурация.
profile: my_profileТип параметра: строковое значение.
systemВ значении параметра system определяются настройки системных параметров SOWA.
Тип параметра: группа параметров и их значения.
wrk_countВ значении параметра определяется число рабочих процессов.
wrk_count: autoПри использовании SOWA в системе контейнеризации Platform V (K8S или Openshift), требуется установить значение, равное «1».
Для остальных случаев рекомендуется установить значение «auto».
Тип параметра: текстовое значение.
Обязательность параметра: нет.
conn_countВ значении параметра определяется максимальное число соединений, которые одновременно может обслуживать профиль.
Необходимо учитывать, что для обслуживания соединений используются файловые дескрипторы. Общий лимит дескрипторов для пользователя sowactl, из-под которого запущены рабочие процессы, cоставляет 250 000. Общий лимит поровну распределяется между рабочими процессами в профиле.
По умолчанию: «4096».
conn_count: 30000Тип параметра: целочисленное значение.
Обязательность параметра: нет.
optionalГруппа
optionalиспользуется в параметре system для:определения пользователя и группы, с правами которого будут работать рабочие процессы;
указания уровня логирования;
вкл./откл. мониторинга статистики;
и др.
Группа, включающая в себя параметры, описанные в разделе «Базовая конфигурация — optional».
serviceВ группе
serviceопределяются типы и количество используемых сервисов.service_http_proxy;service_web_socket_proxy;service_rest_proxy;service_web_service_proxy;service_file_transfer;service_http_mq_proxy;service_http_kafka_proxy;service_stub_file_receiver;service_stub_web_socket;service_stub_http;service_main_proxy;service_static;service_cache;service_gost_proxy;service_sowa_ipa.
Опциональные параметры:
profile_versionВ значении параметра указывается текущая версия профиля. Значение параметра должно соответствовать паттерну:
^[A-Za-z0-9\.\-_]$profile_version: XXXТип параметра: текстовое значение.
sowa_versionВ значении параметра указывается минимальная версия СПО части дистрибутива для корректного взаимодействия с ППО.
sowa_version: D-2.5-5501-8Тип параметра: текстовое значение.
is_outgoingФлаг сигнализирует о том, что запросы идут из доверенной зоны во вне контура банка.
В этом случае не заполняются по умолчанию заголовки Forwarded и X-Real-Ip.
Возможные значения:
true;false.
По умолчанию:
is_outgoing: false
Пример настройки базовой конфигурации:
version: 2.0.3
profile_version: XXX
profile: uko_web
system:
wrk_count: 4
conn_count: 4096
optional:
thread_pools:
- id: mq_logger_pool
threads_num: 1
max_queue: 100
- id: uko_web_async_io_pool
threads_num: 32
max_queue: 65536
async_io:
directio_threshold: 4k
write: true
thread_pool_id: uko_web_async_io_pool
wrk_user: sowactl
underscores_in_headers: true
log_level: debug
service:
service_main_proxy:
- id: 1
...