dellos6_config - Управление разделами конфигурации Dell EMC Networking OS6
Новая версия 2.2.
Обзор
- Конфигурации OS6 используют простой синтаксис файла с отступами для разделения конфигурации на секции. Этот модуль предоставляет реализацию для работы с секциями конфигурации OS6 детерминированным способом.
Параметры
| параметр | обязательно | по умолчанию | выбор | комментарии | |||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| after | нет | Упорядоченный набор команд для добавления в конец стека команд, если необходимо внести изменения. Как и в случае с before, разработчик плана может использовать это для добавления набора команд, которые должны быть выполнены после набора команд. | |||||||||||||||||||||||||||||||||||||
| backup | нет |
| Этот аргумент заставляет модуль создавать полную резервную копию текущей running-config с удаленного устройства перед внесением каких-либо изменений. Файл резервной копии записывается в папку backup в корневом каталоге плана. Если папка не существует, она создается. | ||||||||||||||||||||||||||||||||||||
| before | нет | Упорядоченный набор команд, которые нужно поместить в стек команд, если необходимо внести изменения. Это позволяет разработчику плана выполнить команды конфигурации до внесения каких-либо изменений без влияния на то, как набор команд сопоставляется с системой. | |||||||||||||||||||||||||||||||||||||
| config | нет | Разработчик плана может использовать аргумент config для задания базовой конфигурации, которая будет использоваться для проверки необходимых изменений конфигурации. Если вы указываете этот аргумент, модуль не загружает running-config с удаленного узла. | |||||||||||||||||||||||||||||||||||||
| lines | нет | Упорядоченный набор команд, которые должны быть настроены в разделе. Команды должны быть такими же, как и в running-config устройства. Обратите внимание на синтаксис команд конфигурации, поскольку анализатор конфигурации устройства автоматически изменяет некоторые команды. Этот аргумент несовместим с src. псевдонимы: команды | |||||||||||||||||||||||||||||||||||||
| match | нет | строка |
| Указывает модулю способ выполнения сопоставления набора команд с текущей конфигурацией устройства. Если вы зададите match как строка, команды сопоставляются по строкам. Если вы зададите match как строго, строки команд сопоставляются по положению. Если вы зададите match как точно, строки команд должны быть точным совпадением. И наконец, если вы зададите match как нет, модуль не пытается сравнить исходную конфигурацию с текущей конфигурацией на удаленном устройстве. | |||||||||||||||||||||||||||||||||||
| parents | нет | Упорядоченный набор родительских элементов, которые однозначно идентифицируют раздел, по которому должны проверяться команды. Если вы опустите аргумент parents, команды проверяются по отношению к набору команд верхнего уровня или глобальным командам. | |||||||||||||||||||||||||||||||||||||
| provider | нет | Объект словаря, содержащий сведения о подключении. |
|||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
| replace | нет | строка |
| Указывает модулю способ выполнения конфигурации на устройстве. Если вы зададите аргумент replace как строка, измененные строки отправляются на устройство в режиме конфигурации. Если вы зададите аргумент replace как блок, весь блок команд отправляется на устройство в режиме конфигурации, если какая-либо строка неверна. | |||||||||||||||||||||||||||||||||||
| save | нет |
| Аргумент save инструктирует модуль сохранить running-config в startup-config по завершении работы модуля. Если вы указали режим проверки, этот аргумент игнорируется. | ||||||||||||||||||||||||||||||||||||
| src | нет | Указывает путь к исходному файлу, содержащему конфигурацию или шаблон конфигурации для загрузки. Путь к исходному файлу может быть полным путем на хосте Ansible или относительным путем от корня плана или роли. | |||||||||||||||||||||||||||||||||||||
| update | нет | слияние |
| Аргумент update управляет тем, как обрабатываются операторы конфигурации на удаленном устройстве. Допустимые значения для аргумента update — слияние и проверка. При установке этого аргумента в слияние изменения конфигурации объединяются с текущей конфигурацией running устройства. При установке этого аргумента в проверка, обновления конфигурации определяются, но фактически не настраиваются на удаленном устройстве. | |||||||||||||||||||||||||||||||||||
Примеры
- dellos6_config:
lines: ['hostname {{ inventory_hostname }}']
provider: "{{ cli }}"
- dellos6_config:
lines:
- 10 permit ip 1.1.1.1 any log
- 20 permit ip 2.2.2.2 any log
- 30 permit ip 3.3.3.3 any log
- 40 permit ip 4.4.4.4 any log
- 50 permit ip 5.5.5.5 any log
parents: ['ip access-list test']
before: ['no ip access-list test']
match: exact
provider: "{{ cli }}"
- dellos6_config:
lines:
- 10 permit ip 1.1.1.1 any log
- 20 permit ip 2.2.2.2 any log
- 30 permit ip 3.3.3.3 any log
- 40 permit ip 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/dellos6_config.2016-07-16@22:28:34 |
| responses | Набор ответов от выдачи команд на устройстве. | Когда не check_mode. | список | ['...', '...'] |
| saved | Возвращает, сохранена ли конфигурация в startup-конфигурацию или нет. | Когда не 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/dellos6_config_module.html
