dellemc.openmanage.redfish_firmware_rollback модуль — для отката прошивки компонента по имени

Примечание

Этот модуль является частью коллекции dellemc.openmanage (версия 9.7.0).

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

Чтобы установить ее, используйте: ansible-galaxy collection install dellemc.openmanage. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

Для использования в плейбуке укажите: dellemc.openmanage.redfish_firmware_rollback.

Новый в dellemc.openmanage 8.2.0

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

Описание

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

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
baseuri строка / обязательно	IP-адрес целевого контроллера вне зоны. Например - <ipaddress>:<port>.
ca_path путь добавлен в dellemc.openmanage 5.0.0	Файл сертификата CA в формате PEM, который используется для валидации.
name строка / обязательно	Имя или регулярное выражение компонента для сопоставления, регистрозависимое.
password строка	Пароль целевого контроллера вне зоны. Если пароль не указан, используется переменная среды `IDRAC_PASSWORD`. Например: export IDRAC_PASSWORD=password
reboot логическое значение	Перезагрузить сервер для применения предыдущей версии прошивки. `true` перезагружает сервер для отката прошивки до доступной версии. `false` планирует откат прошивки до следующего перезапуска. Если reboot `false`, некоторые компоненты обновляются сразу, и сервер может перезапуститься. Поэтому модуль должен подождать, пока сервер станет доступным. Варианты: `false` `true` ← (по умолчанию)
reboot_timeout целое число	Время ожидания в секундах. Модуль ожидает в течение этого времени, пока сервер не перезагрузится. По умолчанию: `900`
timeout целое число добавлен в dellemc.openmanage 5.0.0	Таймаут на уровне сокета в секундах. По умолчанию: `30`
username строка	Имя пользователя целевого контроллера вне зоны. Если имя пользователя не указано, используется переменная среды `IDRAC_USERNAME`. Например: export IDRAC_USERNAME=username
validate_certs логическое значение добавлен в dellemc.openmanage 5.0.0	Если `false`, сертификаты SSL не будут проверяться. Настройте `false` только на сайтах под вашим контролем, где используются самозаверенные сертификаты. До версии коллекции `5.0.0`, validate_certs по умолчанию `false`. Варианты: `false` `true` ← (по умолчанию)
x_auth_token строка добавлен в dellemc.openmanage 9.3.0	Токен аутентификации. Если x_auth_token не указан, используется переменная среды `IDRAC_X_AUTH_TOKEN`. Например: export IDRAC_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

Выполняйте этот модуль с системы, имеющей прямой доступ к Redfish API.
Для компонентов, которые не требуют перезагрузки, откат прошивки выполняется независимо от того, reboot true или false.
Этот модуль поддерживает IPv4 и IPv6 адреса.
Этот модуль поддерживает check_mode.

Примеры

---
- name: Rollback a BIOS component firmware
  dellemc.openmanage.redfish_firmware_rollback:
    baseuri: "192.168.0.1"
    username: "user_name"
    password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    name: "BIOS"

- name: Rollback all NIC cards with a name starting from 'Broadcom Gigabit'.
  dellemc.openmanage.redfish_firmware_rollback:
    baseuri: "192.168.0.1:443"
    username: "user_name"
    password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    name: "Broadcom Gigabit Ethernet.*"

- name: Rollback all the component firmware except BIOS component.
  dellemc.openmanage.redfish_firmware_rollback:
    baseuri: "192.168.0.1:443"
    username: "user_name"
    password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    name: "(?!BIOS).*"

- name: Rollback all the available firmware component.
  dellemc.openmanage.redfish_firmware_rollback:
    baseuri: "192.168.0.1:443"
    username: "user_name"
    password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    name: ".*"

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

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

Ключ	Описание
error_info словарь	Подробности HTTP-ошибки. Возвращается: при ошибке http Пример: {"error": {"@Message.ExtendedInfo": [{"Message": "InstanceID value provided for the update operation is invalid", "MessageArgs": [], "MessageArgs@odata.count": 0, "MessageId": "IDRAC.2.8.SUP024", "RelatedProperties": [], "RelatedProperties@odata.count": 0, "Resolution": "Enumerate inventory, copy the InstanceID value and provide that value for the update operation.", "Severity": "Warning"}], "code": "Base.1.12.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information"}}
msg строка	Общий статус сброса прошивки. Возвращается: всегда Пример: `"Successfully completed the job for firmware rollback."`
status список / элементы=строка	Подробности о задании сброса прошивки и ходе выполнения из iDRAC. Возвращается: при успехе Пример: `[{"ActualRunningStartTime": "2023-08-04T12:26:55", "ActualRunningStopTime": "2023-08-04T12:32:35", "CompletionTime": "2023-08-04T12:32:35", "Description": "Job Instance", "EndTime": "TIME_NA", "Id": "JID_911698303631", "JobState": "Completed", "JobType": "FirmwareUpdate", "Message": "Job completed successfully.", "MessageArgs": [], "MessageId": "PR19", "Name": "Firmware Rollback: Firmware", "PercentComplete": 100, "StartTime": "2023-08-04T12:23:50", "TargetSettingsURI": null}]`

Авторы

Felix Stephen (@felixs88)

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

© 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/dellemc/openmanage/redfish_firmware_rollback_module.html