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

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

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

Описание

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

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
add_connected логический добавлен в 2.6	Варианты: нет да ←	Если установлено значение `True`, то хост должен подключаться сразу после добавления. Этот параметр игнорируется, если значение параметра state отлично от `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 строка		Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задании, используется значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в версии 2.6.
password строка		Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задании, используется значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в версии 2.6. псевдонимы: pass, pwd
port целое число добавлен в 2.5	Значение по умолчанию: 443	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задании, используется значение переменной окружения `VMWARE_PORT`. Поддержка переменных окружения добавлена в версии 2.6.
state -	Варианты: present ← absent add_or_reconnect reconnect	Если установлено значение `present`, то добавляется хост, если его нет. Если установлено значение `present`, то ничего не делается, если хост уже существует. Если установлено значение `absent`, то удаляется хост, если он есть. Если установлено значение `absent`, то ничего не делается, если хост уже не существует. Если установлено значение `add_or_reconnect`, то добавляется хост, если его нет, в противном случае подключается повторно. Если установлено значение `reconnect`, то повторно подключается хост, если он есть, в противном случае возникает ошибка.
username строка		Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задании, используется значение переменной окружения `VMWARE_USER`. Поддержка переменных окружения добавлена в версии 2.6. псевдонимы: admin, user
validate_certs логический	Варианты: нет да ←	Разрешает подключение, даже если сертификаты 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
  delegate_to: localhost

- 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
  delegate_to: localhost

- 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
  delegate_to: localhost

- 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
  delegate_to: localhost

- 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
  delegate_to: localhost

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
result строка	при успешном добавлении	Метаданные о добавленной новой хост-системе Пример: 'vim.ComputeResource:domain-s222'

Статус

Гарантия обратной совместимости этого модуля не предоставляется. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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