infinidat.infinibox.infini_map 模块 – 在 Infinibox 上创建和删除卷到主机或集群的映射

注意

此模块是 infinidat.infinibox 集合(版本 1.4.5)的一部分。

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

要安装它,请使用:ansible-galaxy collection install infinidat.infinibox。您需要其他要求才能使用此模块,请参阅 要求 以了解详情。

要在 playbook 中使用它,请指定:infinidat.infinibox.infini_map

infinidat.infinibox 2.9.0 中的新增功能

概要

  • 此模块创建或删除卷到 Infinibox 上的主机或集群的映射。

  • 对于 Linux 主机,调用此模块后,playbook 应在创建映射时在主机上执行“rescan-scsi-bus.sh”。

  • 删除映射时,应调用“rescan-scsi-bus.sh –remove”。

  • 对于 Windows 主机,请考虑使用“'rescan' | diskpart”或“Update-HostStorageCache”。

要求

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

参数

参数

注释

集群

字符串

集群名称

主机

字符串

主机名

LUN

整数

卷 LUN。

密码

字符串 / 必需

Infinibox 用户密码。

状态

字符串

存在时创建映射,不存在时删除,或在状态为 stat 时提供映射的详细信息。

选项

  • "stat"

  • "present" ← (默认)

  • "absent"

系统

字符串 / 必需

Infinibox 主机名或 IPv4 地址。

用户

字符串 / 必需

具有足够权限的 Infinibox 用户用户名(参见备注)。

字符串 / 必需

要映射到主机的卷名。

备注

注意

  • 此模块需要 infinisdk python 库

  • 如果用户和密码参数未直接传递给模块,则必须设置 INFINIBOX_USER 和 INFINIBOX_PASSWORD 环境变量

  • 如果未提供凭据,Ansible 将使用 infinisdk 配置文件 ~/.infinidat/infinisdk.ini。参见 http://infinisdk.readthedocs.io/en/latest/getting_started.html

  • 所有 Infinidat 模块都支持检查模式(–check)。但是,如果资源依赖关系不满足任务的要求,则创建资源的预演可能会失败。例如,考虑一个在池中创建卷的任务。如果池不存在,则卷创建任务将失败。即使 playbook 中有先前的任务可以创建池,但由于池创建也是预演的一部分,它也会失败。

示例

- name: Map a volume to an existing host
  infini_map:
    host: foo.example.com
    volume: bar
    state: present  # Default
    user: admin
    password: secret
    system: ibox001

- name: Map a volume to an existing cluster
  infini_map:
    cluster: test-cluster
    volume: bar
    state: present  # Default
    user: admin
    password: secret
    system: ibox001

- name: Unmap volume bar from host foo.example.com
  infini_map:
    host: foo.example.com
    volume: bar
    state: absent
    system: ibox01
    user: admin
    password: secret

- name: Stat mapping of volume bar to host foo.example.com
  infini_map:
    host: foo.example.com
    volume: bar
    state: stat
    system: ibox01
    user: admin
    password: secret

作者

  • David Ohlemacher (@ohlemacher)