community.general.rhsm_release 模块 – 设置或取消设置 RHSM 发行版

注意

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

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

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

要在 playbook 中使用它，请指定： community.general.rhsm_release。

概要 

设置或取消设置 RHSM 存储库使用的发行版版本。

要求 

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

安装了 subscription-manager 的 Red Hat Enterprise Linux 6+

参数 

参数	注释
release 字符串	要使用的 RHSM 发行版版本。要取消设置，请为此选项传递 `null`，或省略此选项。

属性 

属性	支持	描述
check_mode	支持：完全支持	可以在 `check_mode` 下运行并返回更改状态预测，而无需修改目标。
diff_mode	支持：不支持	处于 diff 模式时，将返回有关已更改内容（或可能需要在 `check_mode` 中更改的内容）的详细信息。

备注 

注意

此模块将在未注册的系统上失败。在设置 RHSM 发行版之前，请使用 community.general.redhat_subscription 模块注册系统。
只有以 root 用户身份才能与 subscription-manager 交互，因此需要 root 权限才能成功运行此模块。

示例 

# Set release version to 7.1
- name: Set RHSM release version
  community.general.rhsm_release:
    release: "7.1"

# Set release version to 6Server
- name: Set RHSM release version
  community.general.rhsm_release:
    release: "6Server"

# Unset release version
- name: Unset RHSM release release
  community.general.rhsm_release:
    release: null

返回值 

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

键	描述
current_release 字符串	当前 RHSM 发行版版本值返回：成功

作者

Sean Myers (@seandst)