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

Примечание

Этот плагин входит в коллекцию community.vmware (версия 1.7.0).

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

Для использования в книге задач укажите: community.vmware.vmware_host_datastore.

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

Обзор

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

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
datastore_name строка / обязательно		Имя хранилища данных для добавления/удаления.
datastore_type строка	Варианты: nfs nfs41 vmfs	Тип хранилища данных для настройки (nfs/nfs41/vmfs).
esxi_hostname строка		Хост ESXi для управления хранилищем данных. Требуется при использовании с vcenter
hostname строка		Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в Ansible 2.6.
nfs_path строка		Путь к ресурсу на хосте NFS. Требуется, если тип хранилища данных установлен на `nfs`/`nfs41` и состояние установлено на `present`, в противном случае не используется.
nfs_ro логическое	Варианты: нет ← да	Монтирование в режиме только для чтения или чтения-записи. Не используется, если тип хранилища данных не установлен на `nfs`/`nfs41` и состояние не установлено на `present`.
nfs_server строка		Хост NFS, предоставляющий хранилище данных nfs. Требуется, если тип хранилища данных установлен на `nfs`/`nfs41` и состояние установлено на `present`, в противном случае не используется. Можно определить два или более серверов, если тип хранилища данных установлен на `nfs41`.
password строка		Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_PASSWORD` вместо него. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число	По умолчанию: 443	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_PORT` вместо него. Поддержка переменных окружения добавлена в Ansible 2.6.
proxy_host строка		Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат - имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_PROXY_HOST` вместо него. Эта функция зависит от версии pyvmomi, большей чем v6.7.1.2018.12
proxy_port целое число		Порт HTTP-прокси, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_PROXY_PORT` вместо него.
state строка	Варианты: присутствует ← отсутствует	присутствует: Подключить хранилище данных к хосту, если хранилище данных отсутствует, в противном случае ничего не делать. отсутствует: Отключить хранилище данных, если оно присутствует, в противном случае ничего не делать.
username строка		Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_USER` вместо него. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs логическое	Варианты: нет да ←	Разрешает подключение, когда сертификаты SSL недействительны. Установить на `false`, когда сертификаты не доверяются. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_VALIDATE_CERTS` вместо него. Поддержка переменных окружения добавлена в Ansible 2.6. Если установлено `true`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
vmfs_device_name строка		Имя устройства, которое будет использоваться в качестве хранилища данных VMFS. Необходимо для типа хранилища данных VMFS, и состояние установлено на `present`, в противном случае не используется.
vmfs_version целое число		Версия VMFS для использования при создании хранилища данных. Не используется, если тип хранилища данных не установлен на `vmfs` и состояние не установлено на `present`.

Примечания

Примечание

Проверено на vSphere 6.0, 6.5 и ESXi 6.7
NFS v4.1 протестировано на vSphere 6.5
Аутентификация Kerberos с NFS v4.1 не реализована

Примеры

- 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: no
      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: no
      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: 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) <ludovic.rivallain@gmail.com>
Christian Kotte (@ckotte) <christian.kotte@gmx.de>

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