cisco.ucs.ucs_service_profile_template 模块 – 在 Cisco UCS Manager 上配置服务配置文件模板

注意

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

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

要安装它,请使用:ansible-galaxy collection install cisco.ucs。您需要进一步的要求才能使用此模块,请参阅 要求 以了解详细信息。

要在剧本中使用它,请指定:cisco.ucs.ucs_service_profile_template

概要

  • 在 Cisco UCS Manager 上配置服务配置文件模板。

要求

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

  • ucsmsdk

参数

参数

注释

bios_policy

字符串

要与从此模板创建的服务配置文件关联的 BIOS 策略的名称。

boot_policy

字符串

要与从此模板创建的服务配置文件关联的启动顺序策略的名称。

默认值: "default"

description

别名:descr

字符串

用户定义的服务配置文件模板的描述。

输入最多 256 个字符。

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

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

graphics_card_policy

字符串

要与从此模板创建的服务配置文件关联的显卡策略的名称。

host_firmware_package

字符串

要与从此模板创建的服务配置文件关联的主机固件包的名称。

hostname

字符串 / 必需

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

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

ipmi_access_profile

字符串

要与从此模板创建的服务配置文件关联的 IPMI 访问配置文件的名称。

iqn_pool

字符串

要应用于从此模板创建的服务配置文件的所有 iSCSI vNIC 的 IQN 池(发起程序)的名称。

kvm_mgmt_policy

字符串

要与从此模板创建的服务配置文件关联的 KVM 管理策略的名称。

lan_connectivity_policy

字符串

要与从此模板创建的服务配置文件关联的 LAN 连接策略的名称。

local_disk_policy

字符串

要与从此模板创建的服务配置文件关联的本地磁盘策略的名称。

maintenance_policy

字符串

要与从此模板创建的服务配置文件关联的维护策略的名称。

mgmt_inband_pool_name

字符串

如何为此服务配置文件关联的服务器派生带内管理 IPv4 地址。

mgmt_interface_mode

字符串

要分配给从此模板创建的服务配置文件的管理接口。

选项

  • ""

  • “in-band”

mgmt_ip_pool

字符串

要与从此模板创建的服务配置文件一起使用的带外管理 IP 池的名称。

默认值: "ext-mgmt"

mgmt_ip_state

字符串

要与从此模板创建的服务配置文件一起使用的带外管理 IP 池的状态。

选项为 none 或 pooled。

默认值: "pooled"

mgmt_vnet_name

字符串

从关联的 VLAN 组中选择的 VLAN。

name

字符串 / 必需

服务配置文件模板的名称。

此名称可以在 2 到 32 个字母数字字符之间。

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

此名称在同一组织内的所有服务配置文件和服务配置文件模板中必须唯一。

org_dn

字符串

Org dn(专有名称)

默认值: "org-root"

password

字符串 / 必需

用于 Cisco UCS Manager 身份验证的密码。

port

整数

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

power_control_policy

字符串

要与从此模板创建的服务配置文件关联的电源控制策略的名称。

默认值: "default"

power_state

字符串

当从此模板创建的服务配置文件与服务器关联时要应用的电源状态。

选项

  • "up" ← (默认)

  • “down”

power_sync_policy

字符串

要与从此模板创建的服务配置文件关联的电源同步策略的名称。

proxy

字符串

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

san_connectivity_policy

字符串

要与从此模板创建的服务配置文件关联的 SAN 连接策略的名称。

scrub_policy

字符串

要与从此模板创建的服务配置文件关联的擦除策略的名称。

server_pool

字符串

要与此服务配置文件模板关联的服务器池的名称。

server_pool_qualification

字符串

要用于此服务配置文件模板的服务器池策略限定的名称。

sol_policy

字符串

要与从此模板创建的服务配置文件关联的串行通过 LAN (SoL) 策略的名称。

state

字符串

如果 present,将验证服务配置文件模板是否存在,如果需要则创建。

如果 absent,将验证服务配置文件模板是否不存在,如果需要则删除。

选项

  • "present" ← (默认)

  • "absent"

storage_profile

字符串

您想要与从此模板创建的服务配置文件关联的存储配置文件的名称

template_type

字符串

模板类型字段,可以是以下之一

initial-template — 如果模板发生更改,则从此模板创建的任何服务配置文件都不会更新。

updating-template — 如果模板发生更改,则从此模板创建的任何服务配置文件都会更新。

选项

  • "initial-template" ← (默认)

  • "updating-template"

threshold_policy

字符串

您想要与从此模板创建的服务配置文件关联的阈值策略的名称。

默认值: "default"

use_proxy

布尔值

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

选项

  • false

  • true ← (默认)

use_ssl

布尔值

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

选项

  • false

  • true ← (默认)

user_label

字符串

您想要分配给从此模板创建的服务配置文件的用户标签。

username

字符串

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

默认值: "admin"

uuid_pool

字符串

指定如何设置与从此模板创建的服务配置文件关联的服务器上的 UUID。

uuid_pool 选项可以是使用的 UUID 池的名称,也可以是 “”(空字符串)。

空字符串将使用制造商分配给服务器的 UUID,并且

UUID 保持未分配状态,直到从此模板创建的服务配置文件与服务器关联。届时,

UUID 将设置为制造商分配给服务器的 UUID 值。如果服务配置文件稍后移动到

不同的服务器,UUID 将更改以匹配新服务器。”

默认值: "default"

vmedia_policy

字符串

您想要与从此模板创建的服务配置文件关联的 vMedia 策略的名称。

示例

- name: Configure Service Profile Template with LAN/SAN Connectivity and all other options defaulted
  cisco.ucs.ucs_service_profile_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: DEE-Ctrl
    template_type: updating-template
    uuid_pool: UUID-Pool
    storage_profile: DEE-StgProf
    lan_connectivity_policy: Cntr-FC-Boot
    iqn_pool: iSCSI-Boot-A
    san_connectivity_policy: Cntr-FC-Boot
    boot_policy: DEE-vMedia
    maintenance_policy: default
    server_pool: Container-Pool
    host_firmware_package: 3.1.2b
    bios_policy: Docker

- name: Remove Service Profile Template
  cisco.ucs.ucs_service_profile_template:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: DEE-Ctrl
    state: absent

作者

  • David Soper (@dsoper2)

  • CiscoUcs (@CiscoUcs)