community.vmware.vmware_host_datastore модуль — Управление хранилищем данных на хосте ESXi

Примечание

Этот модуль входит в коллекцию community.vmware (версия 4.7.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.vmware.

Чтобы использовать его в книге задач, укажите: community.vmware.vmware_host_datastore.

Обзор
Параметры
Примечания
Примеры

Обзор

Этот модуль может использоваться для монтирования/размонтирования хранилища данных на хосте ESXi.
Этот модуль поддерживает только хранилища данных NFS (NFS v3 или NFS v4.1) и VMFS.
Для хранилища данных VMFS необходимо, чтобы соответствующее устройство уже было подключено к хосту ESXi.

Параметры

Параметр	Комментарии
auto_expand boolean	Расширить емкость хранилища данных до полной, если есть свободная емкость. Этот параметр не может быть расширен с помощью другого хранилища данных. Может использоваться для расширения емкости хранилища данных после увеличения объема LUN. Варианты: `false` `true` ← (default)
datastore_name string / required	Имя хранилища данных для добавления/удаления.
datastore_type string	Тип хранилища данных для настройки (nfs/nfs41/vmfs/vvol). Варианты: `"nfs"` `"nfs41"` `"vmfs"` `"vvol"`
esxi_hostname string	Имя хоста ESXi для управления хранилищем данных. Требуется при использовании с vCenter
hostname string	Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST`.
nfs_path string	Путь к ресурсу на хосте NFS. Требуется, если `datastore_type=nfs` / `datastore_type=nfs41` и `state=present`, иначе не используется.
nfs_ro boolean	Только чтение или чтение/запись. Не используется, если тип хранилища данных не установлен в `datastore_type=nfs` / `datastore_type=nfs41` и не `state=present`. Варианты: `false` ← (default) `true`
nfs_server string	Хост NFS, предоставляющий хранилище данных NFS. Требуется, если `datastore_type=nfs` / `datastore_type=nfs41` и `state=present`, иначе не используется. Можно определить два или более серверов, если `datastore_type=nfs41`
password псевдонимы: pass, pwd string	Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD`.
port integer	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT`. По умолчанию: `443`
proxy_host string	Адрес прокси-сервера, который будет получать все HTTPS-запросы и передавать их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_HOST`.
proxy_port integer	Порт HTTP-прокси, который будет получать все HTTPS-запросы и передавать их. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_PORT`.
resignature boolean добавлено в community.vmware 3.9.0	Позволяет принудительно переподписать неразрешенное хранилище данных VMFS, которое уже существует на указанном диске. Не используется, если не `datastore_type=vmfs` и не `state=present`. Варианты: `false` ← (default) `true`
state string	present: Подключить хранилище данных к хосту, если хранилище данных отсутствует, иначе ничего не делать. absent: Отключить хранилище данных, если хранилище данных присутствует, иначе ничего не делать. Варианты: `"present"` ← (default) `"absent"`
username псевдонимы: admin, user string	Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`.
validate_certs boolean	Позволяет подключение, когда SSL-сертификаты недействительны. Установите в `false`, если сертификаты не являются доверенными. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (default)

vasa_provider строка добавлено в community.vmware 3.9.0	имя хоста или IP-адрес поставщика VASA для использования в подготовке vVols
vmfs_device_name строка	Имя устройства, используемого в качестве хранилища VMFS. Необходимо для типа хранилища VMFS и `state=present`, в противном случае не используется.
vmfs_version целое число	Версия VMFS для создания хранилища. Не используется, если не `datastore_type=vmfs` и не `state=present`.

Примечания

Примечание

Аутентификация Kerberos с NFS v4.1 не реализована
Все модули требуют доступа к API для записи и поэтому не поддерживаются на бесплатной лицензии ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.

Примеры

- name: Mount VMFS datastores to ESXi
  community.vmware.vmware_host_datastore:
      hostname: '{{ vcenter_hostname }}'
      username: '{{ vcenter_username }}'
      password: '{{ vcenter_password }}'
      datastore_name: '{{ item.name }}'
      datastore_type: '{{ item.type }}'
      vmfs_device_name: 'naa.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
      vmfs_version: 6
      esxi_hostname: '{{ inventory_hostname }}'
      state: present
  delegate_to: localhost

- name: Mount NFS datastores to ESXi
  community.vmware.vmware_host_datastore:
      hostname: '{{ vcenter_hostname }}'
      username: '{{ vcenter_username }}'
      password: '{{ vcenter_password }}'
      datastore_name: '{{ item.name }}'
      datastore_type: '{{ item.type }}'
      nfs_server: '{{ item.server }}'
      nfs_path: '{{ item.path }}'
      nfs_ro: false
      esxi_hostname: '{{ inventory_hostname }}'
      state: present
  delegate_to: localhost
  loop:
      - { 'name': 'NasDS_vol01', 'server': 'nas01', 'path': '/mnt/vol01', 'type': 'nfs'}
      - { 'name': 'NasDS_vol02', 'server': 'nas01', 'path': '/mnt/vol02', 'type': 'nfs'}

- name: Mount NFS v4.1 datastores to ESXi
  community.vmware.vmware_host_datastore:
      hostname: '{{ vcenter_hostname }}'
      username: '{{ vcenter_username }}'
      password: '{{ vcenter_password }}'
      datastore_name: '{{ item.name }}'
      datastore_type: '{{ item.type }}'
      nfs_server: '{{ item.server }}'
      nfs_path: '{{ item.path }}'
      nfs_ro: false
      esxi_hostname: '{{ inventory_hostname }}'
      state: present
  delegate_to: localhost
  loop:
      - { 'name': 'NasDS_vol03', 'server': 'nas01,nas02', 'path': '/mnt/vol01', 'type': 'nfs41'}
      - { 'name': 'NasDS_vol04', 'server': 'nas01,nas02', 'path': '/mnt/vol02', 'type': 'nfs41'}

- name: Mount vVols datastore to ESXi
  community.vmware.vmware_host_datastore:
      hostname: '{{ vcenter_hostname }}'
      username: '{{ vcenter_username }}'
      password: '{{ vcenter_password }}'
      datastore_name: myvvolds
      datastore_type: vvol
      vasa_provider: pure-X90a
      esxi_hostname: esxi-1
      state: absent
  delegate_to: localhost

- name: Mount unresolved VMFS datastores to ESXi
  community.vmware.vmware_host_datastore:
      hostname: '{{ vcenter_hostname }}'
      username: '{{ vcenter_username }}'
      password: '{{ vcenter_password }}'
      datastore_name: mydatastore01
      vmfs_device_name: 'naa.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
      vmfs_version: 6
      esxi_hostname:  esxi01
      resignature: true
      state: present
  delegate_to: localhost

- name: Remove/Umount Datastores from a ESXi
  community.vmware.vmware_host_datastore:
      hostname: '{{ esxi_hostname }}'
      username: '{{ esxi_username }}'
      password: '{{ esxi_password }}'
      datastore_name: NasDS_vol01
      state: absent
  delegate_to: localhost

Авторы

Ludovic Rivallain (@lrivallain)
Christian Kotte (@ckotte)
Eugenio Grosso (@genegr)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/vmware/vmware_host_datastore_module.html