модуль dellemc.openmanage.omevv_firmware — обновление микропрограммы определенного хоста в кластере

Примечание

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

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

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

Чтобы использовать модуль в сценарии, укажите: dellemc.openmanage.omevv_firmware.

Добавлено в dellemc.openmanage 9.10.0

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

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

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

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
ca_path path	Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA, который используется для проверки.
check_vSAN_health boolean	Проверять состояние vSAN при обновлении микропрограммы. `true` проверяет состояние vSAN при обновлении микропрограммы. `false` не проверяет состояние vSAN при обновлении микропрограммы. Варианты: `false` `true`
date_time string	Дата и время запуска задания. Применяется, если run_now имеет значение `false`. Поддерживаемый формат: YYYY-MM-DDThh:mm:ss<offset>.
delete_job_queue boolean	Удалять ли очередь заданий в iDRAC при обновлении микропрограммы. `true` удаляет очередь заданий в iDRAC при обновлении микропрограммы. `false` не удаляет очередь заданий в iDRAC при обновлении микропрограммы. Варианты: `false` `true`
drs_check boolean	Позволяет проверить, включен ли DRS кластера. `true` проверяет, включен ли в кластере Distributed Resource Scheduler (DRS). `false` не проверяет, включен ли DRS кластера. Варианты: `false` ← (по умолчанию) `true`
enter_maintenance_mode_options string	Политика миграции виртуальных машин при переходе в режим обслуживания. `FULL_DATA_MIGRATION` для полной миграции данных. `ENSURE_ACCESSIBILITY` для обеспечения доступности. `NO_DATA_MIGRATION` не переносит данные. Варианты: `"FULL_DATA_MIGRATION"` `"ENSURE_ACCESSIBILITY"` `"NO_DATA_MIGRATION"`
enter_maintenance_mode_timeout integer	Время ожидания в режиме обслуживания, в минутах. По умолчанию: `60`
evacuate_VMs boolean	Позволяет переместить виртуальную машину (ВМ) на другой хост при выключении текущего хоста. `true` перемещает ВМ на другой хост при выключении текущего хоста. `false` не перемещает ВМ на другой хост при выключении текущего хоста. Варианты: `false` ← (по умолчанию) `true`
exit_maintenance_mode boolean	Следует ли выйти из режима обслуживания после обновления. `true` выполняет выход из режима обслуживания после обновления. `false` не выполняет выход из режима обслуживания после обновления. Варианты: `false` ← (по умолчанию) `true`
hostname string / обязательный	IP-адрес или имя хоста OpenManage Enterprise Modular.
job_description string	Описание задания обновления.
job_name string	Имя задания обновления.
job_wait boolean	Ожидать ли завершения задания. Применяется, если power_on имеет значение `true`. `true` ожидает завершения задания. `false` не ожидает завершения задания. Варианты: `false` `true` ← (по умолчанию)
job_wait_timeout integer	Максимальное время ожидания job_wait в секундах. Отслеживание задания выполняется только в течение этого периода. Этот параметр применяется, если job_wait имеет значение `true`. По умолчанию: `1200`
maintenance_mode_count_check boolean	Позволяет проверить, находится ли какой-либо хост в кластере в режиме обслуживания. `true` проверяет, находится ли какой-либо хост в кластере в режиме обслуживания. `false` не проверяет, находится ли какой-либо хост в кластере в режиме обслуживания. Варианты: `false` `true`
port integer	HTTPS-порт OpenManage Enterprise. По умолчанию: `443`
reboot_options string	Параметр перезагрузки хоста при обновлении микропрограммы. `FORCEREBOOT` принудительно перезагружает сервер. `SAFEREBOOT` перезагружает сервер в безопасном режиме. `NEXTREBOOT` не перезагружает сервер. Варианты: `"FORCEREBOOT"` `"SAFEREBOOT"` ← (по умолчанию) `"NEXTREBOOT"`
reset_idrac boolean	Следует ли сбросить iDRAC при обновлении микропрограммы. `true` выполняет сброс iDRAC при обновлении микропрограммы. `false` не выполняет сброс iDRAC при обновлении микропрограммы. Варианты: `false` `true`
run_now boolean / обязательный	Запустить задание обновления сейчас или позже. `true` немедленно запускает задание обновления. `false` запускает обновление в указанное время date_time. Варианты: `false` `true`
targets list / elements=dictionary / обязательный	Сведения о целевых объектах для операции обновления микропрограммы. Для операции обновления микропрограммы необходимо указать cluster, servicetag или host.
cluster string	Имя кластера, для которого необходимо обновить микропрограмму. cluster нельзя использовать одновременно с servicetag и host. Этот модуль поддерживает обновление только одного кластера.
firmware_components list / elements=string / обязательный	Список компонентов микропрограммы хоста для обновления. Для получения списка поддерживаемых компонентов микропрограммы можно использовать модуль dellemc.openmanage.omevv_firmware_compliance_info.
host string	IP-адрес или имя хоста. host нельзя использовать одновременно с servicetag и cluster. Для получения сведений об устройстве можно использовать модуль dellemc.openmanage.omevv_device_info.
servicetag string	Сервисный тег хоста. servicetag нельзя использовать одновременно с host и cluster. Для получения сведений об устройстве можно использовать модуль dellemc.openmanage.omevv_device_info.
timeout integer	Тайм-аут сокета в секундах. По умолчанию: `30`
validate_certs boolean	Проверять ли сертификат SSL. — Если `true`, сертификаты SSL будут проверены. — Если `false`, сертификаты SSL проверяться не будут. Варианты: `false` `true` ← (по умолчанию)
vcenter_password string	Пароль для OpenManage Enterprise Integration for VMware vCenter (OMEVV). Если пароль не указан, используется переменная среды `OMEVV_VCENTER_PASSWORD`. Пример: export OMEVV_VCENTER_PASSWORD=password
vcenter_username string	Имя пользователя для OpenManage Enterprise Integration for VMware vCenter (OMEVV). Если имя пользователя не указано, используется переменная среды `OMEVV_VCENTER_USERNAME`. Пример: export OMEVV_VCENTER_USERNAME=username
vcenter_uuid string	Универсальный уникальный идентификатор (UUID) vCenter. Сведения об UUID vCenter можно получить с помощью модуля dellemc.openmanage.omevv_vcenter_info. Если UUID не указан, используется переменная среды `OMEVV_VCENTER_UUID`. Пример: export OMEVV_VCENTER_UUID=uuid

