Модуль cisco.nxos.nxos_install_os – Установка параметров загрузки, таких как загрузка, образ kickstart и issu.
Примечание
Этот модуль является частью коллекции cisco.nxos (версия 8.1.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install cisco.nxos.
Чтобы использовать её в книге задач, укажите: cisco.nxos.nxos_install_os.
Новая в cisco.nxos 1.0.0
Описание
- Установка операционной системы путём настройки параметров загрузки, таких как образ загрузки и образ kickstart, и, при необходимости, выбор установки с использованием ISSU (In Server Software Upgrade).
Псевдонимы: install_os
Параметры
Параметр | Комментарии |
|---|---|
issu строка | Обновление с помощью In Service Software Upgrade (ISSU). (Поддерживается на платформах N5k, N7k, N9k) Выбор ‘required’ или ‘yes’ означает, что обновления будут выполняться только в том случае, если коммутатор поддерживает ISSU. Выбор ‘desired’ означает, что обновления будут использовать ISSU, если это возможно, но перейдут к прерывистому обновлению, если потребуется. Выбор ‘no’ означает, что не использовать ISSU. Вынужденное прерывистое обновление. Варианты:
|
kickstart_image_file строка | Имя файла образа kickstart на флэш-памяти. (Не требуется на всех платформах Nexus) |
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)
- Тестировалось на Cisco MDS NX-OS 9.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 см. в руководстве :ref:`NXOS Platform Options <nxos_platform_options>`
- Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве :ref:`Ansible Network Guide <network_guide>`
- Дополнительную информацию об использовании Ansible для управления устройствами Cisco см. на странице интеграции Cisco `<https://www.ansible.com/integrations/networks/cisco>`_.
Примеры
- name: Install OS on N9k
check_mode: false
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]
register: output
- assert:
that:
- output['stdout'][0]['kickstart_ver_str'] == '7.0(3)I6(1)'
Возвращаемые значения
Общие возвращаемые значения описаны в здесь, следующие поля уникальны для этого модуля:
Ключ | Описание |
|---|---|
install_state словарь | Информация о загрузке и установке. Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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/cisco/nxos/nxos_install_os_module.html
