Задачи

.Задачи хранятся в формате YAML.

Задачи выполняются последовательно.

Корневые элементы

id - уникальный идентификатор файла задач. Используется для сохранения состояния выполнения задач. Позволяет изменять имя файла и переносить его из одной папки в другую. Если отсутствует, то для сохранения используется параметр, переданный в параметре --tasks.

Online UUIDv4 generator

ping-before говорит о том, что нужно пропинговать хост  перед выполнением задачи. Если хост не пингуется, то предпроверки и задачи не выполняются.

dump-vars- имя файла, куда после выполнения будут сохранены результаты и переменные. Сохраняется в формате csv и создается в текущей директории.

vars - переменные, используемые при выполнении задачи. 

tasks - массив с задачами.

Описание задачи

id - уникальный идентификатор файла задачи. Используется для сохранения состояния выполнения задач. Позволяет изменять имя задачи и переносить ее в другой файл. Если отсутствует, то для сохранения используется параметр name.

name - Имя задачи

ignore-error - Если указан true, то ошибка при выполнении задачи не прерывает выполнение всего списка задач.

preflights - Предварительные проверки и заполнение переменных.

commands - Команды для выполнения.

Предпроверки

Является массивом и выполняется последовательно. Если проверка не пройдена, то задача не выполняется. С помощью параметра save-success-on-fail можно считать это успехом и сохранить в базу. Может быть удобно, если есть набор устройств с разными версиями прошивки, в которых отличаются параметры команд.

Параметры

command - строка с командой API. Возможны замены параметров.

args - массив с параметрами команды API. Возможны замены параметров.

checks - проверки. Результатом выполнения любой команды является массив с объектами. Если логически предполагается, что это не массив, то возвращается массив с одним объектом (например у команды /system/watchdog/print).

length - Первая проверка. Число. Проверяет длину массива с результатом. Например, можно проверить количество активных интерфейсов или записей в файрволе.

has - Вторая проверка. Объект. Проверяет наличие в результате хотя бы одного объекта с указанными параметрами. Если значение - строка, то она проверяется на соответствие. Так же может быть объектом regex: <regex>, в этом случае проверка будет проходить на соответствие регулярному выражению.

Проверить свои регулярки можно на Regex101

vars - переменные, которые необходимо сохранить. Объект. Значение - это путь до параметра в результате, например [0]['.id'] - идентификатор первого объекта в результате выполнения задачи. Нумерация начинается с 0.

Команды

Параметры

command - строка с командой API. Возможны замены параметров.

args - массив с параметрами команды API. Возможны замены параметров.

ignore-error - Если указан true, то ошибка при выполнении команды не прерывает выполнение всего списка команд в задаче.

Переменные

В командах и их аргументах можно использовать переменные. Замена происходит с помощью библиотеки mustache.

В стандартном случае можно написать {{var}} и это заменится на значение переменной var.

Если переменная имеет много трок и символы, которые декодируются в HTML, то надо использовать три скобки, например {{{var}}}.

1. Переменные хоста
2. Переменные файла задач
3. Переменные из предпроверок (всех, последовательно).

Примеры

id: 64b019f1-2cb1-4c55-9388-b343eebd6e27
ping-before: true
vars:
  script: >
    {
      :local target "1.1.1.1"
      :local pingCount 10
      :local pingTreshold 8

      :local result [ping count=$pingCount $target]
      :log info "Ping has $result successes of $pingCount"

      :if ($result < $pingTreshold) do={
        :log info "Reset usb power"
        /system routerboard usb power-reset duration=5s 
      } else={
        :log info "Skip usb power reset"
      }
    }
tasks:
  - id: 97b692e2-e1d6-475d-9b4b-e4d80aab9961
    name: Add script and scheduler
    ignore-error: false
    preflights:
      - command: /system/schedule/print
        args:
          - '?name=check_lte'
        checks:
          length: 0
      - command: /system/script/print
        args:
          - '?name=check_lte'
        checks:
          length: 0
    commands:
      - command: /system/script/add
        args:
          - '=name=check_lte'
          - '=source={{{script}}}'
        ignore-error: true

      - command: /system/schedule/add
        args:
          - '=name=check_lte'
          - '=on-event=/system script run check_lte'
          - '=interval=30s'
          - '=disabled=no'
        ignore-error: true

tasks:
  - name: Disable fastforward
    ignore-error: true
    preflights:
      - command: /ip/firewall/filter/print
        args:
          - '?action=fasttrack-connection'
        checks:
          length: 1
          has:
            disabled: 'false'
        vars:
          id: "[0]['.id']"
    commands:
      - command: /ip/firewall/filter/set
        args:
          - '=.id={{id}}'
          - '=disabled=true'