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”。
要求
执行此模块的主机需要以下要求。
python2 >= 2.7 或 python3 >= 3.6
infinisdk (https://infinisdk.readthedocs.io/en/latest/)
参数
参数 |
注释 |
---|---|
集群名称 |
|
主机名 |
|
卷 LUN。 |
|
Infinibox 用户密码。 |
|
存在时创建映射,不存在时删除,或在状态为 stat 时提供映射的详细信息。 选项
|
|
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