community.network.cnos_image модуль – Выполнение обновления/загрузки прошивки с удаленного сервера на устройствах под управлением Lenovo CNOS
Примечание
Этот модуль является частью коллекции community.network (версия 5.0.3).
Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.network.
Для использования в playbook, укажите: community.network.cnos_image.
Краткое описание
- Этот модуль позволяет работать с образами прошивки коммутатора. Он предоставляет способ загрузки образа прошивки на сетевое устройство с удаленного сервера с использованием FTP, SFTP, TFTP или SCP. Первым шагом является создание каталога, откуда можно будет обратиться к удаленному серверу. Следующим шагом является указание полного пути к файлу с расположением образа. Необходимо также указать данные аутентификации, требуемые удаленным сервером. По умолчанию этот метод делает недавно загруженный образ прошивки активным, который будет использоваться коммутатором при следующей перезагрузке. Этот модуль использует SSH для управления конфигурацией сетевого устройства. Результаты операции будут помещены в каталог с именем «results», который должен быть создан пользователем в локальном каталоге, где запускается playbook.
Псевдонимы: network.cnos.cnos_image
Параметры
Параметр | Комментарии |
|---|---|
deviceType string / required | Указывает тип устройства, на котором выполняется метод. Варианты NE1072T, NE1032, NE1032T, NE10032, NE2572 добавлены начиная с Ansible 2.4. Вариант NE0152T добавлен начиная с 2.8 Варианты:
|
enablePassword string | Настраивает пароль, используемый для входа в режим команд глобальной конфигурации на коммутаторе. Если коммутатор не запрашивает этот пароль, параметр игнорируется. Хотя обычно значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр является необязательным. Если он не указан, значение по умолчанию использоваться не будет. |
host string / required | Это переменная, используемая для поиска файла hosts в /etc/ansible/hosts и определения IP-адреса устройства, на котором будет применен шаблон. Обычно в playbook указывается ключевое слово Ansible {{ inventory_hostname }} как абстракция группы сетевых элементов, которые необходимо настроить. |
imgpath string / required | Указывает полный путь к файлу образа, расположенному на удаленном сервере. В случае использования относительного пути в качестве значения переменной необходимо указать корневую папку для пользователя сервера. |
imgtype string / required | Указывает тип образа прошивки для загрузки Варианты:
|
outputfile string / required | Указывает путь к файлу, куда сохраняется результат каждого выполнения команды. Каждая команда, указанная в объединенном файле шаблона, и каждый ответ от устройства сохраняются здесь. Обычно это папка results, но вы можете выбрать другое местоположение в зависимости от ваших прав на запись. |
password string / required | Настраивает пароль, используемый для аутентификации подключения к удаленному устройству. Значение параметра password используется для аутентификации сессии SSH. Хотя обычно значение должно поступать из файла инвентаризации, вы также можете указать его как переменную. Этот параметр является необязательным. Если он не указан, значение по умолчанию использоваться не будет. |
protocol string / required | Определяет протокол, используемый сетевым устройством для взаимодействия с удаленным сервером, с которого будет загружен образ прошивки. Варианты: FTP, SFTP, TFTP или SCP. Любые другие протоколы приведут к ошибке. Если этот параметр не указан, значение по умолчанию использоваться не будет. Варианты:
|
serverip string / required | Указывает IP-адрес удаленного сервера, с которого будет загружен образ программного обеспечения. |
serverpassword string | Укажите пароль для сервера, относящийся к используемому протоколу |
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_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 строка | Сообщение об успехе или об ошибке Возвращаемое значение: всегда Пример: |
Ссылки на коллекцию
© 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_image_module.html
