Модуль dellemc.openmanage.ome_firmware_baseline — создание, изменение или удаление базовой линии микропрограммы в OpenManage Enterprise или OpenManage Enterprise Modular

Примечание

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

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

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

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

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

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

Обзор

Этот модуль позволяет создавать, изменять или удалять базовую линию микропрограммы в OpenManage Enterprise или OpenManage Enterprise Modular.

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
baseline_description string	Описание создаваемой базовой линии.
baseline_id integer добавлено в dellemc.openmanage 3.4.0	Идентификатор существующей базовой линии. Этот параметр нельзя использовать одновременно с baseline_name.
baseline_name string	Имя базовой линии. Этот параметр нельзя использовать одновременно с baseline_id.
ca_path path добавлено в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA, используемый для проверки.
catalog_name string	Имя каталога, связываемого с базовой линией.
device_group_names list / elements=string	Список имен групп. Этот параметр нельзя использовать одновременно с device_ids и device_service_tags.
device_ids list / elements=integer	Список идентификаторов устройств. Этот параметр нельзя использовать одновременно с device_service_tags и device_group_names.
device_service_tags list / elements=string	Список сервисных меток устройств. Этот параметр нельзя использовать одновременно с device_ids и device_group_names.
downgrade_enabled boolean	Указывает, разрешено ли понижение версии микропрограммы на устройствах, входящих в базовую линию. Если значение не указано при создании базовой линии, по умолчанию будет задано `true`. Варианты: `false` `true`
filter_no_reboot_required boolean добавлено в dellemc.openmanage 8.1.0	Выбор только компонентов, не требующих перезагрузки, позволяет создать базовую линию микропрограммы/драйверов, состоящую только из компонентов целевых устройств, для которых не требуется перезагрузка целевых устройств. Варианты: `false` `true`
hostname string / обязательный	IP-адрес или имя хоста OpenManage Enterprise либо OpenManage Enterprise Modular.
is_64_bit boolean	Указывает, содержит ли репозиторий 64-разрядные DUP. Если значение не указано при создании базовой линии, по умолчанию будет задано `true`. Варианты: `false` `true`
job_wait boolean добавлено в dellemc.openmanage 3.4.0	Позволяет дождаться завершения задания. Этот параметр применяется, если state имеет значение `present`. Варианты: `false` `true` ← (по умолчанию)
job_wait_timeout integer добавлено в dellemc.openmanage 3.4.0	Максимальное время ожидания для job_wait в секундах. Отслеживание задания выполняется только в течение этого времени. Этот параметр применяется, если job_wait имеет значение `true`. По умолчанию: `600`
new_baseline_name string добавлено в dellemc.openmanage 3.4.0	Новое имя базовой линии.
password string	Пароль OpenManage Enterprise или OpenManage Enterprise Modular. Если пароль не указан, используется переменная окружения `OME_PASSWORD`. Пример: export OME_PASSWORD=password
port integer	Порт HTTPS OpenManage Enterprise или OpenManage Enterprise Modular. По умолчанию: `443`
state string добавлено в dellemc.openmanage 3.4.0	`present` создает или изменяет базовую линию. `absent` удаляет существующую базовую линию. Варианты: `"present"` ← (по умолчанию) `"absent"`
timeout integer добавлено в dellemc.openmanage 5.0.0	Тайм-аут на уровне сокета в секундах. По умолчанию: `30`
username string	Имя пользователя OpenManage Enterprise или OpenManage Enterprise Modular. Если имя пользователя не указано, используется переменная окружения `OME_USERNAME`. Пример: export OME_USERNAME=username
validate_certs boolean добавлено в dellemc.openmanage 5.0.0	Если `false`, сертификаты SSL не проверяются. Настраивайте `false` только на сайтах под личным контролем, где используются самозаверяющие сертификаты. В версиях коллекции до `5.0.0` параметр validate_certs по умолчанию имеет значение `false`. Варианты: `false` `true` ← (по умолчанию)
x_auth_token string добавлено в dellemc.openmanage 9.3.0	Токен аутентификации. Если x_auth_token не указан, используется переменная окружения `OME_X_AUTH_TOKEN`. Пример: export OME_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

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

Примеры

---
- name: Create baseline for device IDs
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "baseline_name"
    baseline_description: "baseline_description"
    catalog_name: "catalog_name"
    device_ids:
      - 1010
      - 2020

- name: Create baseline for device IDs with no reboot required
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "baseline_name"
    baseline_description: "baseline_description"
    catalog_name: "catalog_name"
    filter_no_reboot_required: true
    device_ids:
      - 1010
      - 2020

- name: Create baseline for servicetags
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "baseline_name"
    baseline_description: "baseline_description"
    catalog_name: "catalog_name"
    device_service_tags:
      - "SVCTAG1"
      - "SVCTAG2"

- name: Create baseline for servicetags with no reboot required
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "baseline_name"
    baseline_description: "baseline_description"
    catalog_name: "catalog_name"
    filter_no_reboot_required: true
    device_service_tags:
      - "SVCTAG1"
      - "SVCTAG2"

- name: Create baseline for device groups without job tracking
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "baseline_name"
    baseline_description: "baseline_description"
    catalog_name: "catalog_name"
    device_group_names:
      - "Group1"
      - "Group2"
    job_wait: false

- name: Modify an existing baseline
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "existing_baseline_name"
    new_baseline_name: "new_baseline_name"
    baseline_description: "new baseline_description"
    catalog_name: "catalog_other"
    device_group_names:
      - "Group3"
      - "Group4"
      - "Group5"
    downgrade_enabled: false
    is_64_bit: true

- name: Modify no reboot filter in existing baseline
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    baseline_name: "existing_baseline_name"
    new_baseline_name: "new_baseline_name"
    filter_no_reboot_required: true

- name: Delete a baseline
  dellemc.openmanage.ome_firmware_baseline:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: absent
    baseline_name: "baseline_name"

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

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

Ключ	Описание
baseline_id integer	Идентификатор удаленной базовой линии. Возвращается: если state имеет значение `absent` Пример: `10123`
baseline_status dictionary	Сведения о состоянии базовой линии. Возвращается: при успешном выполнении Пример: `{"CatalogId": 123, "Description": "BASELINE DESCRIPTION", "DeviceComplianceReports": [], "DowngradeEnabled": true, "FilterNoRebootRequired": true, "Id": 23, "Is64Bit": true, "Name": "my_baseline", "RepositoryId": 123, "RepositoryName": "catalog123", "RepositoryType": "HTTP", "Targets": [{"Id": 10083, "Type": {"Id": 1000, "Name": "DEVICE"}}, {"Id": 10076, "Type": {"Id": 1000, "Name": "DEVICE"}}], "TaskId": 11235, "TaskStatusId": 2060}`
error_info dictionary	Сведения об ошибке HTTP. Возвращается: при ошибке HTTP Пример: `{"error": {"@Message.ExtendedInfo": [{"Message": "Unable to retrieve baseline list either because the device ID(s) entered are invalid", "Resolution": "Make sure the entered device ID(s) are valid and retry the operation.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}`
job_id integer	Идентификатор задания базовой линии. Возвращается: когда задание базовой линии выполняется Пример: `10123`
msg string	Общий статус операции с базовой линией микропрограммы. Возвращается: всегда Пример: `"Successfully created the firmware baseline."`

Авторы

Jagadeesh N V(@jagadeeshnv)
Kritika Bhateja (@Kritika-Bhateja-03)
Sapana Gupta (@sapana05)

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

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