nos_config – Управление секциями конфигурации Extreme Networks NOS

Новая версия 2.7.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Обзор

Конфигурации Extreme NOS используют простой синтаксис с отступами для разделения конфигурации на секции. Этот модуль предоставляет реализацию для работы с секциями конфигурации NOS детерминированным способом.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
after -	По умолчанию: null	Упорядоченный набор команд для добавления в конец стека команд, если требуется изменение. Так же, как и с параметром before, это позволяет разработчику сценария добавить набор команд, которые будут выполнены после набора команд.
backup boolean	Варианты: нет ← да	Этот аргумент заставит модуль создать полную резервную копию текущей `running-config` с удаленного устройства перед внесением каких-либо изменений. Файл резервной копии записывается в папку `backup` в корневой директории сценария. Если директория не существует, она создается.
before -	По умолчанию: null	Упорядоченный набор команд для добавления в стек команд, если требуется изменение. Это позволяет разработчику сценария выполнить команды конфигурации перед внесением изменений, не влияя на сопоставление набора команд с системой.
diff_against -	Варианты: running intended	Используя аргумент командной строки `ansible-playbook --diff`, модуль может генерировать разницы с различными источниками. Когда этот параметр настроен как intended, модуль вернёт разницу между текущей конфигурацией (running-config) и конфигурацией, предоставленной в параметре `intended_config`. Когда этот параметр настроен как running, модуль вернёт разницу между текущей конфигурацией (running-config) до и после любых изменений, внесенных в конфигурацию устройства.
diff_ignore_lines -		Используйте этот аргумент для указания одной или нескольких строк, которые должны быть проигнорированы при сравнении (diff). Это используется для строк в конфигурации, которые автоматически обновляются системой. Этот аргумент принимает список регулярных выражений или точных совпадений строк.
intended_config -		Параметр `intended_config` предоставляет основную конфигурацию, которой должен соответствовать узел, и используется для проверки конечной конфигурации (running-config). Этот аргумент не будет изменять какие-либо настройки на удалённом устройстве и используется только для проверки соответствия текущей конфигурации устройства. При указании этого аргумента, необходимо также изменить значение параметра `diff_against` и установить его в значение intended.
lines -	По умолчанию: null	Упорядоченный набор команд, которые должны быть сконфигурированы в секции. Команды должны быть идентичны командам, которые находятся в текущей конфигурации устройства (running-config). Обратите внимание на синтаксис команд конфигурации, так как некоторые команды автоматически модифицируются парсером конфигурации устройства. псевдонимы: команды
match -	Варианты: строка ← строгий точный нет	Указывает модулю способ сопоставления набора команд с текущей конфигурацией устройства. Если match установлен на строка, команды сопоставляются по строкам. Если match установлен на строгий, строки команд сопоставляются с учётом позиции. Если match установлен на точный, строки команд должны быть точным совпадением. И наконец, если match установлен на нет, модуль не будет пытаться сравнить исходную конфигурацию с текущей конфигурацией удалённого устройства.
multiline_delimiter -	По умолчанию: "@"	Этот аргумент используется при передаче многострочного элемента конфигурации на устройство NOS. Он указывает символ, который будет использоваться в качестве разделителя. Это относится только к действию конфигурации.
parents -	По умолчанию: null	Упорядоченный набор родителей, которые однозначно идентифицируют секцию или иерархию, с которой должны быть проверены команды. Если аргумент parents опущен, команды проверяются относительно набора команд верхнего уровня или глобальных команд.
replace -	Варианты: строка ← блок	Указывает модулю способ выполнения конфигурации на устройстве. Если аргумент replace установлен на строка, изменённые строки отправляются на устройство в режиме конфигурации. Если аргумент replace установлен на блок, весь блок команд отправляется на устройство в режиме конфигурации, если какая-либо строка неверна.
running_config -	По умолчанию: null	По умолчанию модуль подключится к удалённому устройству и получит текущую конфигурацию (running-config), чтобы использовать её как основу для сравнения с содержимым источника. Иногда нежелательно, чтобы задача получала текущую конфигурацию (running-config) для каждой задачи в сценарии. Аргумент running_config позволяет реализатору передать конфигурацию, используемую в качестве базовой конфигурации для сравнения. псевдонимы: конфигурация
src -	По умолчанию: null	Указывает путь к файлу, содержащему конфигурацию или шаблон конфигурации для загрузки. Путь к файлу-источнику может быть полным путем на хосте Ansible или относительным путем от корневой директории сценария или роли. Этот аргумент взаимоисключает с lines, parents.

Примечания

Примечание

Проверено на NOS 7.2.0

Примеры

- name: configure top level configuration
  nos_config:
    lines: logging raslog console INFO

- name: configure interface settings
  nos_config:
    lines:
      - description test interface
      - ip address 172.31.1.1/24
    parents:
      - interface TenGigabitEthernet 104/0/1

- name: configure multiple interfaces
  nos_config:
    lines:
      - lacp timeout long
    parents: "{{ item }}"
  with_items:
    - interface TenGigabitEthernet 104/0/1
    - interface TenGigabitEthernet 104/0/2

- name: load new acl into device
  nos_config:
    lines:
      - seq 10 permit ip host 1.1.1.1 any log
      - seq 20 permit ip host 2.2.2.2 any log
      - seq 30 permit ip host 3.3.3.3 any log
      - seq 40 permit ip host 4.4.4.4 any log
      - seq 50 permit ip host 5.5.5.5 any log
    parents: ip access-list extended test
    before: no ip access-list extended test
    match: exact

- name: check the running-config against master config
  nos_config:
    diff_against: intended
    intended_config: "{{ lookup('file', 'master.cfg') }}"

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
backup_path строка	при backup равно да	Полный путь к файлу резервной копии Пример: /playbooks/ansible/backup/nos_config.2018-02-12@18:26:34
commands список	всегда	Набор команд, которые будут отправлены на удаленное устройство Пример: ['switch-attributes hostname foo', 'router ospf', 'area 0']
updates список	всегда	Набор команд, которые будут отправлены на удаленное устройство Пример: ['switch-attributes hostname foo', 'router ospf', 'area 0']

Статус

Этот модуль не гарантирует обратную совместимость. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Lindsay Hill (@LindsayHill)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ для улучшения.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/nos_config_module.html