dellemc.unity.nfsserver 模块 – 管理 Unity 存储系统上的 NFS 服务器

注意

此模块是 dellemc.unity 集合 (版本 2.0.0) 的一部分。

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

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

要在 playbook 中使用它，请指定：dellemc.unity.nfsserver。

dellemc.unity 1.4.0 中的新增功能

概要

  • 管理 Unity 存储系统上的 NFS 服务器包括创建 NFS 服务器、获取 NFS 服务器详细信息和删除 NFS 服务器属性。

要求

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

  • Dell Unity 存储设备版本 5.1 或更高版本。

  • Ansible-core 2.14 或更高版本。

  • Python 3.9、3.10 或 3.11。

  • Storops Python SDK 1.2.11。

参数

参数

注释

host_name

字符串

NFS 服务器的主机名。

is_extended_credentials_enabled

布尔值

指示是否支持在 Unix 凭据中使用超过 16 个 Unix 组。

选项

  • false

  • true

is_secure_enabled

布尔值

指示是否启用了安全 NFS。

选项

  • false

  • true

kerberos_domain_controller_password

字符串

Kerberos 域控制器管理员密码。

kerberos_domain_controller_type

字符串

用于安全 NFS 服务的 Kerberos 域控制器的类型。

选项

  • "CUSTOM"

  • "UNIX"

  • "WINDOWS"

kerberos_domain_controller_username

字符串

Kerberos 域控制器管理员用户名。

nas_server_id

字符串

将托管 NFS 服务器的 NAS 服务器的 ID。

nas_server_name

字符串

将托管 NFS 服务器的 NAS 服务器的名称。

nfs_server_id

字符串

NFS 服务器的 ID。

nfs_v4_enabled

布尔值

指示是否在 NAS 服务器上启用了 NFSv4。

选项

  • false

  • true

password

字符串 / 必需

Unity 管理服务器的密码。

port

整数

与 Unity 管理服务器进行通信的端口号。

默认值： 443

remove_spn_from_kerberos

布尔值

指示是否从 Kerberos 域控制器中删除 SPN。

选项

  • false

  • true ← (默认)

state

字符串 / 必需

定义 NFS 服务器是否存在。

选项

  • "absent"

  • "present"

unispherehost

字符串 / 必需

Unity 管理服务器的 IP 或 FQDN。

username

字符串 / 必需

Unity 管理服务器的用户名。

validate_certs

别名：verifycert

布尔值

布尔变量，用于指定是否验证 SSL 证书。

true - 指示应验证 SSL 证书。

false - 指示不应验证 SSL 证书。

选项

  • false

  • true ← (默认)

注释

注意

  • 支持check_mode。

  • 不支持 NFS 服务器的修改操作。

  • 当kerberos_domain_controller_type 为 UNIX 时，nfs_server_details 输出中的kdc_type 显示为 null。

  • 此集合中名为“dellemc.unity”的模块旨在支持 Dell Unity 存储平台。

示例

- name: Create NFS server with kdctype as Windows
  dellemc.unity.nfsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    host_name: "dummy_nas23"
    is_secure_enabled: true
    kerberos_domain_controller_type: "WINDOWS"
    kerberos_domain_controller_username: "administrator"
    kerberos_domain_controller_password: "Password123!"
    is_extended_credentials_enabled: true
    nfs_v4_enabled: true
    state: "present"

- name: Create NFS server with kdctype as Unix
  dellemc.unity.nfsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    host_name: "dummy_nas23"
    is_secure_enabled: true
    kerberos_domain_controller_type: "UNIX"
    is_extended_credentials_enabled: true
    nfs_v4_enabled: true
    state: "present"

- name: Get NFS server details
  dellemc.unity.nfsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    state: "present"

- name: Delete NFS server
  dellemc.unity.nfsserver:
    unispherehost: "{{unispherehost}}"
    username: "{{username}}"
    password: "{{password}}"
    validate_certs: "{{validate_certs}}"
    nas_server_name: "dummy_nas"
    kerberos_domain_controller_username: "administrator"
    kerberos_domain_controller_password: "Password123!"
    unjoin_server_account: false
    state: "absent"

返回值

常用返回值已在 此处 记录，以下是此模块特有的字段

键

描述

changed

布尔值

资源是否已更改。

返回：始终

示例： true

nfs_server_details

字典

NFS 服务器的详细信息。

返回：当 NFS 服务器存在时

示例： {"credentials_cache_ttl": "0:15:00", "existed": true, "file_interfaces": {"UnityFileInterfaceList": [{"UnityFileInterface": {"hash": 8778980109421, "id": "if_37"}}]}, "hash": 8778980109388, "host_name": "dummy_nas23.pie.lab.emc.com", "id": "nfs_51", "is_extended_credentials_enabled": true, "is_secure_enabled": true, "kdc_type": "KdcTypeEnum.WINDOWS", "nas_server": {"UnityNasServer": {"hash": 8778980109412}}, "nfs_v4_enabled": true, "servicee_principal_name": null}

credentials_cache_ttl

字符串

凭据缓存刷新超时。分辨率以分钟为单位。默认值为 15 分钟。

返回：成功

existed

布尔值

指示 NFS 服务器是否存在。

返回：成功

host_name

字符串

NFS 服务器的主机名。

返回：成功

id

字符串

NFS 服务器实例的唯一标识符。

返回：成功

is_extended_credentials_enabled

布尔值

指示 NFS 服务器是否支持在 Unix 凭据中使用超过 16 个 Unix 组。

返回：成功

is_secure_enabled

布尔值

指示 NFS 服务器上是否启用了安全 NFS。

返回：成功

kdc_type

字符串

用于安全 NFS 服务的 Kerberos 域控制器的类型。

返回：成功

nfs_v4_enabled

布尔值

指示 NAS 服务器上是否启用了 NFSv4。

返回：成功

servicee_principal_name

字符串

NFS 服务器的服务主体名称 (SPN)。

返回：成功

作者

  • Meenakshi Dembi (@dembim)