cisco.nxos.nxos_install_os 模块 – 设置引导选项，例如引导映像、kickstart 映像和 ISSU。
注意
此模块是 cisco.nxos 集合 (版本 9.2.1) 的一部分。
如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用： ansible-galaxy collection install cisco.nxos。
要在 playbook 中使用它，请指定： cisco.nxos.nxos_install_os。
cisco.nxos 1.0.0 中的新增功能
概要
通过设置引导选项（如引导映像和 kickstart 映像）来安装操作系统，并可以选择使用 ISSU（服务器内软件升级）进行安装。
参数
参数 |
注释 |
|---|---|
使用服务器内软件升级 (ISSU) 进行升级。（在 N5k、N7k、N9k 平台上受支持） 选择“required”（必需）或“yes”（是）意味着只有在交换机能够进行 ISSU 时，升级才会继续进行。 选择“desired”（希望）意味着如果可能，升级将使用 ISSU，但如果需要，将回退到中断升级。 选择“no”（否）表示不使用 ISSU。强制中断升级。 选项
|
|
flash 上 kickstart 映像文件的名称。（并非所有 Nexus 平台都需要） |
|
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 秒或更长时间。如果计时器设置不正确，模块将退出。
使用本地连接时，只能使用环境变量或 ansible.cfg 文件设置 ANSIBLE_PERSISTENT_CONNECT_TIMEOUT 和 ANSIBLE_PERSISTENT_COMMAND_TIMEOUT。
不要包含完整的路径，只需包含存储在顶级 flash 目录中的文件(s) 的名称。
此模块尝试立即安装软件，这可能会触发重启。
在检查模式下，模块将指示是否需要升级以及升级是否为中断性升级或非中断性升级 (ISSU)。
有关使用 CLI 和 NX-API 的信息，请参阅：ref:`NXOS 平台选项指南
` 有关使用 Ansible 管理网络设备的更多信息，请参阅：ref:`Ansible 网络指南
` 有关使用 Ansible 管理 Cisco 设备的更多信息，请参阅 `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)'
返回值
公共返回值已记录在 此处，以下是此模块特有的字段
键 |
描述 |
|---|---|
引导和安装信息。 返回：始终 示例： |