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 目录中的文件名称。
此模块尝试立即安装软件，这可能会触发重启。
在检查模式下，模块将指示是否需要升级以及升级是中断式升级还是非中断式升级 (ISSU)。
有关使用 CLI 和 NX-API 的信息，请参见：ref:`NXOS 平台选项指南 <nxos_platform_options>`
有关使用 Ansible 管理网络设备的更多信息，请参见：ref:`Ansible 网络指南 <network_guide>`
有关使用 Ansible 管理 Cisco 设备的更多信息，请参见 `Cisco 集成页面 <https://ansible.org.cn/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)'
返回值
常见的返回值已在 此处 记录，以下是此模块特有的字段
键 |
描述 |
|---|---|
启动和安装信息。 返回： 始终 示例： |