theforeman.foreman.registration_command 模块 – 管理注册命令

注意

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

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

要安装它，请使用：ansible-galaxy collection install theforeman.foreman。您需要更多要求才能使用此模块，请参阅 要求 了解详细信息。

要在 Playbook 中使用它，请指定：theforeman.foreman.registration_command。

theforeman.foreman 4.0.0 版本新增

概要

  • 管理注册命令

要求

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

  • requests

参数

参数

注释

activation_keys

list / elements=string

用于 subscription-manager 客户端的激活密钥，CentOS 和 Red Hat Enterprise Linux 需要。

仅当主机组没有激活密钥时才需要。

force

boolean

清除任何先前的注册，并使用 --force 运行 subscription-manager。

选择

  • false

  • true

hostgroup

string

要在其中注册主机的主机组。

ignore_subman_errors

boolean

忽略 subscription-manager register 命令的 subscription-manager 错误。

选择

  • false

  • true

insecure

boolean

为初始 curl 启用不安全参数。

选择

  • false

  • true

jwt_expiration

integer

授权令牌的过期时间（以小时为单位）。

lifecycle_environment

string

主机的生命周期环境。

location

string

要在其中注册主机的位置。

operatingsystem

string

要在其中注册主机的主机操作系统。

操作系统必须分配有 host_init_config 模板。

organization

string

要在其中注册主机的组织。

packages

string

注册时要在主机上安装的软件包。

多个软件包应作为空格分隔的字符串给出。

password

string / required

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

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

remote_execution_interface

string

用于远程执行的主机接口的标识符。

repo

string

存储库 URL (yum/dnf) 或完整的 sources.list 条目 (apt)。

repo_gpg_key_url

string

存储库的 GPG 密钥的 URL。

server_url

string / required

Foreman 服务器的 URL。

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

setup_insights

boolean

如果将其设置为 true，则将在 Red Hat 系列操作系统上安装和注册 insights-client。

选择

  • false

  • true

setup_remote_execution

boolean

如果将其设置为 true，则将在主机上安装 SSH 密钥。

选择

  • false

  • true

setup_remote_execution_pull

boolean

如果将其设置为 true，则将在主机上部署拉取提供程序客户端。

选择

  • false

  • true

smart_proxy

string

智能代理的名称。

此代理必须启用 Templates 和 Registration 功能。

update_packages

boolean

更新主机上的所有软件包。

选择

  • false

  • true

username

string / required

访问 Foreman 服务器的用户名。

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

validate_certs

boolean

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

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

选择

  • false

  • true ← (默认)

属性

属性

支持

描述

check_mode

支持：完全

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

diff_mode

支持：完全

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

示例

- name: "Generate registration command"
  theforeman.foreman.registration_command:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
  register: command

- name: "Perform registration"
  ansible.builtin.shell:
    cmd: "{{ command.registration_command }}"

返回值

常见返回值在 此处 进行了文档记录，以下是此模块独有的字段

键

描述

registration_command

string

生成的注册命令。

已返回：成功

作者

  • Evgeni Golov (@evgeni)