vmware_host - Добавление/удаление хоста ESXi в/из vCenter

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

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

Обзор

Этот модуль может быть использован для добавления/удаления/переподключения хоста ESXi к/из vCenter.

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cluster_name обязательно		Имя кластера для добавления хоста. Обязательный параметр с версии 2.5.
datacenter_name обязательно		Имя датацентра для добавления хоста.
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.
hostname		Имя хоста или IP-адрес сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_HOST`. Поддержка переменной окружения добавлена в версии 2.6.
password		Пароль сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменной окружения добавлена в версии 2.6. псевдонимы: pass, pwd
port (добавлено в 2.5)	По умолчанию: 443	Порт сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PORT`. Поддержка переменной окружения добавлена в версии 2.6.
state	Варианты: present ← absent add_or_reconnect reconnect	present: добавить хост, если его нет, иначе ничего не делать. absent: удалить хост, если он есть, иначе ничего не делать. add_or_reconnect: добавить хост, если его нет, иначе переподключиться. reconnect: переподключить хост, если он есть, иначе ошибка.
username		Имя пользователя сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_USER`. Поддержка переменной окружения добавлена в версии 2.6. псевдонимы: user, admin
validate_certs	Варианты: no yes По умолчанию: True	Разрешает подключение, когда SSL-сертификаты недействительны. Установить в `false` когда сертификаты не доверяются. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_VALIDATE_CERTS`. Поддержка переменной окружения добавлена в версии 2.6.

Примечания

Примечание

Тестировалось на vSphere 5.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: 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

Статус

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

Автор

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.5/modules/vmware_host_module.html