Модуль community.network.cnos_rollback – Восстановление текущей или стартовой конфигурации с удаленного сервера на устройствах под управлением Lenovo CNOS

Примечание

Этот модуль является частью коллекции community.network (версия 5.0.3).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.network.

Для использования в playbook, укажите: community.network.cnos_rollback.

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль позволяет работать с конфигурациями коммутатора. Он предоставляет способ восстановления конфигураций коммутатора с удаленного сервера. Это достигается с использованием стартовой или текущей конфигурации целевого устройства, которые были ранее сохранены на удаленном сервере с помощью FTP, SFTP, TFTP или SCP. Первый шаг – создание каталога, из которого можно получить доступ к удаленному серверу. Следующий шаг – указать полный путь к файлу резервной копии конфигурации. Необходимо также предоставить данные для аутентификации, требуемые удаленным сервером. По умолчанию этот метод перезаписывает конфигурационный файл коммутатора новым загруженным файлом. Этот модуль использует SSH для управления конфигурацией сетевого устройства. Результаты операции будут помещены в каталог с именем «results», который должен быть создан пользователем в локальном каталоге, где выполняется playbook.

Псевдонимы: network.cnos.cnos_rollback

Параметры

Параметр	Комментарии
configType string / required	Это относится к типу конфигурации, которая будет использоваться для процесса восстановления. Вариантами являются текущая или стартовая конфигурации. Значение по умолчанию отсутствует, поэтому в случае неправильного ввода произойдет ошибка. Варианты: `"running-config"` `"startup-config"`
deviceType string / required	Это указывает тип устройства, на котором выполняется метод. Варианты NE1072T, NE1032, NE1032T, NE10032, NE2572 добавлены начиная с Ansible 2.4. Вариант NE0152T добавлен начиная с 2.8 Варианты: `"g8272_cnos"` `"g8296_cnos"` `"g8332_cnos"` `"NE0152T"` `"NE1072T"` `"NE1032"` `"NE1032T"` `"NE10032"` `"NE2572"`
enablePassword string	Настраивает пароль, используемый для входа в режим команд глобальной конфигурации на коммутаторе. Если коммутатор не запрашивает этот пароль, параметр игнорируется. Хотя обычно значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр является необязательным. Если он не указан, значение по умолчанию использоваться не будет.
host string / required	Это переменная, используемая для поиска файла hosts в /etc/ansible/hosts и определения IP-адреса устройства, на которое будет применен шаблон. Обычно ключевое слово Ansible {{ inventory_hostname }} указывается в playbook как абстракция группы сетевых элементов, которые необходимо настроить.
outputfile string / required	Это указывает путь к файлу, где сохраняется результат каждого выполнения команды. Каждая команда, указанная в объединенном файле шаблона, и каждый ответ от устройства сохраняются здесь. Обычно это папка results, но вы можете выбрать другое местоположение в зависимости от ваших прав на запись.
password string / required	Настраивает пароль, используемый для аутентификации соединения с удаленным устройством. Значение параметра password используется для аутентификации сеанса SSH. Хотя обычно значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр является необязательным. Если он не указан, значение по умолчанию использоваться не будет.
protocol string / required	Это относится к протоколу, используемому сетевым устройством для взаимодействия с удаленным сервером, с которого будет загружена резервная копия конфигурации. Вариантами являются FTP, SFTP, TFTP или SCP. Любые другие протоколы приведут к ошибке. Если этот параметр не указан, значение по умолчанию использоваться не будет. Варианты: `"SFTP"` `"SCP"` `"FTP"` `"TFTP"`
rcpath string / required	Это указывает полный путь к конфигурационному файлу, расположенному на удаленном сервере. В случае использования относительного пути в качестве значения переменной необходимо указать корневую папку для пользователя сервера.
rcserverip string / required	Это указывает IP-адрес удаленного сервера, с которого будет загружена резервная копия конфигурации.
serverpassword string / required	Укажите пароль для сервера, относящийся к используемому протоколу.
serverusername string / required	Укажите имя пользователя для сервера, относящееся к используемому протоколу.
username string / required	Настраивает имя пользователя, используемое для аутентификации соединения с удаленным устройством. Значение параметра username используется для аутентификации сеанса SSH. Хотя обычно значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр является необязательным. Если он не указан, значение по умолчанию использоваться не будет.

Примечания

Примечание

Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами Lenovo см. 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 строка	Сообщение об успехе или ошибке Возвращается: всегда Пример: `"Config file transferred to Device"`

Авторы

Anil Kumar Muraleedharan (@amuraleedhar)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/cnos_rollback_module.html