community.vmware.vmware_drs_group – Создаёт группу виртуальных машин/хостов в заданном кластере.

Примечание

Этот плагин является частью коллекции community.vmware (версия 1.7.0).

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

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

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

Обзор

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

Требования

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

python >= 2.7
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cluster_name строка / обязательно		Кластер для создания группы виртуальных машин/хостов.
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 список / элементы=строка		Список виртуальных машин для создания в группе. Требуется только если `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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/vmware/vmware_drs_group_module.html