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

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

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

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
deviceType строка / обязательно добавлено в 2.3	Варианты: g8272_cnos g8296_cnos g8332_cnos NE0152T NE1072T NE1032 NE1032T NE10032 NE2572	Указывает тип устройства, на котором выполняется метод. Варианты NE1072T, NE1032, NE1032T, NE10032, NE2572 добавлены начиная с Ansible 2.4. Вариант NE0152T добавлен начиная с 2.8
enablePassword строка добавлено в 2.3		Настраивает пароль, используемый для входа в режим командной конфигурации глобального уровня на коммутаторе. Если коммутатор не запрашивает этот пароль, параметр игнорируется. Обычно значение должно поступать из файла инвентаризации, но вы также можете указать его как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться.
host строка / обязательно добавлено в 2.3		Эта переменная используется для поиска файла hosts по пути /etc/ansible/hosts и определения IP-адреса устройства, на котором будет применена шаблон. Обычно в playbook используется ключевое слово Ansible {{ inventory_hostname }} как абстракция группы сетевых элементов, которые необходимо настроить.
imgpath - / обязательно		Указывает полный путь к файлу образа на удаленном сервере. Если используется относительный путь в качестве значения переменной, необходимо указать корневую папку для пользователя сервера.
imgtype - / обязательно	Варианты: all boot os onie	Указывает тип образа прошивки, который необходимо загрузить
outputfile строка / обязательно добавлено в 2.3		Указывает путь к файлу, куда сохраняются результаты выполнения каждой команды. Здесь сохраняются каждая команда, указанная в объединенном файле шаблона, и каждый ответ от устройства. Обычно это папка results, но вы можете выбрать другое местоположение в зависимости от прав записи.
password строка / обязательно добавлено в 2.3		Настраивает пароль, используемый для аутентификации подключения к удаленному устройству. Значение параметра password используется для аутентификации сессии SSH. Обычно значение должно поступать из файла инвентаризации, но вы также можете указать его как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться.
protocol - / обязательно	Варианты: SFTP SCP FTP TFTP	Указывает протокол, используемый сетевым устройством для взаимодействия с удаленным сервером, откуда загружается образ прошивки. Доступные варианты — FTP, SFTP, TFTP или SCP. Использование других протоколов приведет к ошибке. Если этот параметр не указан, значение по умолчанию не используется.
serverip - / обязательно		Указывает IP-адрес удаленного сервера, откуда будет загружен образ программного обеспечения.
serverpassword -		Указывает пароль для сервера, соответствующий используемому протоколу
serverusername - / обязательно		Указывает имя пользователя для сервера, соответствующего используемому протоколу
username строка / обязательно добавлено в 2.3		Настраивает имя пользователя, используемое для аутентификации подключения к удаленному устройству. Значение параметра username используется для аутентификации сессии SSH. Обычно значение должно поступать из файла инвентаризации, но вы также можете указать его как переменную. Этот параметр необязателен. Если он не указан, значение по умолчанию не будет использоваться.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления сетевыми устройствами Lenovo см. на сайте 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.8/modules/cnos_image_module.html