vmware_host — Добавление/удаление хоста ESXi в/из vCenter
Новое в версии 2.0.
Обзор
- Этот модуль можно использовать для добавления/удаления/переподключения хоста ESXi в/из vCenter.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| add_connected bool (добавлено в 2.6) |
| Если установлено в True, то хост должен быть подключен сразу после добавления.Этот параметр игнорируется, если состояние установлено в значение, отличное от present. |
| cluster_name | Имя кластера для добавления хоста. Если folder не задан, то этот параметр обязателен.Псевдонимы добавлены в версии 2.6. псевдонимы: кластер | |
| datacenter_name обязательно | Имя дата-центра для добавления хоста. Псевдонимы добавлены в версии 2.6. псевдонимы: дата-центр | |
| esxi_hostname обязательно | Имя хоста ESXi для управления. | |
| esxi_password | Пароль ESXi. Требуется для добавления хоста. Необязательно для переподключения. Не используется для удаления. Больше не является обязательным параметром с версии 2.5. | |
| esxi_ssl_thumbprint (добавлено в 2.5) | Значение по умолчанию: "" | Указание отпечатка сертификата хоста. Используйте следующую команду для получения отпечатка сертификата хоста — # openssl x509 -in /etc/vmware/ssl/rui.crt -fingerprint -sha1 -noout |
| esxi_username | Имя пользователя ESXi. Требуется для добавления хоста. Необязательно для переподключения. Не используется для удаления. Больше не является обязательным параметром с версии 2.5. | |
| folder (добавлено в 2.6) | Имя папки, в которой добавить хост. Если cluster_name не задан, то этот параметр обязателен.Например, если есть дата-центр 'dc1' в папке 'Site1', то значением будет '/Site1/dc1/host'. Здесь 'host' — невидимая папка в VMware Web Client. Еще один пример: если есть вложенная структура папок, например, '/myhosts/india/pune' в дата-центре 'dc2', то значение folder будет '/dc2/host/myhosts/india/pune'.Другие примеры: - '/Site2/dc2/Asia-Cluster/host' - '/dc3/Asia-Cluster/host' | |
| hostname str | Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды VMWARE_HOST. Поддержка переменных среды добавлена в версии 2.6. | |
| password str | Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды VMWARE_PASSWORD. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: pass, pwd | |
| port int (добавлено в 2.5) | Значение по умолчанию: 443 | Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды VMWARE_PORT. Поддержка переменных среды добавлена в версии 2.6. |
| state |
| Если установлено в present, то добавить хост, если он отсутствует.Если установлено в present, то ничего не делать, если хост уже существует.Если установлено в absent, то удалить хост, если он присутствует.Если установлено в absent, то ничего не делать, если хост уже не существует.Если установлено в add_or_reconnect, то добавить хост, если он отсутствует, иначе переподключить его.Если установлено в reconnect, то переподключить хост, если он присутствует, иначе прервать выполнение. |
| username str | Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной среды VMWARE_USER. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: admin, user | |
| validate_certs bool |
| Разрешает подключение, когда сертификаты SSL недействительны. Установите в false, когда сертификаты не доверяются.Если значение не указано в задаче, используется значение переменной среды VMWARE_VALIDATE_CERTS. Поддержка переменных среды добавлена в версии 2.6. Если установлено в yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
Примечания
Примечание
- Проверено на vSphere 5.5, 6.0 и 6.5
Примеры
- name: Add ESXi Host to vCenter
vmware_host:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter_name: datacenter_name
cluster_name: cluster_name
esxi_hostname: '{{ esxi_hostname }}'
esxi_username: '{{ esxi_username }}'
esxi_password: '{{ esxi_password }}'
state: present
- name: Add ESXi Host to vCenter under a specific folder
vmware_host:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter_name: datacenter_name
folder: '/Site2/Asia-Cluster/host'
esxi_hostname: '{{ esxi_hostname }}'
esxi_username: '{{ esxi_username }}'
esxi_password: '{{ esxi_password }}'
state: present
add_connected: True
- name: Reconnect ESXi Host (with username/password set)
vmware_host:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter_name: datacenter_name
cluster_name: cluster_name
esxi_hostname: '{{ esxi_hostname }}'
esxi_username: '{{ esxi_username }}'
esxi_password: '{{ esxi_password }}'
state: reconnect
- name: Reconnect ESXi Host (with default username/password)
vmware_host:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter_name: datacenter_name
cluster_name: cluster_name
esxi_hostname: '{{ esxi_hostname }}'
state: reconnect
- name: Add ESXi Host with SSL Thumbprint to vCenter
vmware_host:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter_name: datacenter_name
cluster_name: cluster_name
esxi_hostname: '{{ esxi_hostname }}'
esxi_username: '{{ esxi_username }}'
esxi_password: '{{ esxi_password }}'
esxi_ssl_thumbprint: "3C:A5:60:6F:7A:B7:C4:6C:48:28:3D:2F:A5:EC:A3:58:13:88:F6:DD"
state: present
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| result str | при успешном добавлении | метаданные о добавленном новом хосте Пример: 'vim.ComputeResource:domain-s222' |
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Joseph Callen (@jcpowermac)
- Russell Teague (@mtnbikenc)
- Maxime de Roucy (@tchernomax)
Подсказка
Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать его, чтобы улучшить его.
© 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_module.html
