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