community.vmware.vmware_resource_pool – Добавление/удаление пулов ресурсов в/из vCenter

Примечание

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

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

Чтобы использовать его в книге задач, укажите: community.vmware.vmware_resource_pool.

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

Краткое описание

Этот модуль может быть использован для добавления/удаления пула ресурсов в/из vCenter

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
cluster строка		Имя кластера для настройки пула ресурсов. Этот параметр обязателен, если `esxi_hostname` не указан.
cpu_allocation_shares целое число добавлен в 1.4.0 community.vmware	По умолчанию: 4000	Количество выделенных долей ЦП. Это значение устанавливается только если cpu_shares задано `custom`.
cpu_expandable_reservations логический тип	Варианты: no yes ←	В пуле ресурсов с расширяемым резервом, резерв в пуле ресурсов может увеличиваться за пределы заданного значения.
cpu_limit целое число	По умолчанию: -1	Использование виртуальной машины/пула ресурсов не превысит этот лимит, даже если имеются доступные ресурсы. Значение по умолчанию -1 означает отсутствие лимита.
cpu_reservation целое число	По умолчанию: 0	Количество ресурсов, гарантированно доступных для виртуальной машины или пула ресурсов.
cpu_shares строка	Варианты: high custom low normal ←	Доли памяти используются в случае конкуренции за ресурсы.
datacenter строка / обязательно		Имя датацентра.
esxi_hostname строка добавлен в 1.5.0 community.vmware		Имя хоста для настройки пула ресурсов. Хост не должен быть членом кластера. Этот параметр обязателен, если `cluster` не указан.
hostname строка		Имя хоста или IP-адрес сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в Ansible 2.6.
mem_allocation_shares целое число добавлен в 1.4.0 community.vmware	По умолчанию: 163840	Количество выделенных долей памяти. Это значение устанавливается только если mem_shares задано `custom`.
mem_expandable_reservations логический тип	Варианты: no yes ←	В пуле ресурсов с расширяемым резервом, резерв в пуле ресурсов может увеличиваться за пределы заданного значения.
mem_limit целое число	По умолчанию: -1	Использование виртуальной машины/пула ресурсов не превысит этот лимит, даже если имеются доступные ресурсы. Значение по умолчанию -1 означает отсутствие лимита.
mem_reservation целое число	По умолчанию: 0	Количество ресурсов, гарантированно доступных для виртуальной машины или пула ресурсов.
mem_shares строка	Варианты: high custom low normal ←	Доли памяти используются в случае конкуренции за ресурсы.
password строка		Пароль сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число	По умолчанию: 443	Номер порта сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `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`.
resource_pool строка / обязательно		Имя пула ресурсов для управления.
state строка	Варианты: present ← absent	Добавление или удаление пула ресурсов
username строка		Имя пользователя сервера vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_USER`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs логический тип	Варианты: no yes ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите значение `false`, когда сертификаты не доверяются. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_VALIDATE_CERTS`. Поддержка переменных окружения добавлена в Ansible 2.6. Если установлено `true`, убедитесь, что Python >= 2.7.9 установлен на данном компьютере.

Примечания

Примечание

Тестировалось на vSphere 6.5

Примеры

- name: Add resource pool to vCenter
  community.vmware.vmware_resource_pool:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    datacenter: '{{ datacenter_name }}'
    cluster: '{{ cluster_name }}'
    resource_pool: '{{ resource_pool_name }}'
    mem_shares: normal
    mem_limit: -1
    mem_reservation: 0
    mem_expandable_reservations: true
    cpu_shares: normal
    cpu_limit: -1
    cpu_reservation: 0
    cpu_expandable_reservations: true
    state: present
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
instance словарь	всегда	метаданные о новом пуле ресурсов Пример: None
resource_pool_config словарь	всегда	данные конфигурации пула ресурсов, версия добавлена 1.4.0 Пример: { "_vimtype": "vim.ResourceConfigSpec", "changeVersion": null, "cpuAllocation": { "_vimtype": "vim.ResourceAllocationInfo", "expandableReservation": true, "limit": -1, "overheadLimit": null, "reservation": 0, "shares": { "_vimtype": "vim.SharesInfo", "level": "normal", "shares": 4000 } }, "entity": "vim.ResourcePool:resgroup-1108", "lastModified": null, "memoryAllocation": { "_vimtype": "vim.ResourceAllocationInfo", "expandableReservation": true, "limit": -1, "overheadLimit": null, "reservation": 0, "shares": { "_vimtype": "vim.SharesInfo", "level": "high", "shares": 327680 } }, "name": "test_pr1", "scaleDescendantsShares": null }

Авторы

Davis Phillips (@dav1x)

© 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_resource_pool_module.html