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 для управления хранилищем данных. Требуется при использовании с 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 целое число добавлено в 2.5 | По умолчанию: 443 | Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды VMWARE_PORT. Поддержка переменных среды добавлена в Ansible 2.6. |
| proxy_host строка добавлено в 2.9 | Адрес прокси, который будет получать все запросы HTTPS и пересылать их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, используется значение переменной среды VMWARE_PROXY_HOST. Эта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12. | |
| proxy_port целое число добавлено в 2.9 | Порт HTTP-прокси, который будет получать все запросы HTTPS и пересылать их. Если значение не указано в задаче, используется значение переменной среды VMWARE_PROXY_PORT. | |
| state строка |
| present: Подключить хранилище данных к хосту, если хранилище отсутствует, иначе ничего не делать. absent: Отключить хранилище данных, если хранилище присутствует, иначе ничего не делать. |
| username строка | Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды 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 и ESXi 6.7
- 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 a ESXi
vmware_host_datastore:
hostname: '{{ esxi_hostname }}'
username: '{{ esxi_username }}'
password: '{{ esxi_password }}'
datastore_name: NasDS_vol01
state: absent
delegate_to: localhost
Статус
- Гарантия обратной совместимости этого модуля отсутствует. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Ludovic Rivallain (@lrivallain) <ludovic.rivallain@gmail.com>
- Christian Kotte (@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.9/modules/vmware_host_datastore_module.html