vmware_host_datastore - Управление хранилищем данных на хосте ESXi

Новое в версии 2.5.

Обзор
- Требования
Параметры
Примечания
Примеры
Статус
Техническое обслуживание
- Автор

Обзор

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

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
datacenter_name обязательно		Имя центру обработки данных для добавления хранилища данных.
datastore_name обязательно		Имя хранилища данных для добавления/удаления.
datastore_type обязательно	Варианты: nfs vmfs	Тип хранилища данных для настройки (nfs/vmfs).
esxi_hostname обязательно		Имя хоста ESXi для управления хранилищем данных.
hostname str		Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в версии 2.6.
nfs_path		Путь к ресурсу на хосте NFS. Требуется, если тип хранилища установлен на `nfs` и состояние установлено на `present`, в противном случае не используется.
nfs_ro bool	Варианты: нет ← да	Подключение в режиме только для чтения или чтения/записи. Не используется, если тип хранилища не установлен на `nfs` и состояние не установлено на `present`.
nfs_server		Хост NFS, предоставляющий хранилище данных nfs. Требуется, если тип хранилища установлен на `nfs` и состояние установлено на `present`, в противном случае не используется.
password str		Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: pass, pwd
port int (добавлено в 2.5)	По умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в версии 2.6.
state	Варианты: present ← absent	present: Подключить хранилище данных к хосту, если хранилище отсутствует, иначе ничего не делать. absent: Отключить хранилище данных, если хранилище присутствует, иначе ничего не делать.
username str		Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: admin, user
validate_certs bool	Варианты: нет да ←	Разрешает подключение, когда сертификаты SSL недействительны. Установить на `false`, когда сертификаты не доверяются. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в версии 2.6. Если установлено значение `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
vmfs_device_name		Имя устройства, которое будет использоваться в качестве хранилища данных VMFS. Требуется для типа хранилища VMFS, если состояние установлено на `present`, в противном случае не используется.
vmfs_version		Версия VMFS для создания хранилища данных. Не используется, если тип хранилища не установлен на `vmfs` и состояние не установлено на `present`.

Примечания

Примечание

Тестировано на vSphere 6.0 и 6.5

Примеры

- name: Mount VMFS datastores to ESXi
  vmware_host_datastore:
      hostname: '{{ vcenter_hostname }}'
      username: '{{ vcenter_user }}'
      password: '{{ vcenter_pass }}'
      datacenter_name: '{{ datacenter }}'
      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
  vmware_host_datastore:
      hostname: '{{ vcenter_hostname }}'
      username: '{{ vcenter_user }}'
      password: '{{ vcenter_pass }}'
      datacenter_name: '{{ datacenter }}'
      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
  with_items:
      - { 'name': 'NasDS_vol01', 'server': 'nas01', 'path': '/mnt/vol01', 'type': 'nfs'}
      - { 'name': 'NasDS_vol02', 'server': 'nas01', 'path': '/mnt/vol02', 'type': 'nfs'}

- name: Remove/Umount Datastores from ESXi
  vmware_host_datastore:
      hostname: '{{ vcenter_hostname }}'
      username: '{{ vcenter_user }}'
      password: '{{ vcenter_pass }}'
      datacenter_name: '{{ datacenter }}'
      datastore_name: NasDS_vol01
      esxi_hostname: '{{ inventory_hostname }}'
      state: absent
  delegate_to: localhost

Статус

Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Смотрите Техническое обслуживание и поддержка модулей для получения дополнительной информации.

Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.

Автор

Людовик Риваллан (@lrivallain) <ludovic.rivallain@gmail.com>

Подсказка

Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/vmware_host_datastore_module.html