theforeman.foreman.status_info 模块 – 获取状态信息

注意

此模块是 theforeman.foreman 集合(版本 4.2.0)的一部分。

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

要安装它,请使用:ansible-galaxy collection install theforeman.foreman。您需要进一步的要求才能使用此模块,请参阅 要求 以了解详细信息。

要在 playbook 中使用它,请指定:theforeman.foreman.status_info

theforeman.foreman 1.3.0 中的新增功能

概要

  • 从服务器获取状态信息

要求

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

  • requests

参数

参数

注释

password

字符串 / 必需

访问 Foreman 服务器的用户的密码。

如果未在任务中指定该值,则将使用环境变量 FOREMAN_PASSWORD 的值。

server_url

字符串 / 必需

Foreman 服务器的 URL。

如果未在任务中指定该值,则将使用环境变量 FOREMAN_SERVER_URL 的值。

username

字符串 / 必需

访问 Foreman 服务器的用户名。

如果未在任务中指定该值,则将使用环境变量 FOREMAN_USERNAME 的值。

validate_certs

布尔值

是否验证 Foreman 服务器的 TLS 证书。

如果未在任务中指定该值,则将使用环境变量 FOREMAN_VALIDATE_CERTS 的值。

选择

  • false

  • true ←(默认)

属性

属性

支持

描述

check_mode

支持:完全

可以在 check_mode 中运行并返回更改的状态预测,而无需修改实体

diff_mode

支持:完全

当处于 diff 模式时,将返回有关已更改的内容(或可能需要在 check_mode 中更改的内容)的详细信息

示例

- name: status
  theforeman.foreman.status_info:
    server_url: "https://foreman.example.com"
    username: "admin"
    password: "changeme"

返回值

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

描述

ping

字典

详细的服务状态。

返回:如果服务器支持

status

字典

服务器的基本状态。

返回:始终

作者

  • Evgeni Golov (@evgeni)