Атрибуты

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

Примечания

Примечание

Запускайте этот модуль в системе, имеющей прямой доступ к Dell OpenManage Enterprise.
Этот модуль поддерживает адреса IPv4 и IPv6.

Примеры

---
- name: Immediately update the firmware of a single component for a specific host
  dellemc.openmanage.omevv.omevv_firmware:
    hostname: "XXX.XXX.XXX.XX"
    vcenter_uuid: "xxxxx"
    vcenter_username: "username"
    vcenter_password: "password"
    ca_path: "path/to/ca_file"
    run_now: false
    date_time: "2024-09-10T20:50:00Z"
    enter_maintenance_mode_timeout: 60
    enter_maintenance_mode_options: FULL_DATA_MIGRATION
    drs_check: true
    evacuate_VMs: true
    exit_maintenance_mode: true
    reboot_options: NEXTREBOOT
    maintenance_mode_count_check: true
    check_vSAN_health: true
    reset_idrac: true
    delete_job_queue: true
    targets:
      - servicetag: SVCTAG1
        firmware_components:
          - "DCIM:INSTALLED#802__Diagnostics.Embedded.1:LC.Embedded.1"

- name: Update the firmware of multiple components at scheduled time for a specific host
  dellemc.openmanage.omevv.omevv_firmware:
    hostname: "XXX.XXX.XXX.XY"
    vcenter_uuid: "xxxxx"
    vcenter_username: "username"
    vcenter_password: "password"
    ca_path: "path/to/ca_file"
    run_now: false
    date_time: "2024-09-10T20:50:00+05:30"
    enter_maintenance_mode_timeout: 60
    enter_maintenance_mode_options: ENSURE_ACCESSIBILITY
    drs_check: true
    evacuate_VMs: true
    exit_maintenance_mode: true
    reboot_options: FORCEREBOOT
    maintenance_mode_count_check: true
    check_vSAN_health: true
    reset_idrac: false
    delete_job_queue: false
    targets:
      - host: "XXX.XXX.XXX.XZ"
        firmware_components:
          - "DCIM:INSTALLED#iDRAC.Embedded.1-1#IDRACinfo"
          - "DCIM:INSTALLED#301_C_BOSS.SL.14-1"
          - "DCIM:INSTALLED#807__TPM.Integrated.1-1"

