cisco.ucs.ucs_vnic_template 模块 – 在 Cisco UCS Manager 上配置 vNIC 模板

注意

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

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

要安装它，请使用：ansible-galaxy collection install cisco.ucs。您需要其他要求才能使用此模块，有关详细信息，请参阅 要求。

要在剧本中使用它，请指定：cisco.ucs.ucs_vnic_template。

概要

  • 在 Cisco UCS Manager 上配置 vNIC 模板。

要求

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

  • ucsmsdk

参数

参数

注释

cdn_name

字符串

当 cdn_source 设置为用户定义时使用的 CDN 名称。

cdn_source

字符串

CDN 源字段。

可以选择以下选项之一

vnic-name - 使用 vNIC 实例的 vNIC 模板名称作为 CDN 名称。这是默认选项。

user-defined - 为 vNIC 模板使用用户定义的 CDN 名称。如果选择此选项，还必须提供 cdn_name。

选项

  • "vnic-name" ← (默认)

  • "user-defined"

description

别名：descr

字符串

vNIC 模板的用户定义描述。

输入最多 256 个字符。

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

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

fabric

字符串

指定与从该模板创建的 vNIC 关联的 Fabric 交换机的 Fabric ID 字段。

如果要在从该模板创建的 vNIC 上启用 Fabric 故障转移，请使用以下任一选项：

A-B 默认使用 Fabric A 并启用故障转移。

B-A 默认使用 Fabric B 并启用故障转移。

在以下情况下，请勿启用 vNIC Fabric 故障转移：

  • 如果 Cisco UCS 域以以太网交换机模式运行。该模式不支持 vNIC Fabric 故障转移。

  • 如果您计划将从该模板创建的一个或多个 vNIC 与不支持 Fabric 故障转移的适配器服务器关联。

选项

  • "A" ← (默认)

  • "B"

  • "A-B"

  • "B-A"

hostname

字符串 / 必需

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

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

mac_pool

字符串

从该 vNIC 模板创建的 vNIC 应使用的 MAC 地址池。

mtu

字符串

MTU 字段。

从该 vNIC 模板创建的 vNIC 应使用的最大传输单元或数据包大小。

输入“1500”到“9000”之间的字符串。

如果 vNIC 模板具有关联的 QoS 策略，则此处指定的 MTU 必须等于或小于 QoS 系统类中指定的 MTU。

默认值： "1500"

name

字符串 / 必需

vNIC 模板的名称。

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

您不能使用空格或除 -（连字符）、_（下划线）、：（冒号）和。（句点）之外的任何特殊字符。

模板创建后，您无法更改此名称。

network_control_policy

字符串

从该 vNIC 模板创建的 vNIC 应使用的网络控制策略。

org_dn

字符串

组织 DN（区分名称）

默认值： "org-root"

password

字符串 / 必需

Cisco UCS Manager 身份验证的密码。

peer_redundancy_template

别名：peer_redundancy_templ

字符串

对等冗余模板。

与该模板共享配置的 vNIC 模板的名称。

如果 redundancy_type 为 primary，则应提供辅助模板的名称。

如果 redundancy_type 为 secondary，则应提供主模板的名称。

辅助模板只能配置非共享属性（名称、描述和 mac_pool）。

pin_group

字符串

从该 vNIC 模板创建的 vNIC 应使用的 LAN pin 组。

port

整数

连接期间要使用的端口号（默认情况下，https 使用 443，http 使用 80）。

proxy

字符串

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

qos_policy

字符串

从该 vNIC 模板创建的 vNIC 应使用的服务质量 (QoS) 策略。

redundancy_type

字符串

在 Fabric 故障转移期间用于 vNIC 冗余对的冗余类型。

可以选择以下选项之一

primary — 创建可以与辅助模板共享的配置。

secondary — 所有共享配置都继承自主模板。

none - 旧版 vNIC 模板行为。如果您不想使用冗余，请选择此选项。

选项

  • "none" ← (默认)

  • "primary"

  • "secondary"

state

字符串

如果为 present，将验证 vNIC 模板是否存在，如果需要则会创建。

如果为 absent，将验证 vNIC 模板是否不存在，如果需要则会删除。

选项

  • "present" ← (默认)

  • "absent"

stats_policy

字符串

从该 vNIC 模板创建的 vNIC 应使用的统计信息收集策略。

target

字符串

从该模板创建的 vNIC 的可能目标。

目标决定 Cisco UCS Manager 是否自动创建具有 vNIC 模板相应设置的 VM-FEX 端口配置文件。

可以选择以下选项之一

适配器 — vNIC 应用于所有适配器。如果您选择此选项，则不会创建 VM-FEX 端口配置文件。

虚拟机 — vNIC 应用于所有虚拟机。如果您选择此选项，则会创建 VM-FEX 端口配置文件。

选项

  • "adapter" ← (默认)

  • "vm"

template_type

字符串

模板类型字段。

可以选择以下选项之一

initial-template — 如果模板发生更改，则不会更新从此模板创建的 vNIC。

updating-template — 如果模板发生更改，则会更新从此模板创建的 vNIC。

选项

  • "initial-template" ← (默认)

  • "updating-template"

use_proxy

布尔值

如果 no，则不会使用系统环境变量中定义的代理。

选项

  • false

  • true ← (默认)

use_ssl

布尔值

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

选项

  • false

  • true ← (默认)

username

字符串

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

默认： "admin"

vlans_list

列表 / 元素=字典

vNIC 模板使用的 VLAN 列表。

name

字符串

VLAN 的名称（如果状态存在，则为必填项）。

native

字符串

将 VLAN 指定为原生 VLAN。列表中只有一个 VLAN 可以是原生 VLAN。

选项

  • "no" ← (默认)

  • "yes"

state

字符串

如果存在，将验证 VLAN 是否存在于模板中。

如果不存在，将验证 VLAN 是否不存在于模板中。

选项

  • "present" ← (默认)

  • "absent"

示例

- name: Configure vNIC template
  cisco.ucs.ucs_vnic_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vNIC-A
    fabric: A
    vlans_list:
    - name: default
      native: 'yes'

- name: Configure vNIC template with failover
  cisco.ucs.ucs_vnic_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vNIC-A-B
    fabric: A-B
    vlans_list:
    - name: default
      native: 'yes'
      state: present

- name: Remove vNIC template
  cisco.ucs.ucs_vnic_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vNIC-A
    state: absent

- name: Remove another vNIC template
  cisco.ucs.ucs_vnic_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vNIC-A-B
    state: absent

- name: Remove VLAN from template
  cisco.ucs.ucs_vnic_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: vNIC-A-B
    fabric: A-B
    vlans_list:
    - name: default
      native: 'yes'
      state: absent

作者

  • David Soper (@dsoper2)

  • John McDonough (@movinalot)

  • CiscoUcs (@CiscoUcs)