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

Примечание

Этот плагин является частью коллекции community.network (версия 1.3.0).

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

Для использования в книге задач укажите: community.network.cnos_image.

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

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
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-адреса устройства, на которое будет применена шаблон. Обычно в книге задач используется ключевое слово 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
  community.network.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
  community.network.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 строка	всегда	Сообщение об успехе или неудаче Пример: Файл образа передан на устройство

Авторы

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.10/collections/community/network/cnos_image_module.html