cisco.nxos.nxos_install_os – Настройка параметров загрузки, таких как загрузка, образ kickstart и issu.

Примечание

Этот плагин является частью коллекции cisco.nxos (версия 1.4.0).

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

Для использования в книге задач укажите: cisco.nxos.nxos_install_os.

Новое в версии 1.0.0: cisco.nxos

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

Обзор

Установите операционную систему, настроив параметры загрузки, такие как образ загрузки и образ kickstart, и необязательно выберите установку с использованием ISSU (In Server Software Upgrade).

Примечание

Для этого модуля имеется соответствующий плагин действия.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
issu строка		Варианты: обязательно желательно да нет ←	Обновить с помощью In Service Software Upgrade (ISSU). (Поддерживается на платформах N5k, N7k, N9k) Выбор «обязательно» или «да» означает, что обновления будут продолжены только если коммутатор поддерживает ISSU. Выбор «желательно» означает, что обновления будут использовать ISSU, если это возможно, но при необходимости вернутся к прерывистому обновлению. Выбор «нет» означает, что ISSU не использовать. Вынужденное прерывистое обновление.
kickstart_image_file строка			Имя файла образа kickstart на флэш-памяти. (Не требуется на всех платформах Nexus)
provider словарь			Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli`. Начиная с Ansible 2.6, рекомендуется использовать `connection: httpapi` для NX-API. Этот параметр будет удален в релизе после 2022-06-01. Дополнительную информацию см. в руководстве NXOS Platform Options. Объект словаря, содержащий данные подключения.
	auth_pass строка		Указывает пароль для использования, если необходимо войти в привилегированный режим на удаленном устройстве. Если authorize равно false, то этот аргумент ничего не делает. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	authorize булево	Варианты: нет ← да	Инструктирует модуль войти в привилегированный режим на удаленном устройстве перед отправкой каких-либо команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_AUTHORIZE`.
	host строка		Указывает имя хоста DNS или адрес для подключения к удаленному устройству по указанному каналу связи. Значение host используется в качестве целевого адреса для канала связи.
	password строка		Указывает пароль для аутентификации подключения к удаленному устройству. Это общий аргумент, используемый для каналов связи cli или nxapi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port целое число		Указывает порт для построения соединения с удаленным устройством. Это значение применимо к каналам связи cli или nxapi. Значение порта будет по умолчанию соответствовать общему порту соответствующего канала связи, если он не указан в задаче. (cli=22, http=80, https=443).
	ssh_keyfile строка		Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот аргумент используется только для канала связи cli. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout целое число		Указывает тайм-аут в секундах для связи с сетевым устройством для подключения или отправки команд. Если тайм-аут истекает до завершения операции, модуль вызовет ошибку. NX-API может медленно возвращать результаты при выполнении длительных команд (sh mac, sh bgp и т. д.).
	transport строка	Варианты: cli ← nxapi	Настраивает транспортное соединение для использования при подключении к удаленному устройству. Аргумент transport поддерживает подключение к устройству по протоколам cli (ssh) или nxapi.
	use_proxy булево	Варианты: нет да ←	Если `no`, переменные среды `http_proxy` и `https_proxy` будут проигнорированы.
	use_ssl булево	Варианты: нет ← да	Настраивает transport для использования SSL, если установлено значение `yes`, только когда `transport=nxapi`, в противном случае это значение игнорируется.
	username строка		Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого канала связи. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `ANSIBLE_NET_USERNAME`.
	validate_certs булево	Варианты: нет ← да	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых лично сайтах с использованием самозаверенных сертификатов. Если аргумент transport не является nxapi, это значение игнорируется.
system_image_file строка / обязательно			Имя файла системного (или комбинированного) образа на флэш-памяти.

Примечания

Примечание

Тестировалось на следующих платформах и изображениях - N9k 7.0(3)I4(6), 7.0(3)I5(3), 7.0(3)I6(1), 7.0(3)I7(1), 7.0(3)F2(2), 7.0(3)F3(2) - N3k 6.0(2)A8(6), 6.0(2)A8(8), 7.0(3)I6(1), 7.0(3)I7(1) - N7k 7.3(0)D1(1), 8.0(1), 8.1(1), 8.2(1)
Для этого модуля требуются таймеры ANSIBLE_PERSISTENT_CONNECT_TIMEOUT и ANSIBLE_PERSISTENT_COMMAND_TIMEOUT, установленные на 600 секунд или выше. Модуль завершится, если таймеры не настроены должным образом.
При использовании подключения local, ANSIBLE_PERSISTENT_CONNECT_TIMEOUT и ANSIBLE_PERSISTENT_COMMAND_TIMEOUT можно установить только с помощью переменных среды или файла ansible.cfg.
Не включайте полные пути к файлам, укажите только имена файлов, хранящиеся в корневом каталоге флэш-памяти.
Этот модуль пытается установить программное обеспечение немедленно, что может привести к перезагрузке.
В режиме проверки модуль укажет, требуется ли обновление, а также является ли обновление прерывистым или непрерывным (ISSU).
Дополнительную информацию об использовании CLI и NX-API см. в руководстве NXOS Platform Options.
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide.
Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на странице интеграции Cisco .

Примеры

- name: Install OS on N9k
  check_mode: no
  cisco.nxos.nxos_install_os:
    system_image_file: nxos.7.0.3.I6.1.bin
    issu: desired

- name: Wait for device to come back up with new image
  wait_for:
    port: 22
    state: started
    timeout: 500
    delay: 60
    host: '{{ inventory_hostname }}'

- name: Check installed OS for newly installed version
  nxos_command:
    commands: [show version | json]
    provider: '{{ connection }}'
  register: output
- assert:
    that:
    - output['stdout'][0]['kickstart_ver_str'] == '7.0(3)I6(1)'

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

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

Ключ	Возвращаемое значение	Описание
install_state словарь	всегда	Информация о загрузке и установке. Пример: {'install_state': ['Проверка совместимости выполнена:', 'Модуль загружаемый Влияние Тип установки Причина', '------ -------- -------------- ------------ ------', ' 1 да непрерывное сброс ', 'Изображения будут обновлены в соответствии со следующей таблицей:', 'Модуль Изображение Текущая версия(первоочередная:альтернативная) Новая версия Требуется обновление', '------ ---------- ---------------------------------------- -------------------- ------------', ' 1 nxos 7.0(3)I6(1) 7.0(3)I7(1) да', ' 1 bios v4.4.0(07/12/2017) v4.4.0(07/12/2017) нет']}

Авторы

Jason Edelman (@jedelman8)
Gabriele Gerbibo (@GGabriele)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/cisco/nxos/nxos_install_os_module.html