ordnance_config – Управление разделами конфигурации Ordnance

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

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
after -		Упорядоченный набор команд для добавления в конец стека команд, если необходимо внести изменения. Так же, как и с before, это позволяет разработчику сценария добавить набор команд для выполнения после набора команд.
backup boolean	Варианты: no ← yes	Этот аргумент заставит модуль создать полную резервную копию текущей `running-config` с удаленного устройства перед внесением каких-либо изменений. Файл резервной копии записывается в папку `backup` в корневом каталоге сценария. Если каталог не существует, он создается.
before -		Упорядоченный набор команд для добавления в стек команд, если необходимо внести изменения. Это позволяет разработчику сценария выполнить команды конфигурации перед внесением каких-либо изменений, не влияя на то, как набор команд сопоставляется с системой.
config -		Аргумент `config` позволяет разработчику сценария указать базовую конфигурацию, которая будет использоваться для проверки необходимых изменений конфигурации. Если этот аргумент указан, модуль не будет загружать текущую конфигурацию с удаленного узла.
defaults boolean	Варианты: no ← yes	Этот аргумент указывает, нужно ли собирать все значения по умолчанию при получении текущей конфигурации удаленного устройства. При включении модуль получит текущую конфигурацию, выполнив команду `show running-config all`.
lines -		Упорядоченный набор команд, которые должны быть сконфигурированы в разделе. Команды должны быть точно такими же, как в текущей конфигурации устройства. Обратите внимание на синтаксис команд конфигурации, так как некоторые команды автоматически изменяются анализатором конфигурации устройства. Псевдонимы: команды
match -	Варианты: line ← strict exact none	Указывает модулю способ сравнения набора команд с текущей конфигурацией устройства. Если match установлен в line, команды сравниваются по строкам. Если match установлен в strict, строки команд сравниваются относительно позиции. Если match установлен в exact, строки команд должны быть идентичными. Наконец, если match установлен в none, модуль не будет пытаться сравнить исходную конфигурацию с текущей конфигурацией удаленного устройства.
multiline_delimiter -	Значение по умолчанию: "@"	Этот аргумент используется при передаче многострочного элемента конфигурации маршрутизатору Ordnance. Он определяет символ, используемый в качестве разделителя. Это относится только к действию конфигурации.
parents -		Упорядоченный набор родительских элементов, которые однозначно идентифицируют раздел или иерархию, с которой должны сравниваться команды. Если аргумент parents опущен, команды сравниваются с набором команд верхнего уровня или глобальных команд.
replace -	Варианты: line ← block	Указывает модулю способ выполнения конфигурации на устройстве. Если replace установлен в line, измененные строки передаются устройству в режиме конфигурации. Если replace установлен в block, весь блок команд передается на устройство в режиме конфигурации, если какая-либо строка неверна.
save boolean	Варианты: no ← yes	Аргумент `save` указывает модулю сохранить текущую конфигурацию в стартовую конфигурацию по окончании работы модуля. Если указан режим проверки, этот аргумент игнорируется.
src -		Указывает путь к исходному файлу, содержащему конфигурацию или шаблон конфигурации для загрузки. Путь к исходному файлу может быть полным путем на хосте Ansible или относительным путем от корневого каталога сценария или роли. Этот аргумент взаимоисключает lines, parents.

Примеры

---
# Note: examples below use the following provider dict to handle
#       transport and authentication to the node.
vars:
  cli:
    host: "{{ inventory_hostname }}"
    username: RouterName
    password: password
    transport: cli

---
- name: configure top level configuration
  ordnance_config:
    lines: hostname {{ inventory_hostname }}
    provider: "{{ cli }}"

- name: configure interface settings
  ordnance_config:
    lines:
      - description test interface
      - ip address 172.31.1.1 255.255.255.0
    parents: interface Ethernet1
    provider: "{{ cli }}"

- name: configure bgp router
  ordnance_config:
    lines:
      - neighbor 1.1.1.1 remote-as 1234
      - network 10.0.0.0/24
    parents: router bgp 65001
    provider: "{{ cli }}"

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

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

Ключ	Возвращаемое значение	Описание
backup_path строка	при backup = yes	Полный путь к файлу резервной копии Пример: /playbooks/ansible/backup/ordnance_config.2016-07-16@22:28:34
updates список	Только при указании команд.	Набор команд, которые будут переданы на удаленное устройство Пример: ['...', '...']

Статус

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

Авторы

Александр Тернер (@alexanderturner) <alex.turner@ordnance.io>

Подсказка

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

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