Spec-Zone.ru › Ansible 2.6

cnos_rollback - Восстановление конфигурации работающего или начального устройства с удаленного сервера на устройствах, работающих под управлением Lenovo CNOS

Новая версия с 2.3.

  • Обзор
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус
  • Техническое обслуживание
    • Автор

Обзор

  • Этот модуль позволяет работать с конфигурациями коммутаторов. Он предоставляет способ отката конфигураций коммутатора с удаленного сервера. Это достигается с помощью начальной или рабочей конфигурации целевого устройства, которые были предварительно резервными копий на удаленный сервер с использованием FTP, SFTP, TFTP или SCP. Первым шагом является создание каталога, откуда можно получить доступ к удаленному серверу. Следующим шагом является предоставление полного пути к расположению резервной копии конфигурации. Также необходимо предоставить данные аутентификации, необходимые удаленному серверу. По умолчанию этот метод перезаписывает файл конфигурации коммутатора новым загруженным файлом. Этот модуль использует SSH для управления конфигурацией сетевого устройства. Результаты операции будут размещены в каталоге с именем «results», который должен быть создан пользователем в локальном каталоге, где выполняется исполняемый файл. Для получения дополнительной информации об этом модуле от Lenovo и настройке его использования для ваших случаев, посетите http://systemx.lenovofiles.com/help/index.jsp?topic=%2Fcom.lenovo.switchmgt.ansible.doc%2Fcnos_rollback.html

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
configType
обязательно
    Варианты:
  • running-config
  • startup-config
Значение по умолчанию:
null
Это относится к типу конфигурации, которая будет использоваться для процесса отката. Вариантами являются рабочая или начальная конфигурация. Значения по умолчанию нет, поэтому неправильный ввод приведет к ошибке.
deviceType
обязательно

(добавлено в 2.3)
    Варианты:
  • g8272_cnos
  • g8296_cnos
  • g8332_cnos
  • NE1072T
  • NE1032
  • NE1032T
  • NE10032
  • NE2572
Указывает тип устройства, на котором выполняется метод. Варианты NE1072T, NE1032, NE1032T, NE10032, NE2572 добавлены с версии 2.4.
enablePassword
(добавлено в 2.3)
Настраивает пароль, используемый для входа в режим глобальной конфигурации на коммутаторе. Если коммутатор не запрашивает этот пароль, параметр игнорируется. Как правило, значение должно поступать из файла инвентаризации, но его можно также указать как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться.
host
обязательно

(добавлено в 2.3)
Эта переменная используется для поиска файла хостов по пути /etc/ansible/hosts и определения IP-адреса устройства, на котором будет применена шаблон. Обычно в плейбуке используется ключевое слово Ansible {{ inventory_hostname }} как абстракция группы сетевых элементов, которые необходимо настроить.
outputfile
обязательно

(добавлено в 2.3)
Указывает путь к файлу, в котором сохраняются результаты выполнения каждой команды. Здесь сохраняются каждая команда, указанная в объединённом файле шаблона, и каждый ответ от устройства. Обычно расположение находится в папке результатов, но вы можете выбрать другое местоположение в зависимости от прав записи.
password
обязательно

(добавлено в 2.3)
Настраивает пароль, используемый для аутентификации подключения к удаленному устройству. Значение параметра password используется для аутентификации сессии SSH. Как правило, значение должно поступать из файла инвентаризации, но его можно также указать как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться.
protocol
обязательно
    Варианты:
  • SFTP
  • SCP
  • FTP
  • TFTP
Значение по умолчанию:
null
Это относится к протоколу, используемому сетевым устройством для взаимодействия с удаленным сервером, откуда загружается резервная конфигурация. Варианты: FTP, SFTP, TFTP или SCP. Любые другие протоколы приведут к ошибке. Если этот параметр не указан, значение по умолчанию не будет использоваться.
rcpath
обязательно
Значение по умолчанию:
null
Указывает полный путь к файлу конфигурации, расположенному на удалённом сервере. Если используется относительный путь в качестве значения переменной, необходимо указать корневую папку для пользователя сервера.
rcserverip
обязательно
Значение по умолчанию:
null
Указывает IP-адрес удалённого сервера, откуда будет загружена резервная конфигурация.
serverpassword
обязательно
Значение по умолчанию:
null
Укажите пароль для сервера, относящегося к используемому протоколу.
serverusername
обязательно
Значение по умолчанию:
null
Укажите имя пользователя для сервера, относящегося к используемому протоколу.
username
обязательно

(добавлено в 2.3)
Настраивает имя пользователя, используемое для аутентификации подключения к удаленному устройству. Значение параметра 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:
      host: "{{ inventory_hostname }}"
      username: "{{ hostvars[inventory_hostname]['ansible_ssh_user'] }}"
      password: "{{ hostvars[inventory_hostname]['ansible_ssh_pass'] }}"
      deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
      enablePassword: "{{ hostvars[inventory_hostname]['enablePassword'] }}"
      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:
      host: "{{ inventory_hostname }}"
      username: "{{ hostvars[inventory_hostname]['ansible_ssh_user'] }}"
      password: "{{ hostvars[inventory_hostname]['ansible_ssh_pass'] }}"
      deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
      enablePassword: "{{ hostvars[inventory_hostname]['enablePassword'] }}"
      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:
      host: "{{ inventory_hostname }}"
      username: "{{ hostvars[inventory_hostname]['ansible_ssh_user'] }}"
      password: "{{ hostvars[inventory_hostname]['ansible_ssh_pass'] }}"
      deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
      enablePassword: "{{ hostvars[inventory_hostname]['enablePassword'] }}"
      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:
      host: "{{ inventory_hostname }}"
      username: "{{ hostvars[inventory_hostname]['ansible_ssh_user'] }}"
      password: "{{ hostvars[inventory_hostname]['ansible_ssh_pass'] }}"
      deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
      enablePassword: "{{ hostvars[inventory_hostname]['enablePassword'] }}"
      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. Более подробную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, также поддерживаемых сообществом 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.6/modules/cnos_rollback_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API