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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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` ← (по умолчанию)
datastore_name string / обязательный	Имя хранилища данных, которое нужно добавить или удалить.
datastore_type string	Тип настраиваемого хранилища данных (nfs/nfs41/vmfs/vvol). Варианты: `"nfs"` `"nfs41"` `"vmfs"` `"vvol"`
esxi_hostname string	Имя хоста ESXi, на котором нужно управлять хранилищем данных. Обязательный параметр при использовании с vCenter.
hostname string	Имя хоста или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `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` ← (по умолчанию) `true`
nfs_server string	Хост NFS, предоставляющий хранилище данных NFS. Обязателен, если `datastore_type=nfs` / `datastore_type=nfs41` и `state=present`; в противном случае не используется. Можно указать два или более серверов, если `datastore_type=nfs41`
password псевдонимы: pass, pwd string	Пароль сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_PASSWORD`.
port integer	Номер порта сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `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` ← (по умолчанию) `true`
state string	present: смонтировать хранилище данных на хосте, если оно отсутствует; иначе ничего не делать. absent: размонтировать хранилище данных, если оно присутствует; иначе ничего не делать. Варианты: `"present"` ← (по умолчанию) `"absent"`
username псевдонимы: admin, user string	Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_USER`.
validate_certs boolean	Разрешает подключение при недействительных SSL-сертификатах. Установите значение `false`, если сертификатам нельзя доверять. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
vasa_provider string добавлено в community.vmware 3.9.0	Имя хоста или IP-адрес поставщика VASA, используемого для подготовки vVols.
vmfs_device_name string	Имя устройства, которое будет использоваться как хранилище данных VMFS. Обязательно для типа хранилища данных VMFS и `state=present`; в противном случае не используется.
vmfs_version integer	Версия VMFS, используемая при создании хранилища данных. Не используется, если не `datastore_type=vmfs` и не `state=present`.

Примечания

Примечание

Аутентификация Kerberos с NFS v4.1 не реализована.
Для всех модулей требуется доступ на запись через API, поэтому они не поддерживаются при использовании бесплатной лицензии ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.
Модули могут использовать библиотеку Python ‘requests’, которая по умолчанию не применяет системное хранилище сертификатов. Вы можете указать хранилище сертификатов, задав переменную окружения REQUESTS_CA_BUNDLE. Обратите внимание: если эта переменная задана, в некоторых случаях значение ‘false’ параметра ‘validate_certs’ может быть проигнорировано. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’

Примеры

- 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/vmware/vmware_host_datastore_module.html