community.general.rhsm_repository 模块 – 使用 subscription-manager 命令管理 RHSM 仓库

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

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

要安装它，请使用： ansible-galaxy collection install community.general。您需要其他要求才能使用此模块，有关详细信息，请参见 要求。

要在剧本中使用它，请指定： community.general.rhsm_repository。

摘要

  • 使用 subscription-manager 命令管理 (启用/禁用) Red Hat 订阅管理授权平台的 RHSM 仓库。

要求

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

  • subscription-manager

参数

参数

注释

name

列表 / 元素=字符串 / 必需

要启用的仓库的 ID。

要对多个仓库进行操作，这可以接受逗号分隔的列表或 YAML 列表。

purge

布尔值

禁用当前启用的、在 name 中未指定的全部仓库。仅当将仓库列表传递到 name 字段时，才将其设置为 true。与 loop 一起使用很可能无法获得预期的结果。

选项

  • false ← (默认)

  • true

state

字符串

如果 state 等于 present 或 disabled，则表示所需的仓库状态。

在 community.general 10.0.0 中，状态 present 和 absent 已被删除。请改用 enabled 和 disabled。

选项

  • "enabled" ← (默认)

  • "disabled"

属性

属性

支持

描述

check_mode

支持：完全支持

可以在 check_mode 下运行，并在不修改目标的情况下返回更改状态预测。

diff_mode

支持：完全支持

在差异模式下，将返回有关已更改内容（或可能需要在 check_mode 下更改的内容）的详细信息。

备注

注意

  • 为了管理 RHSM 仓库，系统必须已经手动注册到 RHSM，或者使用 Ansible community.general.redhat_subscription 模块。

  • 只有以 root 用户身份才能与 subscription-manager 交互，因此需要 root 权限才能成功运行此模块。

示例

- name: Enable a RHSM repository
  community.general.rhsm_repository:
    name: rhel-7-server-rpms

- name: Disable all RHSM repositories
  community.general.rhsm_repository:
    name: '*'
    state: disabled

- name: Enable all repositories starting with rhel-6-server
  community.general.rhsm_repository:
    name: rhel-6-server*
    state: enabled

- name: Disable all repositories except rhel-7-server-rpms
  community.general.rhsm_repository:
    name: rhel-7-server-rpms
    purge: true

返回值

常见的返回值已在 此处 记录，以下是此模块独有的字段

键

描述

repositories

列表 / 元素=字符串

包含 RHSM 仓库及其状态的列表。

当使用此模块更改仓库状态时，此列表包含更改后更新的状态。

返回：成功

作者

  • Giovanni Sciortino (@giovannisciortino)