cnos_image – Выполнение обновления/загрузки прошивки с удалённого сервера на устройствах с Lenovo CNOS

Описание
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
deviceType строка / обязательно	Варианты: g8272_cnos g8296_cnos g8332_cnos NE0152T NE1072T NE1032 NE1032T NE10032 NE2572	Указывает тип устройства, на котором выполняется метод. Варианты NE1072T, NE1032, NE1032T, NE10032, NE2572 добавлены начиная с Ansible 2.4. Вариант NE0152T добавлен начиная с 2.8
enablePassword строка		Настраивает пароль, используемый для входа в режим глобальной конфигурации коммутатора. Если коммутатор не запрашивает этот пароль, параметр игнорируется. Хотя обычно значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться.
host строка / обязательно		Эта переменная используется для поиска файла хостов в /etc/ansible/hosts и определения IP-адреса устройства, на котором будет применена шаблон. Обычно в playbook в качестве абстракции группы сетевых элементов, которые нужно настроить, используется ключевое слово Ansible {{ inventory_hostname }}.
imgpath - / обязательно		Указывает полный путь к файлу изображения, расположенному на удалённом сервере. В случае использования относительного пути в качестве значения переменной, необходимо указать корневую папку для пользователя сервера.
imgtype - / обязательно	Варианты: all boot os onie	Указывает тип изображения прошивки для загрузки
outputfile строка / обязательно		Указывает путь к файлу, в котором сохраняются результаты выполнения каждой команды. Здесь сохраняются каждая команда, указанная в объединённом файле шаблона, и каждый ответ от устройства. Обычно расположением является каталог results, но вы можете выбрать другое расположение на основе разрешений на запись.
password строка / обязательно		Настраивает пароль, используемый для аутентификации подключения к удалённому устройству. Значение параметра password используется для аутентификации сессии SSH. Хотя обычно значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться.
protocol - / обязательно	Варианты: SFTP SCP FTP TFTP	Определяет протокол, используемый сетевым устройством для взаимодействия с удалённым сервером, откуда загружается изображение прошивки. Вариантами являются FTP, SFTP, TFTP или SCP. Любые другие протоколы приведут к ошибке. Если этот параметр не указан, значение по умолчанию не используется.
serverip - / обязательно		Указывает 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_image. These are
  written in the main.yml file of the tasks directory.
---
- name: Test Image transfer
  cnos_image:
      deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
      outputfile: "./results/test_image_{{ inventory_hostname }}_output.txt"
      protocol: "sftp"
      serverip: "10.241.106.118"
      imgpath: "/root/cnos_images/G8272-10.1.0.112.img"
      imgtype: "os"
      serverusername: "root"
      serverpassword: "root123"

- name: Test Image tftp
  cnos_image:
      deviceType: "{{ hostvars[inventory_hostname]['deviceType'] }}"
      outputfile: "./results/test_image_{{ inventory_hostname }}_output.txt"
      protocol: "tftp"
      serverip: "10.241.106.118"
      imgpath: "/anil/G8272-10.2.0.34.img"
      imgtype: "os"
      serverusername: "root"
      serverpassword: "root123"

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
msg строка	всегда	Сообщение об успехе или об ошибке Пример: Файл изображения передан на устройство

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.9/modules/cnos_image_module.html