vmware_host_datastore – Управление хранилищем данных на хосте ESXi
Новая версия 2.5.
Обзор
- Этот модуль может использоваться для подключения/отключения хранилища данных на хосте ESXi.
- Этот модуль поддерживает только хранилища данных NFS (NFS v3 или NFS v4.1) и VMFS.
- Для хранилища данных VMFS необходимо, чтобы соответствующее устройство уже было подключено к хосту ESXi.
- Все параметры и имена объектов VMware чувствительны к регистру.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| datacenter_name - | Имя центров обработки данных для добавления хранилища данных. Центр обработки данных не используется API для создания хранилища данных. Будет удален в версии 2.11. | |
| datastore_name - / обязательно | Имя хранилища данных для добавления/удаления. | |
| datastore_type - / обязательно |
| Тип хранилища данных для настройки (nfs/nfs41/vmfs). |
| esxi_hostname - / обязательно | Имя хоста ESXi для управления хранилищем данных. | |
| hostname строка | Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задании, используется значение переменной среды 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 строка | Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задании, используется значение переменной среды VMWARE_PASSWORD.Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd | |
| port целое число добавлено в 2.5 | По умолчанию: 443 | Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задании, используется значение переменной среды VMWARE_PORT.Поддержка переменных среды добавлена в Ansible 2.6. |
| state - |
| present: Подключить хранилище данных к хосту, если хранилища данных нет, в противном случае ничего не делать. absent: Отключить хранилище данных, если хранилище данных существует, в противном случае ничего не делать. |
| username строка | Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задании, используется значение переменной среды VMWARE_USER.Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user | |
| validate_certs логическое значение |
| Разрешает подключение, когда сертификаты SSL недействительны. Установите значение false, когда сертификаты не доверяются.Если значение не указано в задании, используется значение переменной среды VMWARE_VALIDATE_CERTS.Поддержка переменных среды добавлена в Ansible 2.6. Если установлено значение yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
| vmfs_device_name - | Имя устройства, используемого в качестве хранилища данных VMFS. Требуется для типа хранилища данных VMFS, и состояние установлено на present, в противном случае не используется. | |
| vmfs_version - | Версия VMFS, используемая для создания хранилища данных. Не используется, если тип хранилища данных не установлен на vmfs и состояние не установлено на present. |
Примечания
Примечание
- Проверено на vSphere 6.0 и 6.5
- NFS v4.1 протестирован на vSphere 6.5
- Аутентификация Kerberos с NFS v4.1 не реализована
Примеры
- name: Mount VMFS datastores to ESXi
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
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
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 ESXi
vmware_host_datastore:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datastore_name: NasDS_vol01
esxi_hostname: '{{ inventory_hostname }}'
state: absent
delegate_to: localhost
Статус
- Гарантируется, что у этого модуля не будет обратной совместимости. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Людовик Риваллан (@lrivallain) <ludovic.rivallain@gmail.com>
- Кристиан Котте (@ckotte) <christian.kotte@gmx.de>
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/vmware_host_datastore_module.html