.. _podd_adapter_group_repl_config:

Конфигурация Модуля группировки чанков репликации (application.yml)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Файл ``application.yml`` – основной конфигурационный файл модуля, в котором описаны подключение к сервису Kafka, 
порт веб-сервера, и настройки журналирования запросов и ответов.


.. _podd_adapter_group_repl_application_yml:

Пример файла application.yml
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Приведем типовую структуру файла и возможные настройки **Модуля группировки чанков репликации**. 
Следует учитывать, что в конфигурационном файле следует задавать только те настройки, которые необходимы 
для решения текущих бизнес-задач.

.. code-block:: yaml

    http:
    port: ${HTTP_PORT:8084}

    executor:
    reader-pool-size: ${EXECUTOR_READER_POOL_SIZE:20}

    kafka:
    agent.topic.prefix: ${AGENT_TOPIC_PREFIX:}
    external:
        bootstrap.servers: ${KAFKA_BOOTSTRAP_SERVERS:localhost:9092}
        topic.prefix: ${EXTERNAL_TOPIC_PREFIX:${kafka.agent.topic.prefix}}
    internal:
        bootstrap.servers: ${PS_KAFKA:localhost:9092}
        topic.prefix: ${INTERNAL_TOPIC_PREFIX:${kafka.agent.topic.prefix}}
    consumer:
        delta-apply-request: ${kafka.external.topic.prefix}delta.in.rq
        property:
        bootstrap.servers: ${kafka.external.bootstrap.servers}
        group.id: ${kafka.external.topic.prefix}podd-adapter-group-repl
        auto.offset.reset: earliest
        enable.auto.commit: false
    producer:
        delta-apply-notification: ${kafka.internal.topic.prefix}subscription.in
        property:
        bootstrap.servers: ${kafka.internal.bootstrap.servers}

    logging:
    scl.delta:
        enabled: ${SCL_DELTA_ENABLED:false}

    metrics:
    port: ${METRICS_PORT:9837}


Параметры конфигурации
^^^^^^^^^^^^^^^^^^^^^^

Настройка конфигурации **Модуля группировки чанков репликации** осуществляется путем редактирования параметров настроек в файле ``application.yml``.

:ref:`podd_adapter_group_repl_application_yml` для **Модуля группировки чанков репликации** можно найти в разделе "2.2. Настройка на состав программных средств" Руководства администратора.

В файле конфигурации **Модуля группировки чанков репликации** могут быть настроены следующие секции:


- ``http`` - указывается порт веб-сервера;
- ``executor`` - предназначена для указания размера пула для запросов;
- ``kafka`` - настройки параметров подключения к шине данных Apache Kafka;
- ``logging`` - настройки журналирования запросов и ответов;
- ``metrics`` - настройка порта для получения метрик.


Секция http
#############

В секции ``http`` указывается порт веб-сервера. 

Например:

.. code-block:: yaml

  http:
    port: ${HTTP_PORT:8084}

**Параметры настроек**

- ``port`` - порт веб-сервера, например: ``HTTP_PORT:8084``.


Секция executor
###############

Секция ``executor`` предназначена для указания размера пула для чтения Kafka и времени выполнения задач.

Например: 

.. code-block:: yaml

  executor:
    reader-pool-size: ${EXECUTOR_READER_POOL_SIZE:20}


**Параметры настроек**


- ``reader-pool-size`` - размер пула для чтения Kafka, например ``EXECUTOR_READER_POOL_SIZE:20``.

Секция kafka
#############

Секция ``kafka`` определяет настройки взаимодействия через :term:`ПОДД-адаптер` между Поставщиком данных (``producer``) и Получателем данных (``consumer``).


В секции ``kafka`` собраны настройки параметров подключения к шине данных Apache Kafka.

Например:

.. code-block:: yaml

    kafka:
    agent.topic.prefix: ${AGENT_TOPIC_PREFIX:}
    external:
        bootstrap.servers: ${KAFKA_BOOTSTRAP_SERVERS:localhost:9092}
        topic.prefix: ${EXTERNAL_TOPIC_PREFIX:${agent.topic.prefix}}
    internal:
        bootstrap.servers: ${PS_KAFKA:localhost:9092}
        topic.prefix: ${INTERNAL_TOPIC_PREFIX:${agent.topic.prefix}}
    consumer:
        delta-apply-request: ${kafka.external.topic.prefix}delta.in.rq
        property:
        bootstrap.servers: ${kafka.external.bootstrap.servers}
        group.id: ${kafka.external.topic.prefix}podd-adapter-group-repl
        auto.offset.reset: earliest
        enable.auto.commit: false
    producer:
        delta-apply-notification: ${kafka.internal.topic.prefix}subscription.in
        property:
        bootstrap.servers: ${kafka.internal.bootstrap.servers}



**Параметры конфигурации**

- ``topic`` - префикс для топиков агента ПОДД, например ``AGENT_TOPIC_PREFIX``.

Секция logging
##############

Секция ``logging`` предназначена для настройки журналирования запросов и ответов

Например:

.. code-block:: yaml

    logging:
    scl.delta:
        enabled: ${SCL_DELTA_ENABLED:false}

**Параметры конфигурации**

- ``enabled`` - Журналировать события SCL delta, например: ``SCL_DELTA_ENABLED:false``.

LOG_FORMAT - Логирование в формате (JSON/TEXT) - указывается в ``logback.xml``.

Секция metrics
################

Секция ``metrics`` предназначена для настроек порта получения метрик.

Например:

.. code-block:: yaml

  metrics:
    port: ${METRICS_PORT:9837}

**Параметры настроек**

- ``port`` - Порт для получения метрик, например ``{METRICS_PORT:9837}``.