cisco.ucs.ucs_server_maintenance 模块 – 在 Cisco UCS 管理器上创建服务器维护策略

注意

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

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

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

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

概要

  • 在 Cisco UCS 管理器上配置服务器维护策略。

要求

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

  • ucsmsdk

参数

参数

注释

description

别名：descr

字符串

服务器维护包策略的描述。

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

最多输入 256 个字符。

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

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

hostname

字符串 / 必需

Cisco UCS 管理器的 IP 地址或主机名。

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

name

字符串 / 必需

分配给服务器维护策略的名称。

服务器维护策略名称区分大小写。

此名称可以介于 1 到 16 个字母数字字符之间。

您不能使用空格或任何特殊字符，但可以使用 -（连字符）、“_”（下划线）、:（冒号）和 .（句点）。

创建服务器维护策略后，您不能更改此名称。

password

字符串 / 必需

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

port

整数

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

proxy

字符串

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

state

字符串

如果 present，将验证服务器维护策略是否存在，如果需要，将创建该策略。

如果 absent，将验证服务器维护策略是否不存在，如果需要，将删除该策略。

选择

  • "present" ←（默认）

  • "absent"

trigger_config

字符串

此选项与用户确认 (user-ack) 或定时器自动 (timer-automatic) 结合使用。

启用“下次启动时”选项后，主机操作系统重启、关闭或服务器重置也会触发关联的 FSM 来应用更改。

请注意，取消选择“下次启动时”选项会禁用 BMC 上的维护策略。

选择

  • "on-next-boot"

uptime_disr

字符串 / 必需

当服务器配置文件与服务器关联时，或者当对关联的服务器配置文件进行更改时，您必须重新启动服务器。

“重新启动策略”字段确定何时重新启动与包含此维护策略的任何服务器配置文件关联的服务器。

选择

  • "immediate"

  • "timer-automatic"

  • "user-ack"

use_proxy

布尔值

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

选择

  • false

  • true ←（默认）

use_ssl

布尔值

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

选择

  • false

  • true ←（默认）

username

字符串

用于 Cisco UCS 管理器身份验证的用户名。

默认值： "admin"

示例

- name: Add Server Maintenance Policy
  cisco.ucs.ucs_server_maintenance:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: user-ack
    uptime_disr: user-ack
    trigger_config: on-next-boot

作者

  • Brett Johnson (@brettjohnson008)