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

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.general. Для работы с этим модулем необходимы дополнительные требования; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.general.ipmi_boot.

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

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

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

Требования

На узле, выполняющем этот модуль, должны быть соблюдены следующие требования.

pyghmi

Параметры

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

Атрибуты

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

Примеры

- 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 string	Имя загрузочного устройства, используемого после следующей загрузки. Возвращается: при успехе Пример: `"default"`
persistent boolean	Если `true`, микропрограмма системы использует это устройство и после следующей загрузки. Возвращается: при успехе Пример: `false`
uefimode boolean	Если `true`, микропрограмма системы явно использует загрузку UEFI и после следующей загрузки. Возвращается: при успехе Пример: `false`

Авторы

Bulat Gaifullin (@bgaifullin)

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

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