community.general.cobbler inventory – Cobbler 清单源

注意

此清单插件是 community.general 集合（版本 10.1.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install community.general。

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

community.general 1.0.0 中的新增功能

概要

  • 从 cobbler 服务获取清单主机。

  • 使用配置文件作为清单源，它必须以 .cobbler.yml 或 .cobbler.yaml 结尾，并具有 plugin: cobbler 条目。

  • 如果 Cobbler 中定义了主 IP 地址，则将主 IP 地址添加到 cobbler_ipv4_address 和 cobbler_ipv6_address 主机变量。主 IP 地址定义为管理接口（如果已定义），或 DNS 名称与系统主机名匹配的接口，否则为找到的第一个接口。

参数

参数

注释

缓存

布尔值

切换以启用/禁用清单源数据的缓存，需要设置缓存插件才能工作。

选择

  • false ← (默认)

  • true

配置

cache_connection

字符串

缓存连接数据或路径，请阅读缓存插件文档以了解具体信息。

配置

cache_fallback

布尔值

如果连接到 cobbler 失败，则回退到缓存的结果。

选择

  • false ← (默认)

  • true

cache_plugin

字符串

用于清单源数据的缓存插件。

默认： "memory"

配置

cache_prefix

字符串

用于缓存插件文件/表的前缀

默认： "ansible_inventory_"

配置

cache_timeout

整数

缓存持续时间（秒）

默认： 3600

配置

exclude_mgmt_classes

列表 / 元素=字符串

在 community.general 7.4.0 中添加

要从清单中排除的管理类。

默认： []

exclude_profiles

列表 / 元素=字符串

要从清单中排除的配置文件。

如果指定了 include_profiles，则忽略此项。

默认： []

group

字符串

将所有主机放入的组。

默认值： "cobbler"

group_by

列表 / 元素=字符串

用于对主机进行分组的键。

默认值： ["mgmt_classes", "owners", "status"]

group_prefix

字符串

应用于 cobbler 组的前缀。

默认值： "cobbler_"

include_mgmt_classes

列表 / 元素=字符串

在 community.general 7.4.0 中添加

要从清单中包含的管理类。

默认： []

include_profiles

列表 / 元素=字符串

在 community.general 4.4.0 中添加

要从清单中包含的配置文件。

如果指定，将排除所有其他配置文件。

如果指定了 include_profiles，则忽略 exclude_profiles。

默认： []

inventory_hostname

字符串

在 community.general 7.1.0 中添加

用于 Ansible 清单主机名的内容。

默认情况下，如果定义了网络主机名，则使用该主机名；否则使用管理接口或第一个非静态接口的 DNS 名称。

如果设置为 system，则使用 cobbler 系统名称。

选择

  • "hostname" ← (默认)

  • "system"

password

字符串

Cobbler 身份验证密码。

配置

plugin

字符串 / 必需

此插件的名称，对于此插件识别其自身，应始终设置为 community.general.cobbler。

选择

  • "cobbler"

  • "community.general.cobbler"

url

字符串

Cobbler 的 URL。

默认值： "http://cobbler/cobbler_api"

配置

user

字符串

Cobbler 身份验证用户。

配置

want_facts

布尔值

切换，如果 true，则插件将从服务器检索主机事实信息。

选择

  • false

  • true ← (默认)

want_ip_addresses

布尔值

在 community.general 7.1.0 中添加

切换，如果 true，则插件将向定义的 group 映射添加一个 cobbler_ipv4_addresses 和 cobbleer_ipv6_addresses 字典，其中接口 DNS 名称映射到 IP 地址。

选择

  • false

  • true ← (默认)

示例

# my.cobbler.yml
plugin: community.general.cobbler
url: http://cobbler/cobbler_api
user: ansible-tester
password: secure

作者

  • Orion Poplawski (@opoplawski)

提示

每个条目类型的配置条目都具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖较高的变量。