модуль dellemc.openmanage.redfish_firmware — обновление встроенного ПО компонента с помощью файла образа, доступного в локальной или удаленной системе
Примечание
Этот модуль входит в коллекцию dellemc.openmanage (версия 10.0.2).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install dellemc.openmanage. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: dellemc.openmanage.redfish_firmware.
Добавлено в dellemc.openmanage 2.1.0
Краткое описание
- Этот модуль позволяет обновлять встроенное ПО только одного компонента за раз. Если модуль запущен для нескольких компонентов, возвращается сообщение об ошибке.
- В зависимости от компонента обновление встроенного ПО применяется после автоматической или ручной перезагрузки.
Требования
На узле, выполняющем этот модуль, должны быть соблюдены следующие требования.
- python >= 3.9.6
- urllib3
Параметры
Параметр | Комментарии |
|---|---|
baseuri string / обязательный | IP-адрес целевого контроллера внеполосного управления. Например: <ipaddress>:<port>. |
ca_path path добавлено в dellemc.openmanage 5.0.0 | Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA для проверки. |
image_uri string / обязательный | URI расположения образа встроенного ПО или локальный путь к нему. Например: http://<web_address>/components.exe или /home/firmware_repo/component.exe. |
job_wait boolean | Позволяет дождаться завершения задания. Варианты:
|
job_wait_timeout integer | Максимальное время ожидания для job_wait в секундах. Отслеживание задания выполняется только в течение этого времени. Этот параметр применяется, когда job_wait имеет значение Примечание. Если для обновления встроенного ПО требуется перезагрузка, задание будет запланировано и будет ожидать указанное в секундах значение job_wait_time. Чтобы сократить время ожидания, задайте минимальное значение job_wait_time или установите job_wait в значение false и запустите задачу повторно. По умолчанию: |
password string | Пароль целевого контроллера внеполосного управления. Если пароль не указан, используется переменная среды Пример: export IDRAC_PASSWORD=password |
timeout integer добавлено в dellemc.openmanage 5.0.0 | Тайм-аут на уровне сокета в секундах. По умолчанию: |
transfer_protocol string | Протокол, используемый для передачи файла образа встроенного ПО. Применяется при обновлении по URI. Варианты:
|
username string | Имя пользователя целевого контроллера внеполосного управления. Если имя пользователя не указано, используется переменная среды Пример: export IDRAC_USERNAME=username |
validate_certs boolean добавлено в dellemc.openmanage 5.0.0 | Если задано Настраивайте В версиях коллекции до Варианты:
|
x_auth_token string добавлено в dellemc.openmanage 9.3.0 | Токен аутентификации. Если x_auth_token не указан, используется переменная среды Пример: export IDRAC_X_AUTH_TOKEN=x_auth_token |
Примечания
Примечание
- Запускайте этот модуль в системе, имеющей прямой доступ к API Redfish.
- Этот модуль поддерживает адреса IPv4 и IPv6.
- Этот модуль поддерживает только iDRAC9 и более поздние версии.
- Этот модуль не поддерживает
check_mode.
Примеры
---
- name: Update the firmware from a single executable file available in a HTTP protocol
dellemc.openmanage.redfish_firmware:
baseuri: "192.168.0.1"
username: "user_name"
password: "user_password"
ca_path: "/path/to/ca_cert.pem"
image_uri: "http://192.168.0.2/firmware_repo/component.exe"
transfer_protocol: "HTTP"
- name: Update the firmware from a single executable file available in a HTTP protocol with job_Wait
dellemc.openmanage.redfish_firmware:
baseuri: "192.168.0.1"
username: "user_name"
password: "user_password"
ca_path: "/path/to/ca_cert.pem"
image_uri: "http://192.168.0.2/firmware_repo/component.exe"
transfer_protocol: "HTTP"
job_wait: true
job_wait_timeout: 600
- name: Update the firmware from a single executable file available in a local path
dellemc.openmanage.redfish_firmware:
baseuri: "192.168.0.1"
username: "user_name"
password: "user_password"
ca_path: "/path/to/ca_cert.pem"
image_uri: "/home/firmware_repo/component.exe"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
error_info dictionary | Сведения об ошибке HTTP. Возвращается: при ошибке HTTP Пример: |
msg string | Общий статус задачи обновления встроенного ПО. Возвращается: всегда Пример: |
task dictionary | Возвращает идентификатор и URI созданной задачи. Возвращается: при успешном выполнении Пример: |
Ссылки на коллекцию
© 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/dellemc/openmanage/redfish_firmware_module.html