community.network.cnos_rollback – Восстановление конфигурации работающего или начального состояния с удаленного сервера на устройствах, работающих под управлением Lenovo CNOS
Примечание
Этот плагин входит в состав коллекции community.network (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.network.
Для использования в книге задач укажите: community.network.cnos_rollback.
Описание
- Этот модуль позволяет работать с конфигурациями коммутаторов. Он предоставляет возможность отката конфигурации коммутатора с удаленного сервера. Это достигается путем использования конфигураций «рабочего» или «начального» состояния целевого устройства, которые были предварительно резервными копированы на удаленный сервер с использованием FTP, SFTP, TFTP или SCP. Первым шагом является создание каталога, с которого можно получить доступ к удаленному серверу. Следующим шагом является предоставление полного пути к файлу резервной копии конфигурации. Также должны быть предоставлены данные об аутентификации, необходимые для удаленного сервера. По умолчанию этот метод перезаписывает файл конфигурации коммутатора новым загруженным файлом. Этот модуль использует SSH для управления конфигурацией сетевых устройств. Результаты операции будут помещены в каталог с именем «results», который должен быть создан пользователем в локальном каталоге, где выполняется книга задач.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| configType строка / обязательно |
| Это относится к типу конфигурации, которая будет использоваться для процесса отката. Вариантами являются конфигурации «рабочего» или «начального» состояния. Значения по умолчанию нет, поэтому неверный ввод приведет к ошибке. |
| deviceType строка / обязательно |
| Это определяет тип устройства, на котором выполняется метод. Варианты NE1072T, NE1032, NE1032T, NE10032, NE2572 добавлены с Ansible 2.4. Выбор NE0152T добавлен с версии 2.8. |
| enablePassword строка | Настраивает пароль, используемый для входа в режим глобальной конфигурации коммутатора. Если коммутатор не запрашивает этот пароль, параметр игнорируется. Хотя обычно значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться. | |
| host строка / обязательно | Эта переменная используется для поиска файла хостов в /etc/ansible/hosts и определения IP-адреса устройства, на которое будет применена шаблон. Обычно в книге задач используется ключевое слово Ansible {{ inventory_hostname }} в качестве абстракции группы сетевых элементов, которые необходимо настроить. | |
| outputfile строка / обязательно | Это указывает путь к файлу, где сохраняется вывод каждой команды. Здесь сохраняются каждая команда, указанная в объединенном файле шаблона, и каждый ответ от устройства. Обычно расположением является папка results, но вы можете выбрать другое местоположение в зависимости от прав на запись. | |
| password строка / обязательно | Настраивает пароль, используемый для аутентификации подключения к удаленному устройству. Значение параметра password используется для аутентификации сеанса SSH. Хотя обычно значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться. | |
| protocol строка / обязательно |
| Это относится к протоколу, используемому сетевым устройством для взаимодействия с удаленным сервером, с которого загружается резервная копия конфигурации. Вариантами являются FTP, SFTP, TFTP или SCP. Любые другие протоколы приведут к ошибке. Если этот параметр не указан, значение по умолчанию не будет использоваться. |
| rcpath строка / обязательно | Это указывает полный путь к файлу конфигурации, расположенному на удаленном сервере. В случае использования относительного пути в качестве значения переменной, необходимо указать корневой каталог для пользователя сервера. | |
| rcserverip строка / обязательно | Это указывает IP-адрес удаленного сервера, с которого будет загружена резервная копия конфигурации. | |
| serverpassword строка / обязательно | Укажите пароль для сервера, относящегося к используемому протоколу. | |
| serverusername строка / обязательно | Укажите имя пользователя для сервера, относящегося к используемому протоколу. | |
| username строка / обязательно | Настраивает имя пользователя, используемое для аутентификации подключения к удаленному устройству. Значение параметра 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 строка | всегда | Сообщение об успехе или неудаче Пример: Файл конфигурации передан устройству |
Авторы
- Anil Kumar Muraleedharan (@amuraleedhar)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/cnos_rollback_module.html