cisco.ucs.ucs_disk_group_policy 模块 – 在 Cisco UCS Manager 上配置磁盘组策略

注意

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

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

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

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

概要

  • 在 Cisco UCS Manager 上配置磁盘组策略。

要求

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

  • ucsmsdk

参数

参数

注释

configuration_mode

字符串

磁盘组配置模式。选择以下选项之一：

automatic - 自动配置磁盘组中的磁盘。

manual - 允许您手动配置磁盘组中的磁盘。

选项

  • "automatic" ← (默认)

  • "manual"

description

别名：descr

字符串

存储配置文件的用户定义描述。

最多输入 256 个字符。

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

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

drive_type

字符串

指定要在驱动器组中使用的驱动器类型。

可以是以下之一：

unspecified — 选择第一个可用的驱动器类型，并将其应用于组中的所有驱动器。

HDD — 硬盘驱动器

SSD — 固态驱动器

仅当配置模式为 automatic 时才适用。

选项

  • "unspecified" ← (默认)

  • "HDD"

  • "SSD"

hostname

字符串 / 必需

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

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

manual_disks

列表 / 元素=字典

手动配置的磁盘列表。

仅当您选择 manual configuration_mode 时才使用这些选项。

role

字符串

磁盘的角色。可以是以下之一：

normal - 普通

ded-hot-spare - 专用热备盘

glob-hot-spare - 全局热备盘

选项

  • "normal" ← (默认)

  • "ded-hot-spare"

  • "glob-hot-spare"

slot_num

字符串 / 必需

特定磁盘的插槽号。

span_id

字符串

特定磁盘的 Span ID。

默认值： "unspecified"

state

字符串

如果 present，将验证磁盘插槽是否在策略中配置。如果 absent，将验证磁盘插槽是否不在策略中。

选项

  • "present" ← (默认)

  • "absent"

min_drive_size

字符串

指定最小驱动器大小或 unspecified 以允许所有驱动器大小。

可以是 0 到 10240 GB。

仅当配置模式为 automatic 时才适用。

默认值： "unspecified"

name

字符串 / 必需

磁盘组策略的名称。

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

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

策略创建后，不能更改此名称。

num_ded_hot_spares

字符串

指定磁盘组的热备盘数量。

可以是 0 到 24。

仅当配置模式为 automatic 时才适用。

默认值： "unspecified"

num_drives

字符串

指定磁盘组的驱动器数量。

可以是 0 到 24。

仅当配置模式为 automatic 时才适用。

默认值： "1"

num_glob_hot_spares

字符串

指定磁盘组的全局热备盘数量。

可以是 0 到 24。

仅当配置模式为 automatic 时才适用。

默认值： "unspecified"

org_dn

字符串

分配资源的组织的区分名称 (dn)。

默认值： "org-root"

password

字符串 / 必需

Cisco UCS Manager 身份验证的密码。

port

整数

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

proxy

字符串

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

raid_level

字符串

磁盘组策略的 RAID 级别。可以是以下之一：

stripe - UCS Manager 显示 RAID 0 条带化

mirror - RAID 1 镜像

mirror-stripe - RAID 10 镜像和条带化

stripe-parity - RAID 5 条带化奇偶校验

stripe-dual-parity - RAID 6 条带化双奇偶校验

stripe-parity-stripe - RAID 50 条带化奇偶校验和条带化

stripe-dual-parity-stripe - RAID 60 条带化双奇偶校验和条带化

选项

  • "stripe" ← (默认)

  • "mirror"

  • "mirror-stripe"

  • "stripe-parity"

  • "stripe-dual-parity"

  • "stripe-parity-stripe"

  • "stripe-dual-parity-stripe"

state

字符串

磁盘组策略的所需状态。

如果 present，将验证磁盘组策略是否存在，如果需要则创建。

如果 absent，将验证磁盘组策略是否不存在，如果需要则删除。

选项

  • "present" ← (默认)

  • "absent"

use_proxy

布尔值

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

选项

  • false

  • true ← (默认)

use_remaining_disks

字符串

指定是否可以使用磁盘组中所有剩余的磁盘。

仅当配置模式为 automatic 时才适用。

选项

  • "yes"

  • "no" ← (默认)

use_ssl

布尔值

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

选项

  • false

  • true ← (默认)

username

字符串

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

默认值： "admin"

virtual_drive

字典

虚拟驱动器选项的配置。

access_policy

字符串

配置虚拟驱动器的访问策略。

选项

  • "blocked"

  • "hidden"

  • "platform-default" ← (默认)

  • "read-only"

  • "read-write"

  • "transport-ready"

drive_cache

字符串

配置驱动器缓存。

选项

  • "disable"

  • "enable"

  • "no-change"

  • "platform-default" ← (默认)

io_policy

字符串

直接或缓存的 IO 路径。

选项

  • "cached"

  • "direct"

  • "platform-default" ← (默认)

read_policy

字符串

虚拟驱动器的读取访问策略。

选项

  • "normal"

  • "platform-default" ← (默认)

  • "read-ahead"

strip_size

字符串

虚拟驱动器条带大小。

选项

  • "1024KB"

  • "128KB"

  • "16KB"

  • "256KB"

  • "32KB"

  • "512KB"

  • "64KB"

  • "8KB"

  • "platform-default" ← (默认)

write_cache_policy

字符串

写回缓存策略。

选项

  • "always-write-back"

  • "platform-default" ← (默认)

  • "write-back-good-bbu"

  • "write-through"

示例

- name: Configure Disk Group Policy
  cisco.ucs.ucs_disk_group_policy:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: DEE-DG
    raid_level: mirror
    configuration_mode: manual
    manual_disks:
    - slot_num: '1'
      role: normal
    - slot_num: '2'
      role: normal

- name: Remove Disk Group Policy
  cisco.ucs.ucs_disk_group_policy:
    name: DEE-DG
    hostname: 172.16.143.150
    username: admin
    password: password
    state: absent

- name: Remove Disk from Policy
  cisco.ucs.ucs_disk_group_policy:
    hostname: 172.16.143.150
    username: admin
    password: password
    name: DEE-DG
    description: Testing Ansible
    raid_level: stripe
    configuration_mode: manual
    manual_disks:
    - slot_num: '1'
      role: normal
    - slot_num: '2'
      role: normal
      state: absent
    virtual_drive:
      access_policy: platform-default
      io_policy: direct
      strip_size: 64KB

作者

  • Sindhu Sudhir (@sisudhir)

  • David Soper (@dsoper2)

  • CiscoUcs (@CiscoUcs)

  • Brett Johnson (@sdbrett)

  • John McDonough (@movinalot)