community.general.ipmi_boot модуль — Управление порядком загрузки устройств

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general. Для использования этого модуля потребуются дополнительные требования, см. Требования для получения подробностей.

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

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

Описание

Используйте этот модуль для управления порядком загрузки устройств

Требования

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

pyghmi

Параметры

Параметр	Комментарии
bootdev строка / обязательно	Установить устройство загрузки для следующей перезагрузки Возможные значения для устройства: - network – Запросить загрузку по сети - floppy – Загрузить с дискеты - hd – Загрузить с жёсткого диска - safe – Загрузить с жёсткого диска, запросив «безопасный режим» - optical – загрузить с привода CD/DVD/BD - setup – Загрузить в утилиту настройки - default – удалить любой запрос на загрузку с устройства IPMI Варианты: `"network"` `"floppy"` `"hd"` `"safe"` `"optical"` `"setup"` `"default"`
key строка добавлено в community.general 4.1.0	Ключ шифрования для подключения к BMC в шестнадцатеричном формате.
name строка / обязательно	Имя хоста или IP-адрес BMC.
password строка / обязательно	Пароль для подключения к BMC.
persistent логическое	Если установлено, запросить, чтобы системная прошивка использовала это устройство после следующей загрузки. Имейте в виду, что многие системы не учитывают этот параметр. Варианты: `false` ← (по умолчанию) `true`
port целое число	Порт удалённого RMCP. По умолчанию: `623`
state строка	Указывает, необходимо ли гарантировать, что устройство загрузки необходимо. Возможные значения для параметра state: - present – Запросить включение системы - absent – Запросить включение системы Варианты: `"present"` ← (по умолчанию) `"absent"`
uefiboot логическое	Если установлено, явно запросить загрузку UEFI. Строго говоря, спецификация предполагает, что если не установлено, система должна загрузиться в BIOS и не предлагает опцию «не важно». На практике, если этот флаг не установлен, это не исключает загрузку UEFI ни в одной системе, с которой я сталкивался. Варианты: `false` ← (по умолчанию) `true`
user строка / обязательно	Имя пользователя для подключения к BMC.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в `check_mode` и возвращать прогноз статуса изменения без модификации целевого объекта.
diff_mode	Поддержка: нет	Возвращает подробности о том, что изменилось (или, возможно, нуждается в изменении в `check_mode`), когда режим diff включён.

Примеры

- name: Ensure bootdevice is HD
  community.general.ipmi_boot:
    name: test.testdomain.com
    user: admin
    password: password
    bootdev: hd

- name: Ensure bootdevice is not Network
  community.general.ipmi_boot:
    name: test.testdomain.com
    user: admin
    password: password
    key: 1234567890AABBCCDEFF000000EEEE12
    bootdev: network
    state: absent

Значения возврата

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

Ключ	Описание
bootdev строка	Имя устройства загрузки, которое будет использоваться при следующей загрузке. Возвращается при: успехе Пример: `"default"`
persistent логическое	Если True, системное ПО будет использовать это устройство после следующей загрузки. Возвращается при: успехе Пример: `false`
uefimode логическое	Если True, системное ПО будет использовать загрузку UEFI явно после следующей загрузки. Возвращается при: успехе Пример: `false`

Авторы

Булат Гафуллин (@bgaifullin)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/ipmi_boot_module.html