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

支持:不支持

在差异模式下,将返回有关已更改内容(或可能需要在 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)