cisco.ucs.ucs_lan_connectivity 模块 – 在 Cisco UCS Manager 上配置 LAN 连接策略

注意

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

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

要安装它,请使用:ansible-galaxy collection install cisco.ucs。您需要其他要求才能使用此模块,请参阅 要求 以了解详情。

要在 playbook 中使用它,请指定:cisco.ucs.ucs_lan_connectivity

概要

  • 在 Cisco UCS Manager 上配置 LAN 连接策略。

要求

在执行此模块的主机上需要以下要求。

  • ucsmsdk

参数

参数

注释

description

别名:descr

字符串

LAN 连接策略的描述。

Cisco 建议包含有关在何处以及何时使用策略的信息。

最多输入 256 个字符。

您可以使用除以下字符以外的任何字符或空格

` (重音符)、\ (反斜杠)、^ (脱字符)、” (双引号)、= (等号)、> (大于)、< (小于) 或 ‘ (单引号)。

hostname

字符串 / 必需

Cisco UCS Manager 的 IP 地址或主机名。

模块可与 UCS 平台仿真器 https://cs.co/ucspe 一起使用

iscsi_vnic_list

列表 / 元素=字典

LAN 连接策略使用的 iSCSI vNIC 列表。

iscsi_adapter_policy

字符串

与此 iSCSI vNIC 关联的 iSCSI 适配器策略。

mac_address

字符串

与此 iSCSI vNIC 关联的 MAC 地址。

如果未设置 MAC 地址,Cisco UCS Manager 将使用派生的 MAC 地址。

默认值: "derived"

name

字符串 / 必需

iSCSI vNIC 的名称。

overlay_vnic

字符串

与此 iSCSI vNIC 关联的 LAN vNIC。

state

字符串

如果为 present,将验证 iscsi vnic 是否在策略中配置。如果为 absent,将验证 iscsi vnic 是否不存在于策略中。

选项

  • "present" ← (默认)

  • "absent"

vlan_name

字符串

用于 iSCSI vNIC 的 VLAN。

默认值: "default"

name

字符串 / 必需

LAN 连接策略的名称。

此名称可以是 1 到 16 个字母数字字符。

您不能使用空格或除 -(连字符)、“_”(下划线)、:(冒号)和。(句点)以外的任何特殊字符。

策略创建后,您无法更改此名称。

org_dn

字符串

组织 DN(可分辨名称)

默认值: "org-root"

password

字符串 / 必需

Cisco UCS Manager 身份验证的密码。

port

整数

连接期间使用的端口号(默认情况下,https 使用 443,http 连接使用 80)。

proxy

字符串

如果 use_proxy 为 no,则指定要用于连接的代理。例如,'http://proxy.xy.z:8080'

state

字符串

如果为 present,将验证 LAN 连接策略是否存在,如果需要则创建。

如果为 absent,将验证 LAN 连接策略是否不存在,如果需要则删除。

选项

  • "present" ← (默认)

  • "absent"

use_proxy

布尔值

如果为 no,则不使用系统环境变量定义的代理。

选项

  • false

  • true ← (默认)

use_ssl

布尔值

如果为 no,将使用 HTTP 连接而不是默认的 HTTPS 连接。

选项

  • false

  • true ← (默认)

username

字符串

Cisco UCS Manager 身份验证的用户名。

默认值: "admin"

vnic_list

列表 / 元素=字典

LAN 连接策略使用的 vNIC 列表。

LAN 连接策略使用的 vNIC 必须从 vNIC 模板创建。

adapter_policy

字符串

以太网适配器策略的名称。

可以使用用户定义的策略,或系统定义的策略之一。

name

字符串 / 必需

vNIC 的名称。

order

字符串

指定 vNIC 赋值顺序的字符串(例如,“1”、“2”)。

默认值: "unspecified"

state

字符串

如果为 present,将验证 vnic 是否在策略中配置。如果为 absent,将验证 vnic 是否不存在于策略中。

选项

  • "present" ← (默认)

  • "absent"

vnic_template

字符串 / 必需

vNIC 模板的名称。

示例

- name: Configure LAN Connectivity Policy
  cisco.ucs.ucs_lan_connectivity:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: Cntr-FC-Boot
    vnic_list:
    - name: eno1
      vnic_template: Cntr-Template
      adapter_policy: Linux
    - name: eno2
      vnic_template: Container-NFS-A
      adapter_policy: Linux
    - name: eno3
      vnic_template: Container-NFS-B
      adapter_policy: Linux
    iscsi_vnic_list:
    - name: iSCSIa
      overlay_vnic: eno1
      iscsi_adapter_policy: default
      vlan_name: Container-MGMT-VLAN
    - name: iSCSIb
      overlay_vnic: eno3
      iscsi_adapter_policy: default
      vlan_name: Container-TNT-A-NFS

- name: Remove LAN Connectivity Policy
  cisco.ucs.ucs_lan_connectivity:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: Cntr-FC-Boot
    state: absent

作者

  • David Soper (@dsoper2)

  • John McDonough (@movinalot)

  • CiscoUcs (@CiscoUcs)