dellemc.openmanage.ome_firmware_catalog 模块 – 在 OpenManage Enterprise 或 OpenManage Enterprise Modular 上创建、修改或删除固件目录

注意

此模块是 dellemc.openmanage 集合（版本 9.9.0）的一部分。

如果您正在使用 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install dellemc.openmanage。您需要进一步的要求才能使用此模块，有关详细信息，请参阅要求。

要在 playbook 中使用它，请指定：dellemc.openmanage.ome_firmware_catalog。

dellemc.openmanage 2.0.0 中的新增功能

概要

• 此模块允许在 OpenManage Enterprise 或 OpenManage Enterprise Modular 上创建、修改或删除固件目录。

要求

执行此模块的主机上需要以下要求。

• python >= 3.9.6

参数

参数	注释
ca_path 路径 在 dellemc.openmanage 5.0.0 中添加	包含用于验证的 CA 证书的隐私增强邮件 (PEM) 文件。
catalog_description 字符串	目录的描述。
catalog_id 列表 / 元素=整数 在 dellemc.openmanage 3.4.0 中添加	目录的 ID。 此选项与 catalog_name 互斥。 当 state 为 absent 时，提供支持的固件目录 ID 列表。
catalog_name 列表 / 元素=字符串	要创建的固件目录的名称。 此选项与 catalog_id 互斥。 当 state 为 absent 时，提供支持的固件目录名称列表。
check_certificate 布尔值	当 repository_type 为 HTTPS 时，将忽略证书警告。如果为 true。否则，不会忽略证书警告。 选择 false ← (默认) true
file_name 字符串	与 source_path 关联的目录文件名。 当 repository_type 为 DELL_ONLINE 时，将忽略此选项。
hostname 字符串 / 必需	OpenManage Enterprise 或 OpenManage Enterprise Modular IP 地址或主机名。
job_wait 布尔值 在 dellemc.openmanage 3.4.0 中添加	提供等待作业完成的选项。 当 state 为 present 时，此选项适用。 选择 false true ← (默认)
job_wait_timeout 整数 在 dellemc.openmanage 3.4.0 中添加	job_wait 的最长等待时间（以秒为单位）。仅在此持续时间内跟踪作业。 当 job_wait 为 true 时，此选项适用。 默认值： 600
new_catalog_name 字符串 在 dellemc.openmanage 3.4.0 中添加	固件目录的新名称。
password 字符串	OpenManage Enterprise 或 OpenManage Enterprise Modular 密码。 如果未提供密码，则使用环境变量 OME_PASSWORD。 示例：export OME_PASSWORD=password
port 整数	OpenManage Enterprise 或 OpenManage Enterprise Modular HTTPS 端口。 默认值： 443
repository_domain 字符串	存储库的域名。 当 repository_type 为 DELL_ONLINE 时，将忽略此选项。
repository_password 字符串	用于访问存储库的密码。 当 repository_type 为 CIFS 时，此选项是强制性的。 当 repository_type 为 DELL_ONLINE 时，将忽略此选项。 NOTE 当提供此选项时，模块始终报告已更改的状态。
repository_type 字符串	存储库类型。支持的类型为 NFS、CIFS、HTTP、HTTPS 和 DELL_ONLINE。 选择 "NFS" "CIFS" "HTTP" "HTTPS" "DELL_ONLINE"
repository_username 字符串	存储目录的存储库用户名。 当 repository_type 为 CIFS 时，此选项是强制性的。 当 repository_type 为 DELL_ONLINE 时，将忽略此选项。
source 字符串	固件目录存储在本地网络上的系统的 IP 地址。 默认情况下，当 repository_type 为 DELL_ONLINE 时，此选项设置为 downloads.dell.com。
source_path 字符串	指定目录文件位置的完整路径，不包含文件名。 当 repository_type 为 DELL_ONLINE 时，将忽略此选项。
state 字符串 在 dellemc.openmanage 3.4.0 中添加	present 创建或修改目录。 absent 删除现有目录。 选择 "present" ← (默认) "absent"
timeout 整数 在 dellemc.openmanage 5.0.0 中添加	套接字级别的超时时间，单位为秒。 默认值： 30
username 字符串	OpenManage Enterprise 或 OpenManage Enterprise Modular 用户名。 如果未提供用户名，则会使用环境变量 OME_USERNAME。 示例：export OME_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，则会使用环境变量 OME_X_AUTH_TOKEN。 示例：export OME_X_AUTH_TOKEN=x_auth_token

注释

注意

• 如果提供了 *repository_password*，则模块始终报告已更改状态。

• 从可以直接访问 Dell OpenManage Enterprise 或 OpenManage Enterprise Modular 的系统运行此模块。

• 此模块支持 IPv4 和 IPv6 地址。

