dellos9_config - Управление разделами конфигурации Dell EMC Networking OS9
Новое в версии 2.2.
Обзор
- Конфигурации OS9 используют простой синтаксис отступов блоков для разделения конфигурации на секции. Этот модуль предоставляет реализацию для работы с секциями конфигурации OS9 детерминированным способом.
Параметры
| параметр | обязательно | по умолчанию | значения | комментарии | |||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| after | нет | Упорядоченный набор команд, которые необходимо добавить в конец стека команд, если требуется внести изменение. Как и в случае с before, разработчик скрипта может добавить набор команд, которые будут выполнены после набора команд. | |||||||||||||||||||||||||||||||||||||
| backup | нет |
| Этот аргумент заставляет модуль создавать полную резервную копию текущей running-config с удаленного устройства перед внесением каких-либо изменений. Файл резервной копии записывается в папку backup в корневой директории скрипта. Если директория не существует, она создается. | ||||||||||||||||||||||||||||||||||||
| before | нет | Упорядоченный набор команд, которые необходимо добавить в стек команд, если требуется внести изменение. Разработчик скрипта может использовать эту возможность для выполнения команд конфигурации до добавления каких-либо изменений, не влияя на сопоставление набора команд с системой. | |||||||||||||||||||||||||||||||||||||
| config | нет | Разработчик скрипта может использовать аргумент config для предоставления базовой конфигурации, которая будет использоваться для проверки необходимых изменений конфигурации. Если вы указываете этот аргумент, модуль не загружает running-config с удаленного узла. | |||||||||||||||||||||||||||||||||||||
| lines | нет | Упорядоченный набор команд, которые должны быть настроены в разделе. Команды должны быть идентичными командам, которые находятся в текущей конфигурации устройства. Обратите внимание на синтаксис команд конфигурации, так как анализатор конфигурации устройства автоматически изменяет некоторые команды. Этот аргумент несовместим с аргументом src. алиасы: команды | |||||||||||||||||||||||||||||||||||||
| match | нет | строка |
| Указывает модулю способ выполнения сопоставления набора команд с текущей конфигурацией устройства. Если вы установите match в строка, команды сопоставляются по строкам. Если вы установите match в строгое, строки команд сопоставляются по положению. Если вы установите match в точное, строки команд должны быть точным соответствием. Наконец, если вы установите match в нет, модуль не пытается сравнить исходную конфигурацию с текущей конфигурацией на удаленном устройстве. | |||||||||||||||||||||||||||||||||||
| parents | нет | Упорядоченный набор родителей, которые однозначно идентифицируют раздел, с которым должны сравниваться команды. Если вы опустите аргумент parents, команды будут сравниваться с набором команд верхнего уровня или глобальных команд. | |||||||||||||||||||||||||||||||||||||
| provider | нет | Объект словаря, содержащий данные подключения. |
|||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||
| replace | нет | строка |
| Указывает модулю способ выполнения конфигурации на устройстве. Если вы установите replace в строка, модифицированные строки отправляются устройству в режиме конфигурации. Если вы установите replace в блок, весь блок команд отправляется устройству в режиме конфигурации, если какая-либо строка неверна. | |||||||||||||||||||||||||||||||||||
| save | нет |
| Аргумент save инструктирует модуль сохранить текущую конфигурацию в конфигурацию по умолчанию по завершении работы модуля. Если задан режим проверки, этот аргумент игнорируется. | ||||||||||||||||||||||||||||||||||||
| src | нет | Указывает путь к исходному файлу, содержащему конфигурацию или шаблон конфигурации для загрузки. Путь к исходному файлу может быть полным путем на хосте Ansible или относительным путем от корневой директории скрипта или роли. Этот аргумент несовместим с аргументом lines. | |||||||||||||||||||||||||||||||||||||
| update | нет | слияние |
| Аргумент update управляет тем, как обрабатываются инструкции конфигурации на удаленном устройстве. Допустимые значения для аргумента update — слияние и проверка. При установке этого аргумента в слияние изменения конфигурации объединяются с текущей конфигурацией устройства. При установке этого аргумента в проверка изменения конфигурации определяются, но фактически не настраиваются на удаленном устройстве. | |||||||||||||||||||||||||||||||||||
Примеры
- dellos9_config:
lines: ['hostname {{ inventory_hostname }}']
provider: "{{ cli }}"
- dellos9_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 extended test']
before: ['no ip access-list extended test']
match: exact
provider: "{{ cli }}"
- dellos9_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 extended test']
before: ['no ip access-list extended test']
replace: block
provider: "{{ cli }}"
Возвращаемые значения
Общие возвращаемые значения документированы здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| имя | описание | возвращаемое | тип | пример |
|---|---|---|---|---|
| backup_path | Полный путь к файлу резервной копии | если backup равно да | строка | /playbooks/ansible/backup/dellos9_config.2016-07-16@22:28:34 |
| responses | Набор ответов от выполнения команд на устройстве. | Если не check_mode. | список | ['...', '...'] |
| saved | Возвращает, сохранена ли конфигурация в конфигурацию по умолчанию или нет. | Если не check_mode. | булево | True |
| updates | Набор команд, которые будут отправлены на удаленное устройство. | Всегда. | список | ['...', '...'] |
Примечания
Примечание
- Этот модуль требует версии Dell OS9 9.10.0.1P13 или выше.
- Этот модуль требует увеличения лимита скорости подключения ssh. Используйте следующую команду ip ssh connection-rate-limit 60 для настройки значения. Это также можно сделать с помощью модуля dellos9_config.
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместим.
Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, прочтите Информацию о сообществе и вклад, Тестирование 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/dellos9_config_module.html
