vmware_host_datastore - Управление хранилищем данных на узле ESXi
Новое в версии 2.5.
Обзор
- Этот модуль можно использовать для подключения/отключения хранилища данных на узле ESXi.
- Этот модуль поддерживает только типы хранилищ NFS/VMFS.
- Для хранилища VMFS необходимо, чтобы соответствующее устройство уже было подключено к узлу ESXi.
- Все параметры и имена объектов VMware чувствительны к регистру.
Требования
Ниже перечислены требования к узлу, на котором будет выполняться этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| datacenter_name обязательно | Имя центров обработки данных, которому добавить хранилище. | |
| datastore_name обязательно | Имя хранилища данных для добавления/удаления. | |
| datastore_type обязательно |
| Тип хранилища данных для настройки (nfs/vmfs). |
| esxi_hostname обязательно | Имя хоста ESXi для управления хранилищем данных. | |
| hostname | Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды VMWARE_HOST. Переменная среды поддерживается начиная с версии 2.6. | |
| nfs_path | Путь к ресурсу на хосте NFS. Требуется, если тип хранилища данных задан как nfs и состояние задано как present, в противном случае не используется. | |
| nfs_ro |
| Подключение в режиме только для чтения или чтения/записи. Не используется, если тип хранилища данных не nfs и состояние не present. |
| nfs_server | Хост NFS, предоставляющий хранилище nfs. Требуется, если тип хранилища данных задан как nfs и состояние задано как present, в противном случае не используется. | |
| password | Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды VMWARE_PASSWORD. Переменная среды поддерживается начиная с версии 2.6. Псевдонимы: pass, pwd | |
| port (добавлено в 2.5) | По умолчанию: 443 | Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды VMWARE_PORT. Переменная среды поддерживается начиная с версии 2.6. |
| state |
| present: Подключить хранилище на хосте, если хранилище отсутствует, иначе ничего не делать. absent: Отключить хранилище, если оно существует, иначе ничего не делать. |
| username | Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды VMWARE_USER. Переменная среды поддерживается начиная с версии 2.6. Псевдонимы: user, admin | |
| validate_certs |
True | Разрешает подключение, когда сертификаты SSL недействительны. Установите в false, когда сертификаты не доверенны.Если значение не указано в задаче, используется значение переменной среды VMWARE_VALIDATE_CERTS. Переменная среды поддерживается начиная с версии 2.6. |
| 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
Статус
Этот модуль помечен как экспериментальный, что означает, что он не гарантирует обратную совместимость.
Автор
- Ludovic Rivallain <ludovic.rivallain@gmail.com> @lrivallain
Подсказка
Если вы обнаружили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/vmware_host_datastore_module.html