Модуль cisco.nxos.nxos_install_os — настройка параметров загрузки, таких как загрузочный образ, образ kickstart и ISSU.
Примечание
Этот модуль входит в коллекцию cisco.nxos (версия 11.2.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-Service Software Upgrade).
Примечание
Этому модулю соответствует плагин действий.
Псевдонимы: install_os
Параметры
Параметр | Описание |
|---|---|
issu строка | Обновление с помощью In-Service Software Upgrade (ISSU). (Поддерживается на платформах N5k, N7k и N9k.) При выборе «required» или «yes» обновление выполняется только в том случае, если коммутатор поддерживает ISSU. При выборе «desired» для обновления используется ISSU, если это возможно; в противном случае выполняется прерывающее работу обновление. При выборе «no» ISSU не используется. Выполняется принудительное прерывающее работу обновление. Варианты:
|
kickstart_image_file строка | Имя файла образа kickstart во flash-памяти. (Не требуется на всех платформах Nexus.) |
system_image_file строка / обязательный | Имя файла системного (или объединённого) образа во flash-памяти. |
Примечания
Примечание
- Протестировано на следующих платформах и образах: 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.
- Не указывайте полный путь к файлу, используйте только имя файла, хранящегося в корневом каталоге flash-памяти.
- Этот модуль пытается немедленно установить программное обеспечение, что может привести к перезагрузке.
- В режиме проверки модуль укажет, требуется ли обновление, а также будет ли оно прерывающим или непрерывающим работу (ISSU).
- Информацию об использовании CLI и NX-API см. в :ref:`руководстве по параметрам платформы NXOS <nxos_platform_options>`.
- Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в :ref:`руководстве по сетям Ansible <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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/cisco/nxos/nxos_install_os_module.html
