theforeman.foreman.foreman – Источник инвентаризации Foreman
Примечание
Этот плагин входит в состав коллекции theforeman.foreman (версия 1.5.1).
Для его установки используйте: ansible-galaxy collection install theforeman.foreman.
Для использования в плейбуке укажите: theforeman.foreman.foreman.
Описание
- Получение хостов инвентаризации из Foreman.
- Использует файл конфигурации YAML, который заканчивается
foreman.(yml|yaml).
Требования
Ниже перечислены требования, необходимые на локальном узле контроллера, выполняющем эту инвентаризацию.
- requests >= 1.1
Параметры
| Параметр | Варианты/Значения по умолчанию | Настройка | Комментарии |
|---|---|---|---|
| batch_size целое число | По умолчанию: 250 | Количество хостов в пачке, которые будут извлечены из API Foreman за один вызов | |
| cache логическое значение |
| записи ini: [inventory] переменные среды:ANSIBLE_INVENTORY_CACHE | Переключатель для включения/выключения кеширования исходных данных инвентаризации, требует настройки плагина кэша для работы. |
| cache_connection строка | записи ini: [defaults] [inventory] переменные среды:ANSIBLE_CACHE_PLUGIN_CONNECTION переменные среды:ANSIBLE_INVENTORY_CACHE_CONNECTION | Данные или путь подключения к кэшу, для получения подробностей см. документацию плагина кэша. | |
| cache_plugin строка | По умолчанию: "memory" | записи ini: [defaults] [inventory] переменные среды:ANSIBLE_CACHE_PLUGIN переменные среды:ANSIBLE_INVENTORY_CACHE_PLUGIN | Плагин кэша для использования исходных данных инвентаризации. |
| cache_prefix строка | По умолчанию: "ansible_inventory_" | записи ini: [default] [inventory] переменные среды:ANSIBLE_CACHE_PLUGIN_PREFIX переменные среды:ANSIBLE_INVENTORY_CACHE_PLUGIN_PREFIX | Префикс для использования в файлах/таблицах плагина кэша |
| cache_timeout целое число | По умолчанию: 3600 | записи ini: [defaults] [inventory] переменные среды:ANSIBLE_CACHE_PLUGIN_TIMEOUT переменные среды:ANSIBLE_INVENTORY_CACHE_TIMEOUT | Время кэширования в секундах |
| compose словарь | По умолчанию: {} | Создать переменные из выражений jinja2. | |
| foreman строка | Конфигурация, связанная с сервером Foreman, устарела. Вы можете передать use_reports_api в этом словаре, чтобы включить API отчетов. Только для обратной совместимости. | ||
| group_prefix строка | По умолчанию: "foreman_" | префикс для применения к группам foreman | |
| groups словарь | По умолчанию: {} | Добавить хосты в группу на основе условных выражений Jinja2. | |
| host_filters строка | Это можно использовать для ограничения списка возвращаемых хостов | ||
| hostnames список / элементы=строка | По умолчанию: ["name"] | Список шаблонов в порядке приоритета для составления inventory_hostname. Если шаблон приводит к пустой строке или значению None, он игнорируется. | |
| keyed_groups список / элементы=строка | По умолчанию: [] | Добавить хосты в группу на основе значений переменной. | |
| legacy_hostvars логическое значение |
| Переключатель, если true, плагин создаст legacy hostvars, присутствующие в скрипте foreman Размещает hostvars в словаре с ключами `foreman`, `foreman_facts` и `foreman_params` | |
| max_timeout целое число | По умолчанию: 600 | Таймаут перед переходом к старому API хоста при использовании конечной точки report_data при опросе. | |
| password строка / обязательно | переменные среды:FOREMAN_PASSWORD | Пароль пользователя, который обращается к серверу Foreman. | |
| plugin строка / обязательно |
| токен, гарантирующий, что это исходный файл для foreman плагина. | |
| poll_interval целое число | По умолчанию: 10 | Интервал опроса между двумя вызовами конечной точки report_data при опросе. | |
| report словарь | Конфигурация, специфичная для API отчетов, устарела. Вы можете передать параметры, специфичные для API отчетов, как часть этого словаря, вместо основной конфигурации. Только для обратной совместимости. | ||
| strict логическое значение |
| Если yes сделать недействительные записи ошибкой, иначе пропустить и продолжить.Поскольку можно использовать факты в выражениях, они могут быть не всегда доступны, и мы игнорируем эти ошибки по умолчанию. | |
| url строка | По умолчанию: "http://localhost:3000" | переменные среды:FOREMAN_SERVER переменные среды:FOREMAN_SERVER_URL переменные среды:FOREMAN_URL | URL сервера Foreman. |
| use_reports_api логическое значение |
| Использовать Reporting API. | |
| user строка / обязательно | переменные среды:FOREMAN_USER переменные среды:FOREMAN_USERNAME | Имя пользователя, который обращается к серверу Foreman. | |
| validate_certs логическое значение |
| переменные среды:FOREMAN_VALIDATE_CERTS | Подтверждать ли сертификаты TLS сервера Foreman. |
| vars_prefix строка | По умолчанию: "foreman_" | префикс для применения к переменным хоста, не включает факты и параметры | |
| want_content_facet_attributes логическое значение |
| Переключатель, если true, инвентаризация получит детали представления содержимого, к которому привязан хост. | |
| want_facts логическое значение |
| Переключатель, если true, плагин получит данные о фактах хоста от сервера | |
| want_host_group логическое значение |
| Переключатель, если true, инвентаризация получит host_groups и создаст группировки для них. | |
| want_hostcollections логическое значение |
| Переключатель, если true, плагин создаст группы Ansible для коллекций хостов | |
| want_ipv4 логическое значение |
| Переключатель, если true, инвентаризация получит IP-адрес IPv4 хоста. | |
| want_ipv6 логическое значение |
| Переключатель, если true, инвентаризация получит IP-адрес IPv6 хоста. | |
| want_location логическое значение |
| Переключатель, если true, инвентаризация получит расположение, к которому принадлежит хост, и создаст группировки для него. | |
| want_organization логическое значение |
| Переключатель, если true, инвентаризация получит организацию, к которой принадлежит хост, и создаст группировки для нее. | |
| want_params логическое значение |
| Переключатель, если true, инвентаризация получит информацию 'all_parameters' как переменные хоста | |
| want_smart_proxies логическое значение |
| Переключатель, если true, инвентаризация получит умный прокси, к которому зарегистрирован хост. | |
| want_subnet логическое значение |
| Переключатель, если true, инвентаризация получит подсеть. | |
| want_subnet_v6 логическое значение |
| Переключатель, если true, инвентаризация получит подсеть IPv6. | |
| want_location логическое значение |
| Переключатель, если true, инвентаризация получит расположение, к которому принадлежит хост, и создаст группировки для него. |
Примеры
# my.foreman.yml
plugin: theforeman.foreman.foreman
url: https://foreman.example.com
user: ansibleinventory
password: changeme
host_filters: 'organization="Web Engineering"'
# shortname.foreman.yml
plugin: theforeman.foreman.foreman
url: https://foreman.example.com
user: ansibleinventory
password: changeme
hostnames:
- name.split('.')[0]
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/theforeman/foreman/foreman_inventory.html