- name: Update the firmware of multiple components at scheduled time for a cluster
  dellemc.openmanage.omevv.omevv_firmware:
    hostname: "XXX.XXX.XXX.XX"
    vcenter_uuid: "xxxxx"
    vcenter_username: "username"
    vcenter_password: "password"
    ca_path: "path/to/ca_file"
    run_now: false
    date_time: "2024-09-10T20:50:00+05:30"
    enter_maintenance_mode_timeout: 60
    enter_maintenance_mode_options: ENSURE_ACCESSIBILITY
    drs_check: true
    evacuate_VMs: true
    exit_maintenance_mode: true
    reboot_options: SAFEREBOOT
    maintenance_mode_count_check: true
    check_vSAN_health: true
    reset_idrac: false
    delete_job_queue: false
    targets:
      - cluster: cluster_a
        firmware_components:
          - "DCIM:INSTALLED#iDRAC.Embedded.1-1#IDRACinfo"
          - "DCIM:INSTALLED#301_C_BOSS.SL.14-1"
          - "DCIM:INSTALLED#807__TPM.Integrated.1-1"

- name: Retrieve firmware compliance report of all hosts in the specific cluster
  dellemc.openmanage.omevv_firmware_compliance_info:
    hostname: "XXX.XXX.XXX.XX"
    vcenter_uuid: "xxxxx"
    vcenter_username: "username"
    vcenter_password: "password"
    ca_path: "path/to/ca_file"
    clusters:
      - cluster_name: cluster_a
  register: compliance_data

- name: Initialize compliance status results
  ansible.builtin.set_fact:
    source_names: []
    service_tag: ""

- name: Flatten host compliance reports
  ansible.builtin.set_fact:
    host_reports: "{{
        compliance_data.firmware_compliance_info |
        map(attribute='hostComplianceReports') |
        flatten(levels=1) }}"

- name: Flatten and filter concompliant components
  ansible.builtin.set_fact:
    non_compliant_components: >-
        {{
          host_reports
          | map(attribute='componentCompliances')
          | flatten(levels=1)
          | selectattr('driftStatus', 'equalto', 'NonCompliant')
        }}

- name: Gather components source name and set service tag
  ansible.builtin.set_fact:
    source_names: "{{ source_names + [item.sourceName] }}"
    service_tag: "{{ host_report.serviceTag }}"
  loop: "{{ non_compliant_components }}"
  vars:
    host_report: >-
        {{
          host_reports
          | selectattr('componentCompliances', 'contains', item)
          | first
        }}

- name: Combine the final non compliance report
  ansible.builtin.set_fact:
    noncompliance_report:
      sourceNames: "{{ source_names }}"
      serviceTag: "{{ service_tag }}"

- name: Update firmware at the scheduled time for a specific host
  dellemc.openmanage.omevv.omevv_firmware:
    hostname: "192.168.0.1"
    vcenter_uuid: "{{ vcenter_uuid }}"
    vcenter_username: "username"
    vcenter_password: "password"
    ca_path: "path/to/ca_file"
    run_now: false
    date_time: "2024-09-10T20:50:00Z"
    enter_maintenance_mode_timeout: 60
    enter_maintenance_mode_options: NO_DATA_MIGRATION
    drs_check: true
    evacuate_VMs: false
    exit_maintenance_mode: true
    reboot_options: SAFEREBOOT
    maintenance_mode_count_check: true
    check_vSAN_health: true
    reset_idrac: true
    delete_job_queue: true
    targets:
      - servicetag: "{{ noncompliance_report.serviceTag }}"
        firmware_components: "{{ noncompliance_report.sourceNames }}"

Возвращаемые значения

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

Ключ	Описание
error_info dictionary	Сведения об ошибке HTTP модуля. Возвращается: при ошибке HTTP Пример: `{"errorCode": "20058", "message": "Update Job already running for group id 1004 corresponding to cluster OMAM-Cluster-1. Wait for its completion and trigger."}`
msg string	Состояние операции обновления микропрограммы. Возвращается: всегда Пример: `"Successfully created the OMEVV baseline profile."`

Авторы

Rajshekar P(@rajshekarp87)

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

© 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/omevv_firmware_module.html