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	Варианты: no ← yes	Если установлено `True`, виртуальная машина, которая не загрузилась, попытается загрузиться снова после истечения `boot_retry_delay`. Если установлено `False`, виртуальная машина будет бесконечно ждать вмешательства пользователя.
enter_bios_setup boolean	Варианты: no ← yes	Если установлено `True`, виртуальная машина автоматически входит в настройку BIOS при следующей загрузке. Виртуальная машина сбрасывает этот флаг, чтобы процесс загрузки машины продолжился нормально.
hostname string		Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в Ansible 2.6.
name -		Имя виртуальной машины, с которой нужно работать. Это обязательно, если параметр `uuid` не указан.
name_match -	Варианты: first ← last	Если несколько виртуальных машин соответствуют имени, используется первая или последняя найденная.
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.
secure_boot_enabled boolean добавлено в 2.8	Варианты: no ← yes	Выберите, должен ли быть включен EFI Secure Boot. EFI Secure Boot может быть включен только при boot_firmware = efi
use_instance_uuid boolean добавлено в 2.8	Варианты: no ← yes	Использовать ли UUID экземпляра VMWare вместо UUID BIOS.

username строка		Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user
uuid -		UUID экземпляра для управления, если известен, по умолчанию — UUID BIOS VMware. Требуется, если параметр `name` не указан.
validate_certs логическое	Варианты: нет да ←	Разрешает подключение, когда сертификаты SSL недействительны. Устанавливается в значение `false`, когда сертификаты не доверяются. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в Ansible 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
    secure_boot_enabled: False
    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', 'current_secure_boot_enabled': False, 'previous_boot_delay': 10, 'previous_boot_retry_delay': 10000, 'previous_boot_retry_enabled': True, 'previous_enter_bios_setup': False, 'previous_boot_firmware': 'efi', 'previous_secure_boot_enabled': True, 'previous_boot_order': ['ethernet', 'cdrom', 'floppy', 'disk']}

Статус

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

Авторы

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.8/modules/vmware_guest_boot_manager_module.html