community.general.cobbler inventory – источник инвентаризации Cobbler

Примечание

Этот плагин инвентаризации входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.cobbler.

Добавлено в community.general 1.0.0

Краткое описание
Параметры
Примеры

Краткое описание

Получает узлы инвентаризации из службы Cobbler.
Использует файл конфигурации в качестве источника инвентаризации; его имя должно оканчиваться на .cobbler.yml или .cobbler.yaml и содержать запись plugin: cobbler.
Добавляет основные IP-адреса в переменные узла cobbler_ipv4_address и cobbler_ipv6_address, если они заданы в Cobbler. Основной IP-адрес определяется как адрес интерфейса управления, если он указан; в противном случае — как адрес интерфейса, DNS-имя которого совпадает с именем узла системы, либо как адрес первого найденного интерфейса.

Параметры

Параметр	Комментарии
cache логическое значение	Включает или отключает кеширование исходных данных инвентаризации; для работы требуется настроить плагин кеширования. Варианты: `false` ← (по умолчанию) `true` Конфигурация: Запись INI: [inventory] cache = false Переменная среды: `ANSIBLE_INVENTORY_CACHE`
cache_connection строка	Данные подключения к кешу или путь к нему; подробности см. в документации плагина кеширования. Конфигурация: Записи INI: [defaults] fact_caching_connection = VALUE [inventory] cache_connection = VALUE Переменная среды: `ANSIBLE_CACHE_PLUGIN_CONNECTION` Переменная среды: `ANSIBLE_INVENTORY_CACHE_CONNECTION`
cache_fallback логическое значение	Использовать кешированные результаты, если подключение к Cobbler не удалось. Варианты: `false` ← (по умолчанию) `true`
cache_plugin строка	Плагин кеширования исходных данных инвентаризации. По умолчанию: `"memory"` Конфигурация: Записи INI: [defaults] fact_caching = memory [inventory] cache_plugin = memory Переменная среды: `ANSIBLE_CACHE_PLUGIN` Переменная среды: `ANSIBLE_INVENTORY_CACHE_PLUGIN`
cache_prefix строка	Префикс для файлов/таблиц плагина кеширования. По умолчанию: `"ansible_inventory_"` Конфигурация: Записи INI: [defaults] fact_caching_prefix = ansible_inventory_ [inventory] cache_prefix = ansible_inventory_ Переменная среды: `ANSIBLE_CACHE_PLUGIN_PREFIX` Переменная среды: `ANSIBLE_INVENTORY_CACHE_PLUGIN_PREFIX`
cache_timeout целое число	Продолжительность хранения в кеше в секундах. По умолчанию: `3600` Конфигурация: Записи INI: [defaults] fact_caching_timeout = 3600 [inventory] cache_timeout = 3600 Переменная среды: `ANSIBLE_CACHE_PLUGIN_TIMEOUT` Переменная среды: `ANSIBLE_INVENTORY_CACHE_TIMEOUT`
connection_timeout целое число добавлено в community.general 10.7.0	Время ожидания подключения к серверу Cobbler.
exclude_mgmt_classes список / элементы=строки добавлено в community.general 7.4.0	Классы управления, которые нужно исключить из инвентаризации. По умолчанию: `[]`
exclude_profiles список / элементы=строки	Профили, которые нужно исключить из инвентаризации. Игнорируется, если указан параметр `include_profiles`. По умолчанию: `[]`
facts_level строка добавлено в community.general 10.7.0	Задайте значение `normal`, чтобы собирать только переменные уровня системы. Задайте значение `as_rendered`, чтобы собирать все переменные в сводном виде, предоставляемом Cobbler. Варианты: `"normal"` ← (по умолчанию) `"as_rendered"`
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	Профили, которые нужно включить в инвентаризацию. Если параметр указан, все остальные профили исключаются. Параметр `exclude_profiles` игнорируется, если указан параметр `include_profiles`. По умолчанию: `[]`
inventory_hostname строка добавлено в community.general 7.1.0	Значение, используемое в качестве имени узла в инвентаризации Ansible. По умолчанию используется сетевое имя узла, если оно задано; в противном случае используется DNS-имя интерфейса управления или первого нестатического интерфейса. Если задано значение `system`, используется системное имя Cobbler. Варианты: `"hostname"` ← (по умолчанию) `"system"`
password строка	Пароль для аутентификации в Cobbler. Конфигурация: Переменная среды: `COBBLER_PASSWORD`
plugin строка / обязательный	Имя этого плагина. Для распознавания плагином собственной конфигурации здесь всегда должно быть указано `community.general.cobbler`. Варианты: `"cobbler"` `"community.general.cobbler"`
url строка	URL-адрес Cobbler. По умолчанию: `"http://cobbler/cobbler_api"` Конфигурация: Переменная среды: `COBBLER_SERVER`
user строка	Имя пользователя для аутентификации в Cobbler. Конфигурация: Переменная среды: `COBBLER_USER`
want_facts логическое значение	Переключатель: если `true`, плагин получает с сервера все факты узлов. Варианты: `false` `true` ← (по умолчанию)
want_ip_addresses логическое значение добавлено в community.general 7.1.0	Переключатель: если `true`, плагин добавляет словарь `cobbler_ipv4_addresses` и `cobbler_ipv6_addresses` в заданное сопоставление `group`, связывая DNS-имена интерфейсов с IP-адресами. Варианты: `false` `true` ← (по умолчанию)

Примечание

Перечисленные выше записи конфигурации для каждого типа записей (переменная Ansible, переменная среды и т. д.) упорядочены от низкого приоритета к высокому. Например, переменная, расположенная ниже в списке, переопределяет переменную, расположенную выше. Типы записей также упорядочены по приоритету от низкого к высокому. Например, запись ansible.cfg (расположенная выше в списке) переопределяется переменной Ansible (расположенной ниже в списке).

Примеры

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

Авторы

Orion Poplawski (@opoplawski)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/cobbler_inventory.html