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

Новая в версии 2.2.

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

Описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
issu - добавлен в 2.5		Варианты: обязательно желательно да нет ←	Обновление с использованием In Service Software Upgrade (ISSU). (Поддерживается на платформах N5k, N7k, N9k) Выбор «обязательно» или «да» означает, что обновления будут происходить только если коммутатор поддерживает ISSU. Выбор «желательно» означает, что обновления будут использовать ISSU, если возможно, но вернутся к прерывистому обновлению, если необходимо. Выбор «нет» означает, что не использовать ISSU. Принудительное прерывистое обновление.
kickstart_image_file -			Имя файла образа kickstart на флэш-памяти. (Не требуется на всех платформах Nexus)
provider -			Устарело Начиная с Ansible 2.5, рекомендуем использовать `connection: network_cli`. Этот параметр требуется только если вы используете NX-API. Для получения дополнительной информации обратитесь к руководству по платформам NXOS NXOS Platform Options guide. Объект словаря, содержащий данные подключения.
	auth_pass - добавлен в 2.5.3	По умолчанию: "none"	Указывает пароль, который нужно использовать, если требуется войти в привилегированный режим на удалённом устройстве. Если authorize равно false, то этот аргумент ничего не делает. Если значение не указано в задании, используется значение переменной среды `ANSIBLE_NET_AUTH_PASS`.
	authorize boolean добавлен в 2.5.3	Варианты: нет ← да	Инструктирует модуль войти в привилегированный режим на удалённом устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задании, используется значение переменной среды `ANSIBLE_NET_AUTHORIZE`.
	host - / обязательно		Указывает имя хоста DNS или адрес для подключения к удалённому устройству по указанному транспорту. Значение host используется в качестве адреса назначения для транспорта.
	password -		Указывает пароль для аутентификации подключения к удалённому устройству. Этот аргумент часто используется для транспортов cli или nxapi. Если значение не указано в задании, используется значение переменной среды `ANSIBLE_NET_PASSWORD`.
	port -	По умолчанию: "0 (использовать общий порт)"	Указывает порт для построения подключения к удалённому устройству. Это значение применяется для cli или nxapi. Значение порта по умолчанию устанавливается в соответствующий общий порт транспорта, если в задании не указано иное. (cli=22, http=80, https=443).
	ssh_keyfile -		Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задании, используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	timeout - добавлен в 2.3	По умолчанию: 10	Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истекает до завершения операции, модуль выдаст ошибку. NX-API может медленно возвращать результаты при длительных командах (sh mac, sh bgp и т. д.).
	transport - / обязательно	По умолчанию: "cli"	Настраивает транспортное соединение для подключения к удалённому устройству. Параметр transport поддерживает подключение к устройству через cli (ssh) или nxapi.
	use_proxy boolean добавлен в 2.5	Варианты: нет да ←	Если `no`, переменные окружения `http_proxy` и `https_proxy` будут проигнорированы.
	use_ssl boolean	Варианты: нет ← да	Настраивает transport для использования SSL, если установлено в true только при `transport=nxapi`, в противном случае это значение игнорируется.
	username -		Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации входа в CLI или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задании, используется значение переменной среды `ANSIBLE_NET_USERNAME`.
	validate_certs boolean	Варианты: нет да	Если `no`, сертификаты SSL не будут проверяться. Это следует использовать только на контролируемых вами сайтах с использованием самозаверяющих сертификатов. Если транспорт не 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 секунд или больше. Модуль завершит работу, если таймеры не настроены должным образом.
При использовании локального подключения ANSIBLE_PERSISTENT_CONNECT_TIMEOUT и ANSIBLE_PERSISTENT_COMMAND_TIMEOUT можно установить только с помощью переменных среды или файла ansible.cfg.
Не включайте полные пути к файлам, используйте только имена файлов, хранящихся в корневом каталоге флэш-памяти.
Этот модуль пытается установить программное обеспечение сразу, что может привести к перезагрузке.
В режиме проверки модуль покажет, необходимо ли обновление, и будет ли обновление прерывистым или нет (ISSU).
Для получения информации о работе с CLI и NX-API обратитесь к руководству по платформам NXOS NXOS Platform Options guide
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве по сети Ansible Ansible Network Guide
Для получения дополнительной информации об использовании Ansible для управления устройствами Cisco см. страницу интеграции Cisco Cisco integration page.

Примеры

- name: Install OS on N9k
  check_mode: no
  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) нет']}

Статус

Данный модуль не гарантирует обратной совместимости. [превью]
Этот модуль поддерживается командой Ansible Network Team. [сеть]

Поддержка Red Hat

Дополнительная информация о поддержке этого модуля Red Hat доступна в этой статье базы знаний Red Hat.

Авторы

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

Подсказка

Если вы заметили какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/nxos_install_os_module.html