• 此模块支持 check_mode。

示例

---
- name: Create a catalog from HTTPS repository
  dellemc.openmanage.ome_firmware_catalog:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    catalog_name: "catalog_name"
    catalog_description: "catalog_description"
    repository_type: "HTTPS"
    source: "downloads.dell.com"
    source_path: "catalog"
    file_name: "catalog.gz"
    check_certificate: true

- name: Create a catalog from HTTP repository
  dellemc.openmanage.ome_firmware_catalog:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    catalog_name: "catalog_name"
    catalog_description: "catalog_description"
    repository_type: "HTTP"
    source: "downloads.dell.com"
    source_path: "catalog"
    file_name: "catalog.gz"

- name: Create a catalog using CIFS share
  dellemc.openmanage.ome_firmware_catalog:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    catalog_name: "catalog_name"
    catalog_description: "catalog_description"
    repository_type: "CIFS"
    source: "192.167.0.1"
    source_path: "cifs/R940"
    file_name: "catalog.gz"
    repository_username: "repository_username"
    repository_password: "repository_password"
    repository_domain: "repository_domain"

- name: Create a catalog using NFS share
  dellemc.openmanage.ome_firmware_catalog:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    catalog_name: "catalog_name"
    catalog_description: "catalog_description"
    repository_type: "NFS"
    source: "192.166.0.2"
    source_path: "/nfs/R940"
    file_name: "catalog.xml"

- name: Create a catalog using repository from Dell.com
  dellemc.openmanage.ome_firmware_catalog:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    catalog_name: "catalog_name"
    catalog_description: "catalog_description"
    repository_type: "DELL_ONLINE"
    check_certificate: true

- name: Modify a catalog using a repository from CIFS share
  dellemc.openmanage.ome_firmware_catalog:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    catalog_name: "catalog_name"
    catalog_description: "new catalog_description"
    repository_type: "CIFS"
    source: "192.167.0.2"
    source_path: "cifs/R941"
    file_name: "catalog1.gz"
    repository_username: "repository_username"
    repository_password: "repository_password"
    repository_domain: "repository_domain"

- name: Modify a catalog using a repository from Dell.com
  dellemc.openmanage.ome_firmware_catalog:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    catalog_id: 10
    new_catalog_name: "new_catalog_name"
    repository_type: "DELL_ONLINE"
    catalog_description: "catalog_description"

- name: Delete catalog using catalog name
  dellemc.openmanage.ome_firmware_catalog:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: absent
    catalog_name: ["catalog_name1", "catalog_name2"]

- name: Delete catalog using catalog id
  dellemc.openmanage.ome_firmware_catalog:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: absent
    catalog_id: [11, 34]

返回值

常用的返回值记录在此处 这里，以下是此模块特有的字段

键	描述
associated_baselines 列表 / 元素=字典	与目录关联的基准的 ID。 返回：当 *state* 为 absent 时 示例： [{"BaselineId": 24, "BaselineName": "new"}, {"BaselineId": 25, "BaselineName": "c7"}, {"BaselineId": 27, "BaselineName": "c4"}]
catalog_id 整数	已删除目录的 ID。 返回：当 *state* 为 absent 时 示例： 10123
catalog_status 字典	目录操作的详细信息。 返回：当 *state* 为 present 时 示例： {"AssociatedBaselines": [], "BaseLocation": null, "BundlesCount": 0, "Filename": "catalog.gz", "Id": 12, "LastUpdated": null, "ManifestIdentifier": null, "ManifestVersion": null, "NextUpdate": null, "PredecessorIdentifier": null, "ReleaseDate": null, "ReleaseIdentifier": null, "Repository": {"CheckCertificate": true, "Description": "HTTPS Desc", "DomainName": null, "Id": null, "Name": "catalog4", "Password": null, "RepositoryType": "HTTPS", "Source": "company.com", "Username": null}, "Schedule": null, "SourcePath": "catalog", "Status": null, "TaskId": 10094}
error_info 字典	http 错误的详细信息。 返回：在 http 错误时 示例： {"error": {"@Message.ExtendedInfo": [{"Message": "无法创建或更新目录，因为已存在同名的存储库。", "Resolution": "输入不同的名称并重试操作。", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "发生了一般错误。有关详细信息，请参阅 ExtendedInfo。"}}
job_id 整数	目录任务的作业 ID。 返回：当目录作业处于运行状态时 示例： 10123
msg 字符串	固件目录操作的总体状态。 返回：总是 示例： "已成功触发创建目录的作业，任务 ID 为：10094"

作者

• Sajna Shetty(@Sajna-Shetty)

• Jagadeesh N V(@jagadeeshnv)

集合链接

• 问题跟踪器
• 主页
• 存储库（源代码）