Spec-Zone.ru › Ansible

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

Примечание

Этот плагин инвентаризации является частью коллекции community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет 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

boolean

Включает/выключает кэширование данных источника инвентаризации. Требуется настройка плагина кэша для работы.

Варианты:

  • false ← (по умолчанию)
  • true

Настройка:

  • Запись INI:

    [inventory]
    cache = false
    
  • Переменная окружения: ANSIBLE_INVENTORY_CACHE

cache_connection

string

Данные или путь подключения к кэшу, см. документацию к плагину кэша для подробностей.

Настройка:

  • Записи INI:

    [defaults]
    fact_caching_connection = VALUE
    
    [inventory]
    cache_connection = VALUE
    
  • Переменная окружения: ANSIBLE_CACHE_PLUGIN_CONNECTION
  • Переменная окружения: ANSIBLE_INVENTORY_CACHE_CONNECTION

cache_fallback

boolean

Использовать кэшированные результаты, если подключение к cobbler прерывается.

Варианты:

  • false ← (по умолчанию)
  • true

cache_plugin

string

Плагин кэша для данных источника инвентаризации.

По умолчанию: "memory"

Настройка:

  • Записи INI:

    [defaults]
    fact_caching = memory
    
    [inventory]
    cache_plugin = memory
    
  • Переменная окружения: ANSIBLE_CACHE_PLUGIN
  • Переменная окружения: ANSIBLE_INVENTORY_CACHE_PLUGIN

cache_prefix

string

Префикс для файлов/таблиц плагина кэша

По умолчанию: "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

integer

Срок действия кэша в секундах

По умолчанию: 3600

Настройка:

  • Записи INI:

    [defaults]
    fact_caching_timeout = 3600
    
    [inventory]
    cache_timeout = 3600
    
  • Переменная окружения: ANSIBLE_CACHE_PLUGIN_TIMEOUT
  • Переменная окружения: ANSIBLE_INVENTORY_CACHE_TIMEOUT

exclude_mgmt_classes

list / elements=string

добавлено в community.general 7.4.0

Классы управления, которые нужно исключить из инвентаризации.

По умолчанию: []

exclude_profiles

list / elements=string

Профили, которые нужно исключить из инвентаризации.

Игнорируется, если указан параметр include_profiles.

По умолчанию: []

group

string

Группа, в которую помещаются все узлы.

По умолчанию: "cobbler"

group_by

list / elements=string

Ключи для группировки узлов.

По умолчанию: ["mgmt_classes", "owners", "status"]

group_prefix

string

Префикс, применяемый к группам cobbler.

По умолчанию: "cobbler_"

include_mgmt_classes

list / elements=string

добавлено в community.general 7.4.0

Классы управления, которые нужно включить в инвентаризацию.

По умолчанию: []

include_profiles

list / elements=string

добавлено в community.general 4.4.0

Профили, которые нужно включить в инвентаризацию.

Если указано, все остальные профили будут исключены.

exclude_profiles игнорируется, если указан include_profiles.

По умолчанию: []

inventory_hostname

string

добавлено в community.general 7.1.0

Имя хоста для инвентаризации Ansible.

По умолчанию используется имя хоста сети, если определено, в противном случае — имя DNS управления или первого нестатического интерфейса.

Если установлено на system, используется имя системы cobbler.

Варианты:

  • "hostname" ← (по умолчанию)
  • "system"

пароль

строка

Пароль для аутентификации Cobbler.

Настройка:

  • Переменная окружения: COBBLER_PASSWORD

плагин

строка / обязательно

Имя этого плагина, оно должно всегда устанавливаться на community.general.cobbler для того, чтобы этот плагин его распознал.

Варианты:

  • "cobbler"
  • "community.general.cobbler"

url

строка

URL сервера Cobbler.

По умолчанию: "http://cobbler/cobbler_api"

Настройка:

  • Переменная окружения: COBBLER_SERVER

пользователь

строка

Имя пользователя для аутентификации Cobbler.

Настройка:

  • Переменная окружения: COBBLER_USER

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)

Подсказка

Настройки для каждого типа записи имеют порядок приоритета снизу вверх. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.

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

  • Система отслеживания ошибок
  • Репозиторий (исходные коды)
  • Спросить о помощи
  • Отправить отчет об ошибке
  • Запросить функцию
  • Связь

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API