vultr – Источник инвентаризации Vultr
Новая версия 2.7.
Обзор
- Получение хостов инвентаризации из публичного облака Vultr.
- Использует файл конфигурации YAML, заканчивающийся либо vultr.yml, либо vultr.yaml, для установки значений параметров (также см. примеры).
- Использует api_config, ~/.vultr.ini, ./vultr.ini или
VULTR_API_CONFIG, указывающие на файл INI с учетными данными Vultr (см. https://docs.ansible.com/ansible/latest/scenario_guides/guide_vultr.html).
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| api_account строка | Значение по умолчанию: "default" | Укажите используемый аккаунт. | |
| api_config путь | env:VULTR_API_CONFIG | Путь к файлу конфигурации vultr. Если не указан, будет взят из стандартной конфигурации Vultr. | |
| api_key строка | env:VULTR_API_KEY | Ключ API Vultr. Если не указан, будет взят из стандартной конфигурации Vultr. | |
| compose словарь добавлено в 2.8 | Значение по умолчанию: {} | Создание переменных из выражений Jinja2. | |
| filter_by_tag строка добавлено в 2.8 | Возвращать только серверы, отфильтрованные по этому тегу | ||
| groups словарь добавлено в 2.8 | Значение по умолчанию: {} | Добавление хостов в группу на основе условных выражений Jinja2. | |
| hostname строка |
| Поле для соответствия имени хоста. Примечание: v4_main_ip соответствует полю main_ip, возвращаемому API, а имя – метке. | |
| keyed_groups список добавлено в 2.8 | Значение по умолчанию: [] | Добавление хостов в группу на основе значений переменной. | |
| plugin строка / обязательно |
| Токен, гарантирующий, что это файл источника для плагина 'vultr'. | |
| strict булево добавлено в 2.8 |
| Если yes сделать недействительные записи ошибкой, иначе пропустить и продолжить.Поскольку для выражений можно использовать факты, они могут быть не всегда доступны, и мы по умолчанию игнорируем такие ошибки. |
Примеры
# inventory_vultr.yml file in YAML format
# Example command line: ansible-inventory --list -i inventory_vultr.yml
# Group by a region as lower case and with prefix e.g. "vultr_region_amsterdam" and by OS without prefix e.g. "CentOS_7_x64"
plugin: vultr
keyed_groups:
- prefix: vultr_region
key: region | lower
- separator: ""
key: os
# Pass a tag filter to the API
plugin: vultr
filter_by_tag: Cache
Статус
- Этот инвентарь не гарантирует обратную совместимость. [превью]
- Этот инвентарь поддерживается сообществом Ansible. [сообщество]
Авторы
- Yanis Guenane (@Spredzy)
- René Moser (@resmo)
Подсказка
Если вы обнаружите какие-либо проблемы в данной документации, вы можете редактировать этот документ, чтобы улучшить его.
Подсказка
Записи конфигурации для каждого типа имеют порядок приоритета снизу вверх. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/plugins/inventory/vultr.html
