theforeman.foreman.content_view 模块 – 管理内容视图

注意

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

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

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

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

theforeman.foreman 1.0.0 中的新功能

概要

  • 创建和管理内容视图

别名: katello_content_view

要求

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

  • requests

参数

参数

注释

auto_publish

布尔值

当创建组件内容视图的新版本时,自动发布复合视图。

另请注意,仅当组件标记为“最新”时,才会发生自动发布。

选项

  • false ← (默认)

  • true

组件

列表 / 元素=字典

要包括的包含 content_view 和 version 或 latest 的内容视图列表。

如果 composite=False,则忽略。

content_view

字符串 / 必需

要添加到复合内容视图的内容视图名称

content_view_version

别名: version

字符串

要添加的内容视图版本

最新

布尔值

始终使用最新的内容视图版本

选项

  • false ← (默认)

  • true

composite

布尔值

复合视图包含其他内容视图。

选项

  • false ← (默认)

  • true

description

字符串

内容视图的描述

import_only

布尔值

在 theforeman.foreman 3.14.0 中添加

指定此内容视图仅用于从上游服务器导入。

选项

  • false

  • true

label

字符串

内容视图的标签。此字段无法更新。

name

字符串 / 必需

内容视图的名称

organization

字符串 / 必需

实体所在的组织

password

字符串 / 必需

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

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

repositories

列表 / 元素=字典

包含名称和产品的存储库列表。

不能与 composite=True 组合使用。

name

字符串 / 必需

要添加的存储库的名称

product

字符串 / 必需

要添加的存储库的产品

server_url

字符串 / 必需

Foreman 服务器的 URL。

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

solve_dependencies

布尔值

默认在内容视图发布时解决 RPM 依赖关系

选项

  • false

  • true

state

字符串

实体的状态

present_with_defaults 将确保实体存在,但不会更新现有实体

选项

  • "present" ← (默认)

  • "present_with_defaults"

  • "absent"

username

字符串 / 必需

访问 Foreman 服务器的用户名。

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

validate_certs

布尔值

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

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

选项

  • false

  • true ← (默认)

属性

属性

支持

描述

check_mode

支持: 完全

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

diff_mode

支持: 完全

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

示例

- name: "Create or update Fedora content view"
  theforeman.foreman.content_view:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "Fedora CV"
    organization: "My Cool new Organization"
    repositories:
      - name: 'Fedora 26'
        product: 'Fedora'

- name: "Create a composite content view"
  theforeman.foreman.content_view:
    username: "admin"
    password: "changeme"
    server_url: "https://foreman.example.com"
    name: "Fedora CCV"
    organization: "My Cool new Organization"
    composite: true
    auto_publish: true
    components:
      - content_view: Fedora CV
        content_view_version: 1.0
      - content_view: Internal CV
        latest: true

返回值

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

描述

实体

字典

受影响的实体按其类型分组的最终状态。

返回: 成功

content_views

列表 / 元素=字典

内容视图列表。

返回: 成功

作者

  • Eric D Helms (@ehelms)