vmware_guest_video – Модификация конфигураций видеокарты указанной виртуальной машины в заданной инфраструктуре vCenter

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

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

Обзор

Этот модуль используется для переконфигурации настроек видеокарты заданной виртуальной машины.
Все параметры и имена объектов VMware чувствительны к регистру.

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
datacenter -	Значение по умолчанию: "ha-datacenter"	Имя дата-центра, к которому принадлежит виртуальная машина. Этот параметр чувствителен к регистру.
display_number -		Номер дисплея. Допустимые значения от 1 до 10. Максимальное значение номера дисплея составляет 4 в vCenter 6.0, 6.5 веб-интерфейсе.
enable_3D boolean	Варианты: no yes	Включить 3D для гостевых операционных систем, для которых VMware поддерживает 3D.
folder -		Папка назначения, абсолютный или относительный путь к существующему гостевому компьютеру. Этот параметр обязателен, только если найдено несколько ВМ с одинаковым именем. Папка должна включать дата-центр. Дата-центр сервера ESXi — ha-datacenter. Примеры: folder: /ha-datacenter/vm folder: ha-datacenter/vm folder: /datacenter1/vm folder: datacenter1/vm folder: /datacenter1/vm/folder1 folder: datacenter1/vm/folder1 folder: /folder1/datacenter1/vm folder: folder1/datacenter1/vm folder: /folder1/datacenter1/vm/folder2
gather_video_facts boolean	Варианты: no ← yes	Если установлено в True, возвращает настройки видеокарты, другие атрибуты игнорируются. Если установлено в False, выполняет переконфигурацию и возвращает настройки видеокарты.
hostname string		Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в Ansible 2.6.
memory_3D_mb -		Значение памяти 3D должно быть степенью двойки и допустимыми значениями являются от 32 МБ до 2048 МБ.
name -		Имя виртуальной машины. Этот параметр обязателен, если параметр `uuid` не задан.
password string		Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd
port integer добавлено в 2.5	Значение по умолчанию: 443	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PORT`. Поддержка переменных окружения добавлена в Ansible 2.6.
renderer_3D -	Варианты: automatic software hardware	Если установлено в `automatic`, автоматически выбирает соответствующий вариант (software или hardware) для этой виртуальной машины. Если установлено в `software`, для 3D-вычислений используется обычная обработка ЦП. Если установлено в `hardware`, для более быстрых 3D-вычислений требуется графическое оборудование (GPU).
use_auto_detect boolean	Варианты: no yes	Если установлено в True, к гостевой операционной системе применяются общие настройки видео, атрибуты `display_number` и `video_memory_mb` игнорируются. Если установлено в False, количество дисплеев и общий объем видеопамяти переконфигурируются с использованием `display_number` и `video_memory_mb`.
username string		Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_USER`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user
uuid -		UUID экземпляра для сбора фактов, если известен, это уникальный идентификатор VMware. Этот параметр обязателен, если параметр `name` не задан.
validate_certs boolean	Варианты: no yes ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите в `false`, когда сертификаты не доверяются. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_VALIDATE_CERTS`. Поддержка переменных окружения добавлена в Ansible 2.6. Если установлено в `yes`, убедитесь, что на данном компьютере установлена Python >= 2.7.9.
video_memory_mb -		Допустимый диапазон общего объема видеопамяти виртуальной машины составляет от 1,172 МБ до 256 МБ в ESXi 6.7U1, от 1,172 МБ до 128 МБ в ESXi 6.7 и более ранних версиях. Для конкретных гостевых ОС поддерживаемые минимальные и максимальные объемы видеопамяти отличаются, будьте осторожны при настройке этого параметра.

Примечания

Примечание

Тестировано на vSphere 6.0, 6.5 и 6.7

Примеры

- name: Change video card settings of virtual machine
  vmware_guest_video:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    validate_certs: no
    name: test-vm
    gather_video_facts: false
    use_auto_detect: false
    display_number: 2
    video_memory_mb: 8.0
    enable_3D: true
    renderer_3D: automatic
    memory_3D_mb: 512
  delegate_to: localhost
  register: video_facts

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

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

Ключ	Возвращенное значение	Описание
video_status словарь	всегда	метаданные о видеокарте виртуальной машины после управления ими Пример: {'auto_detect': False, 'display_number': 2, 'enable_3D_support': True, 'memory_3D': 524288, 'renderer_3D': 'automatic', 'video_memory': 8192}

Статус

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

Авторы

Diane Wang (@Tomorrow9) <dianew@vmware.com>

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/vmware_guest_video_module.html