community.general.cobbler清单 – 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地址添加到cobbler_ipv4_address和cobbler_ipv6_address主机变量。主IP地址定义为：如果已定义，则为管理接口；如果其DNS名称与系统主机名匹配，则为该接口；否则为找到的第一个接口。

参数

参数

注释

cache

布尔值

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

选项

  • 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，则插件会将cobbler_ipv4_addresses 和 cobbleer_ipv6_addresses 字典添加到已定义的 group 映射中，将接口 DNS 名称映射到 IP 地址。

选项

  • false

  • true ← (默认)

示例

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

作者

  • Orion Poplawski (@opoplawski)

提示

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