cnos_rollback – Восстановление конфигурации работающего или начального устройства с удалённого сервера на устройствах, работающих с Lenovo CNOS
Новое в версии 2.3.
Описание
- Этот модуль позволяет работать с конфигурациями коммутаторов. Он предоставляет способ восстановления конфигураций коммутатора с удалённого сервера. Это достигается с помощью начальной или текущей конфигураций целевого устройства, которые были предварительно резервированы на удалённом сервере с использованием FTP, SFTP, TFTP или SCP. Первым шагом является создание директории, из которой можно обратиться к удалённому серверу. Следующим шагом является предоставление полного пути к файлу резервной конфигурации. Также должны быть предоставлены данные аутентификации, необходимые удалённому серверу. По умолчанию этот метод перезаписывает файл конфигурации коммутатора новым загруженным файлом. Этот модуль использует SSH для управления конфигурацией сетевых устройств. Результаты операции будут помещены в директорию с именем «results», которую пользователь должен создать в локальной директории, где выполняется playbook.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| configType - / обязательно |
null | Это относится к типу конфигурации, которая будет использована для процесса восстановления. Варианты — текущая или начальная конфигурация. Значения по умолчанию нет, поэтому неправильный ввод приведёт к ошибке. |
| deviceType - / обязательно добавлено в 2.3 |
| Указывает тип устройства, на котором выполняется метод. Варианты NE1072T, NE1032, NE1032T, NE10032, NE2572 добавлены с версии 2.4. |
| enablePassword - добавлено в 2.3 | Настраивает пароль, используемый для перехода в режим глобальной конфигурации на коммутаторе. Если коммутатор не запрашивает этот пароль, параметр игнорируется. Хотя обычно значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться. | |
| host - / обязательно добавлено в 2.3 | Эта переменная используется для поиска файла hosts по пути /etc/ansible/hosts и определения IP-адреса устройства, на котором будет применена шаблон. Обычно в playbook используется Ansible-ключевое слово {{ inventory_hostname }} как абстракция группы сетевых элементов, которые необходимо настроить. | |
| outputfile - / обязательно добавлено в 2.3 | Указывает путь к файлу, где сохраняется вывод каждой команды. Здесь сохраняются команды, указанные в объединённом файле шаблона, и каждый ответ от устройства. Обычно это папка results, но вы можете выбрать другое место, если у вас есть соответствующие права записи. | |
| password - / обязательно добавлено в 2.3 | Настраивает пароль, используемый для аутентификации подключения к удалённому устройству. Значение параметра password используется для аутентификации сеанса SSH. Хотя обычно значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться. | |
| protocol - / обязательно |
null | Это относится к протоколу, используемому сетевым устройством для взаимодействия с удалённым сервером, откуда будет загружена резервная конфигурация. Варианты: FTP, SFTP, TFTP или SCP. Любые другие протоколы приведут к ошибке. Если этот параметр не указан, значение по умолчанию не будет использоваться. |
| rcpath - / обязательно | Значение по умолчанию: null | Указывает полный путь к файлу конфигурации на удалённом сервере. Если используется относительный путь в качестве значения переменной, необходимо указать корневую папку для пользователя сервера. |
| rcserverip - / обязательно | Значение по умолчанию: null | Указывает IP-адрес удалённого сервера, откуда будет загружена резервная конфигурация. |
| serverpassword - / обязательно | Значение по умолчанию: null | Укажите пароль для сервера, соответствующий используемому протоколу. |
| serverusername - / обязательно | Значение по умолчанию: null | Укажите имя пользователя для сервера, соответствующее используемому протоколу. |
| username - / обязательно добавлено в 2.3 | Настраивает имя пользователя, используемое для аутентификации подключения к удалённому устройству. Значение параметра username используется для аутентификации сеанса SSH. Хотя обычно значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться. |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами Lenovo Network см. на странице https://www.ansible.com/ansible-lenovo.
Примеры
Tasks : The following are examples of using the module cnos_rollback.
These are written in the main.yml file of the tasks directory.
---
- name: Test Rollback of config - Running config
cnos_rolback:
deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
outputfile: "./results/test_rollback_{{ inventory_hostname }}_output.txt"
configType: running-config
protocol: "sftp"
serverip: "10.241.106.118"
rcpath: "/root/cnos/G8272-running-config.txt"
serverusername: "root"
serverpassword: "root123"
- name: Test Rollback of config - Startup config
cnos_rolback:
deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
outputfile: "./results/test_rollback_{{ inventory_hostname }}_output.txt"
configType: startup-config
protocol: "sftp"
serverip: "10.241.106.118"
rcpath: "/root/cnos/G8272-startup-config.txt"
serverusername: "root"
serverpassword: "root123"
- name: Test Rollback of config - Running config - TFTP
cnos_rolback:
deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
outputfile: "./results/test_rollback_{{ inventory_hostname }}_output.txt"
configType: running-config
protocol: "tftp"
serverip: "10.241.106.118"
rcpath: "/anil/G8272-running-config.txt"
serverusername: "root"
serverpassword: "root123"
- name: Test Rollback of config - Startup config - TFTP
cnos_rolback:
deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
outputfile: "./results/test_rollback_{{ inventory_hostname }}_output.txt"
configType: startup-config
protocol: "tftp"
serverip: "10.241.106.118"
rcpath: "/anil/G8272-startup-config.txt"
serverusername: "root"
serverpassword: "root123"
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| msg строка | всегда | Сообщение об успехе или неудаче Пример: Файл конфигурации передан устройству |
Статус
- Гарантия обратной совместимости этого модуля не предоставляется. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Anil Kumar Muraleedharan (@amuraleedhar)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/cnos_rollback_module.html