cisco.ucs.ucs_vnic_template 模块 – 在 Cisco UCS 管理器上配置 vNIC 模板

注意

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

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

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

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

概要

  • 在 Cisco UCS 管理器上配置 vNIC 模板。

要求

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

  • ucsmsdk

参数

参数

注释

cdn_name

字符串

当 cdn_source 设置为 user-defined 时使用的 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 关联的结构互连的结构 ID 字段。

如果您想在从此模板创建的 vNIC 上启用结构故障转移，请使用以下其中一项：”

A-B 默认使用结构 A，并启用故障转移。

B-A 默认使用结构 B，并启用故障转移。

在以下情况下，请勿启用 vNIC 结构故障转移

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

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

选择

  • "A" ← (默认)

  • "B"

  • "A-B"

  • "B-A"

hostname

字符串 / 必需

Cisco UCS 管理器的 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

字符串

Org dn（可分辨名称）

默认值： "org-root"

password

字符串 / 必需

Cisco UCS 管理器身份验证的密码。

peer_redundancy_template

别名：peer_redundancy_templ

字符串

对等冗余模板。

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

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

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

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

pin_group

字符串

从此 vNIC 模板创建的 vNIC 应使用的 LAN 引脚组。

port

整数

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

proxy

字符串

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

qos_policy

字符串

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

redundancy_type

字符串

用于结构故障转移期间 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 端口配置文件。

它可以是以下选项之一

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

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

选择

  • "adapter" ← (默认)

  • "vm"

template_type

字符串

“模板类型”字段。

它可以是以下选项之一

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

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

选择

  • "initial-template" ← (默认)

  • "updating-template"

use_proxy

boolean

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

选择

  • false

  • true ← (默认)

use_ssl

boolean

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

选择

  • false

  • true ← (默认)

username

字符串

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

默认值： "admin"

vlans_list

list / elements=dictionary

vNIC 模板使用的 VLAN 列表。

name

字符串

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

native

字符串

将 VLAN 指定为本地 VLAN。列表中只能有一个 VLAN 可以是本地 VLAN。

选择

  • "no" ← (默认)

  • "yes"

state

字符串

如果为 present，将验证 VLAN 是否在模板上。

如果为 absent，将验证 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)