Файл tasks_override.yaml#

Конфигурирование данного файла позволяет переопределить параметры шаблонизации конкретных конфигурационных файлов/тасок путем указания его oid и параметров, которые необходимо переопределить.

Конфигурирование#

Для конфигурирования задач или других конфигурационных файлов, требуемые параметры следует указать в tasks_override.yaml следующим образом:

<oid объекта IDMX>:
  <имя параметра шаблона>: <значение, которое требуется переопределить для параметра>
  <имя параметра шаблона>: <значение, которое требуется переопределить для параметра>

Например:

        472cdf3c-3c61-4ce9-9e78-14de9dfcca9e: # oid конфигурационного файла/задачи
            idmc.focal.task.label: | # параметр шаблона
                <nodeIdentifier>node1</nodeIdentifier> # значение (название построчно для различных меток для таски)
                <nodeIdentifier>node2</nodeIdentifier>
            idmc.focal.task.buckets.depth: 2 # количество bucket
            idmc.focal.task.workers.per.node.count: 2 # колличество узлов
            idmc.focal.task.worker.threads: 2 # количество worker
        0460fb39-94fc-40e3-9057-34edcf3b7bb6: # oid конфигурационного файла/задачи
            idmc.focal.task.label: <nodeIdentifier>node5</nodeIdentifier> # значение (название метки для задачи)
            idmc.focal.task.buckets.depth: 2
            idmc.focal.task.workers.per.node.count: 2

Также можно переопределять XML-блоки внутри тегов в конфигурации задач. Для этого в tasks_override.yaml следует указать параметр xmlTags, в котором должны быть перечислены теги, блоки которых планируется переопределить. После этого данные теги можно указывать внутри элементов OID задач со строками, которые должны быть подставлены в блоки указанных тегов.

Например:

xmlTags: "schedule,executionState"
472cdf3c-3c61-4ce9-9e78-14de9dfcca9e:
  idmc.focal.task.label: label1
  idmc.focal.task.worker.threads: 2
  schedule: |
    <recurrence>recurring</recurrence>
    <interval>180</interval>
  executionState: runnable

Валидация#

При работе job загрузки ресурсов производится валидация применяемого tasks_override.yaml согласно следующим правилам:

  • Самыми верхнеуровневыми параметрами могут быть только OID задач, либо параметр xmlTags.

  • xmlTags может содержать только XML-теги, содержащиеся в конфигурациях задач, перечисленные через запятую.

  • OID задачи должен быть валидным идентификатором типа uuid.

  • Внутри элемента OID должны быть указаны только простые пары параметр-значение, вложенность не допускается.

  • Каждый элемент внутри элемента OID должен быть стендозависимым параметром для переопределения, либо одним из тегов, указанных в xmlTags.

  • Параметры из tasks_override.xml должны совпадать по имени и типу с параметрами используемого idmc.all.conf, поэтому, если в tasks_override.xml указывается параметр, но его нет в idmc.all.conf - то будет ошибка валидации.

  • Переопределяемые теги XML валидируются на корректность XML-блока.

    Обратите внимание.

    Логическая валидация XML-блоков не производится.

    Например, если переопределяется тег <executionState> и в значении указывается некорректный параметр (например, 2), а не валидный (например, runnable), валидация пройдет успешно, если XML-блок составлен корректно.