cisco.nxos.nxos_rpm 模块 – 在 Cisco NX-OS 设备上安装补丁或功能 RPM 包。

注意

此模块是 cisco.nxos 集合 (版本 9.2.1) 的一部分。

如果您使用的是 ansible 包,则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install cisco.nxos

要在 playbook 中使用它,请指定:cisco.nxos.nxos_rpm

cisco.nxos 1.0.0 中的新增功能

概要

  • 在 Cisco NX-OS 设备上安装软件维护升级 (SMU) RPM 和第三方 RPM。

参数

参数

注释

aggregate

列表 / 元素=字典

RPM/补丁定义列表。

file_system

字符串

设备的远程文件系统。如果省略,支持 file_system 参数的设备将使用其默认值。

pkg

字符串 / 必需

RPM 包的名称。

state

字符串

如果 state 为 present,则将安装 rpm;如果 state 为 absent,则将将其移除。

选项

  • "present"

  • "absent"

file_system

字符串

设备的远程文件系统。如果省略,支持 file_system 参数的设备将使用其默认值。

默认值: "bootflash"

pkg

字符串

RPM 包的名称。

state

字符串

如果 state 为 present,则将安装 rpm;如果 state 为 absent,则将将其移除。

选项

  • "present" ← (默认)

  • "absent"

备注

注意

  • 针对 NXOSv 7.0(3)I2(5)、7.0(3)I4(6)、7.0(3)I5(3)、7.0(3)I6(1)、7.0(3)I7(3) 进行测试

  • 不支持 Cisco MDS

  • 对于补丁,所需的最低平台版本为 7.0(3)I2(5)

  • 对于功能 rpm,所需的最低平台版本为 7.0(3)I6(1)

  • 该模块管理整个 RPM 生命周期(添加、激活、提交、停用、移除)

  • 对于重新加载补丁,此模块在补丁提交之前不是幂等的。

  • 有关使用 CLI 和 NX-API 的信息,请参阅:ref:`NXOS 平台选项指南 `

  • 有关使用 Ansible 管理网络设备的更多信息,请参阅:ref:`Ansible 网络指南 `

  • 有关使用 Ansible 管理 Cisco 设备的更多信息,请参阅 `Cisco 集成页面 `_。

示例

- cisco.nxos.nxos_rpm:
    pkg: nxos.sample-n9k_ALL-1.0.0-7.0.3.I7.3.lib32_n9000.rpm

返回值

常见的返回值已在 此处 记录,以下是此模块独有的字段

描述

commands

列表 / 元素=字符串

发送到设备的命令

返回:始终

示例: ["install add bootflash:nxos.sample-n9k_ALL-1.0.0-7.0.3.I7.3.lib32_n9000.rpm forced", "install activate nxos.sample-n9k_ALL-1.0.0-7.0.3.I7.3.lib32_n9000 forced", "install commit nxos.sample-n9k_ALL-1.0.0-7.0.3.I7.3.lib32_n9000"]

作者

  • Sai Chintalapudi (@saichint)