community.vmware.vmware_drs_group – Создаёт группу vm/host в заданном кластере.

Примечание

Этот плагин входит в коллекцию community.vmware (версия 1.6.0).

Для его установки используйте: ansible-galaxy collection install community.vmware

Для использования в playbook укажите: community.vmware.vmware_drs_group

Описание
Требования
Параметры
Примечания
Примеры
Значения возврата

Описание

Этот модуль может быть использован для создания групп VM/Host в заданном кластере. Создаёт группу vm, если vms установлено. Создаёт группу host, если hosts установлено.

Требования

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

python >= 2.7
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cluster_name строка / обязательно		Кластер для создания группы vm/host.
datacenter строка		Центр обработки данных для поиска заданного кластера. Если не задано, используется первый встреченный кластер с `cluster_name` псевдонимы: datacenter_name
group_name строка / обязательно		Имя группы для создания или удаления.
hostname строка		Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST` Поддержка переменных среды добавлена в Ansible 2.6.
hosts список / элементы=строка		Список хостов для создания в группе. Требуется только если `vms` не задан.
password строка		Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD` Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число	По умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT` Поддержка переменных среды добавлена в Ansible 2.6.
proxy_host строка		Адрес прокси, который будет получать все запросы HTTPS и пересылать их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_HOST` Эта функция зависит от версии pyvmomi, большей чем v6.7.1.2018.12
proxy_port целое число		Порт HTTP-прокси, который будет получать все запросы HTTPS и пересылать их. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_PORT`
state строка	Варианты: present ← absent	Если установлено `present`, и группа не существует, то группа будет создана. Если установлено `absent`, и группа существует, то группа будет удалена.
username строка		Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER` Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs логический тип	Варианты: no yes ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите значение `false`, когда сертификаты ненадёжны. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS` Поддержка переменных среды добавлена в Ansible 2.6. Если установлено `true`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
vms список / элементы=строка		Список vm для создания в группе. Требуется только если `hosts` не задан.

Примечания

Примечание

Проверено на vSphere 6.5 и 6.7

Примеры

---
- name: "Create DRS VM group"
  delegate_to: localhost
  community.vmware.vmware_drs_group:
    hostname: "{{ vcenter_hostname }}"
    password: "{{ vcenter_password }}"
    username: "{{ vcenter_username }}"
    cluster_name: DC0_C0
    datacenter_name: DC0
    group_name: TEST_VM_01
    vms:
      - DC0_C0_RP0_VM0
      - DC0_C0_RP0_VM1
    state: present

- name: "Create DRS Host group"
  delegate_to: localhost
  community.vmware.vmware_drs_group:
    hostname: "{{ vcenter_hostname }}"
    password: "{{ vcenter_password }}"
    username: "{{ vcenter_username }}"
    cluster_name: DC0_C0
    datacenter_name: DC0
    group_name: TEST_HOST_01
    hosts:
      - DC0_C0_H0
      - DC0_C0_H1
      - DC0_C0_H2
    state: present

- name: "Delete DRS Host group"
  delegate_to: localhost
  community.vmware.vmware_drs_group:
    hostname: "{{ vcenter_hostname }}"
    password: "{{ vcenter_password }}"
    username: "{{ vcenter_username }}"
    cluster_name: DC0_C0
    datacenter_name: DC0
    group_name: TEST_HOST_01
    state: absent

Значения возврата

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

Ключ	Возвращаемое значение	Описание
drs_group_facts словарь	всегда	Метаданные о созданной группе DRS Пример: {'drs_group_facts': {'changed': True, 'failed': False, 'msg': 'Успешно создана группа хостов TEST_HOST_01', 'result': {'DC0_C0': [{'group_name': 'TEST_HOST_01', 'hosts': ['DC0_C0_H0', 'DC0_C0_H1', 'DC0_C0_H2'], 'type': 'host'}]}}}

Авторы

Karsten Kaj Jakobsen (@karstenjakobsen)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/vmware/vmware_drs_group_module.html