dellos10_config - Управление разделами конфигурации Dell EMC Networking OS10
Новая версия с 2.2.
Обзор
- Конфигурации OS10 используют простой синтаксис с отступами для сегментации конфигурации на разделы. Этот модуль предоставляет реализацию для работы с разделами конфигурации OS10 детерминированным способом.
Параметры
| параметр | обязательный | по умолчанию | возможные значения | комментарии | |||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| after | нет | Упорядоченный набор команд для добавления в конец стека команд, если необходимо внести изменения. Как и с параметром before, разработчик плейбука может использовать этот аргумент для добавления набора команд, которые должны выполняться после набора команд. | |||||||||||||||||||||||||||||||||||||
| backup | нет |
| Этот аргумент заставляет модуль создавать полную резервную копию текущей running-config с удаленного устройства перед внесением каких-либо изменений. Файл резервной копии записывается в папку backup в корневом каталоге плейбука. Если папка не существует, она создается. | ||||||||||||||||||||||||||||||||||||
| before | нет | Упорядоченный набор команд для помещения в стек команд, если необходимо внести изменения. Разработчик плейбука может использовать этот аргумент для выполнения команд конфигурации до помещения любых изменений без влияния на способ сопоставления набора команд с системой. | |||||||||||||||||||||||||||||||||||||
| config | нет | Разработчик плейбука может использовать аргумент config для задания базовой конфигурации, которая будет использоваться для проверки необходимых изменений конфигурации. Если вы укажете этот аргумент, модуль не загрузит running-config с удаленного узла. | |||||||||||||||||||||||||||||||||||||
| lines | нет | Упорядоченный набор команд, которые должны быть настроены в разделе. Команды должны быть точно такими же, как и в running-config устройства. Обратите внимание на синтаксис команд конфигурации, так как анализатор конфигурации устройства автоматически изменяет некоторые команды. Этот аргумент взаимоисключающий с src. псевдонимы: commands | |||||||||||||||||||||||||||||||||||||
| match | нет | строка |
| Инструктирует модуль о способе выполнения сопоставления набора команд с текущей конфигурацией устройства. Если вы установите match на строка, команды сопоставляются по строкам. Если вы установите match на строго, строки команд сопоставляются по позиции. Если вы установите match на точно, строки команд должны быть точным совпадением. Наконец, если вы установите match на ничего, модуль не пытается сравнить исходную конфигурацию с рабочей конфигурацией на удаленном устройстве. | |||||||||||||||||||||||||||||||||||
| parents | нет | Упорядоченный набор родителей, которые однозначно идентифицируют раздел, с которым должны сравниваться команды. Если вы опустите аргумент parents, команды проверяются по отношению к набору команд верхнего уровня или глобальным командам. | |||||||||||||||||||||||||||||||||||||
| provider | нет | Объект словаря, содержащий сведения о подключении. |
|||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
| replace | нет | строка |
| Инструктирует модуль о способе выполнения конфигурации на устройстве. Если вы установите параметр replace на строка, модифицированные строки отправляются устройству в режиме конфигурации. Если вы установите параметр replace на блок, весь блок команд отправляется на устройство в режиме конфигурации, если какая-либо строка неверна. | |||||||||||||||||||||||||||||||||||
| save | нет |
| Аргумент save инструктирует модуль сохранить running-config в startup-config по завершении работы модуля. Если вы указали режим проверки, этот аргумент игнорируется. | ||||||||||||||||||||||||||||||||||||
| src | нет | Указывает путь к исходному файлу, содержащему конфигурацию или шаблон конфигурации для загрузки. Путь к исходному файлу может быть полным путем на хосте Ansible или относительным путем от корня плейбука или роли. | |||||||||||||||||||||||||||||||||||||
| update | нет | слияние |
| Аргумент update управляет тем, как обрабатываются операторы конфигурации на удаленном устройстве. Допустимые значения для аргумента update — слияние и проверка. При установке значения на слияние, изменения конфигурации объединяются с текущей рабочей конфигурацией устройства. При установке значения на проверка, изменения конфигурации определяются, но фактически не настраиваются на удаленном устройстве. | |||||||||||||||||||||||||||||||||||
Примеры
- dellos10_config:
lines: ['hostname {{ inventory_hostname }}']
provider: "{{ cli }}"
- dellos10_config:
lines:
- 10 permit ip host 1.1.1.1 any log
- 20 permit ip host 2.2.2.2 any log
- 30 permit ip host 3.3.3.3 any log
- 40 permit ip host 4.4.4.4 any log
- 50 permit ip host 5.5.5.5 any log
parents: ['ip access-list test']
before: ['no ip access-list test']
match: exact
provider: "{{ cli }}"
- dellos10_config:
lines:
- 10 permit ip host 1.1.1.1 any log
- 20 permit ip host 2.2.2.2 any log
- 30 permit ip host 3.3.3.3 any log
- 40 permit ip host 4.4.4.4 any log
parents: ['ip access-list test']
before: ['no ip access-list test']
replace: block
provider: "{{ cli }}"
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| имя | описание | возвращается | тип | образец |
|---|---|---|---|---|
| backup_path | Полный путь к файлу резервной копии | при backup = да | строка | /playbooks/ansible/backup/dellos10_config.2016-07-16@22:28:34 |
| responses | Набор ответов от выдачи команд на устройстве. | При отсутствии check_mode. | список | ['...', '...'] |
| saved | Возвращает, сохраняется ли конфигурация в стартовую конфигурацию или нет. | При отсутствии check_mode. | логическое значение | True |
| updates | Набор команд, отправленных на удаленное устройство. | Всегда. | список | ['...', '...'] |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если вам это интересно, пожалуйста, прочитайте Информация о сообществе и участие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/dellos10_config_module.html
