vmware_guest_boot_manager – Управление параметрами загрузки заданного виртуального машины

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

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

Обзор

Этот модуль может быть использован для управления параметрами загрузки заданной виртуальной машины.

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
boot_delay -	Значение по умолчанию: 0	Задержка в миллисекундах перед началом последовательности загрузки.
boot_firmware -	Варианты: bios efi	Выбор используемой прошивки для загрузки виртуальной машины.
boot_order -	Значение по умолчанию: []	Список загрузочных устройств.
boot_retry_delay -	Значение по умолчанию: 0	Указывает время в миллисекундах между неудачей загрузки виртуальной машины и последующей попыткой загрузки. Если задано, автоматически установит `boot_retry_enabled` в `True`, так как этот параметр необходим.
boot_retry_enabled boolean	Варианты: нет ← да	Если установлено `True`, виртуальная машина, которая не может загрузиться, попробует загрузиться снова после истечения `boot_retry_delay`. Если установлено `False`, виртуальная машина будет ожидать бесконечно вмешательства пользователя.
enter_bios_setup boolean	Варианты: нет ← да	Если установлено `True`, виртуальная машина автоматически войдёт в BIOS при следующей загрузке. Виртуальная машина сбросит этот флаг, чтобы загрузка машины продолжилась нормально.
hostname string		Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в версии 2.6.
name -		Имя ВМ для работы. Это обязательно, если параметр `uuid` не указан.
name_match -	Варианты: первый ← последний	Если несколько виртуальных машин соответствуют имени, используется первая или последняя найденная.
password string		Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в версии 2.6. Псевдонимы: pass, pwd
port integer добавлено в 2.5	Значение по умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в версии 2.6.
username string		Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в версии 2.6. Псевдонимы: admin, user
uuid -		UUID экземпляра для управления, если известен, это UUID BIOS VMware. Это обязательно, если параметр `name` не указан.
validate_certs boolean	Варианты: нет да ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите в `false` когда сертификаты не доверенны. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в версии 2.6. Если установлено `yes`, убедитесь, что на данном компьютере установлена Python >= 2.7.9.

Примечания

Примечание

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

Примеры

- name: Change virtual machine's boot order and related parameters
  vmware_guest_boot_manager:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    name: testvm
    boot_delay: 2000
    enter_bios_setup: True
    boot_retry_enabled: True
    boot_retry_delay: 22300
    boot_firmware: bios
    boot_order:
      - floppy
      - cdrom
      - ethernet
      - disk
  delegate_to: localhost
  register: vm_boot_order

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

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

Ключ	Возвращаемое значение	Описание
vm_boot_status словарь	всегда	метаданные о порядке загрузки виртуальной машины Пример: {'current_boot_order': ['floppy', 'disk', 'ethernet', 'cdrom'], 'current_boot_delay': 2000, 'current_boot_retry_delay': 22300, 'current_boot_retry_enabled': True, 'current_enter_bios_setup': True, 'current_boot_firmware': 'bios', 'previous_boot_delay': 10, 'previous_boot_retry_delay': 10000, 'previous_boot_retry_enabled': True, 'previous_enter_bios_setup': False, 'previous_boot_firmware': 'bios', 'previous_boot_order': ['ethernet', 'cdrom', 'floppy', 'disk']}

Статус

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

Авторы

Abhijeet Kasurde (@Akasurde) <akasurde@redhat.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.7/modules/vmware_guest_boot_manager_module.html