hcloud – Ansible динамический плагин инвентаризации для Hetzner Cloud

Новый в версии 2.8.

Обзор
Требования
Параметры
Примеры
Статус

Обзор

Читает инвентаризацию из API Hetzner Cloud.
Использует файл конфигурации YAML, который заканчивается на hcloud.(yml|yaml).

Требования

Ниже приведены требования к локальному узлу-мастеру, который выполняет эту инвентаризацию.

python >= 2.7
hcloud-python >= 1.0.0

Параметры

Параметр	Варианты/Значения по умолчанию	Конфигурация	Комментарии
compose словарь	По умолчанию: {}		Создаёт переменные из выражений jinja2.
connect_with строка	Варианты: public_ipv4 ← hostname ipv4_dns_ptr		Подключается к серверу, используя значение из этого поля.
groups словарь	По умолчанию: {}		Добавляет хосты в группу, основываясь на условных выражениях Jinja2.
images список	По умолчанию: []		Заполняет инвентаризацию экземплярами с этим именем образа, доступно только для системных образов.
keyed_groups список	По умолчанию: []		Добавляет хосты в группу, основываясь на значениях переменной.
label_selector строка	По умолчанию: ""		Заполняет инвентаризацию экземплярами с этим тегом.
locations список	По умолчанию: []		Заполняет инвентаризацию экземплярами в этом регионе.
plugin - / обязательно	Варианты: hcloud		Помечает это как экземпляр плагина "hcloud".
strict булево	Варианты: нет ← да		Если `yes` сделать недействительные записи ошибкой, иначе пропустить и продолжить. Поскольку можно использовать факты в выражениях, они могут не всегда быть доступны, и мы игнорируем эти ошибки по умолчанию.
token - / обязательно		env:HCLOUD_TOKEN	Токен API Hetzner Cloud.
types список	По умолчанию: []		Заполняет инвентаризацию экземплярами с этим типом.

Примеры

# Minimal example. `HCLOUD_TOKEN` is exposed in environment.
plugin: hcloud

# Example with locations, types, groups and token
plugin: hcloud
token: foobar
locations:
  - nbg1
types:
  - cx11

# Group by a location with prefix e.g. "hcloud_location_nbg1"
# and image_os_flavor without prefix and separator e.g. "ubuntu"
# and status with prefix e.g. "server_status_running"
plugin: hcloud
keyed_groups:
  - key: location
    prefix: hcloud_location
  - key: image_os_flavor
    separator: ""
  - key: status
    prefix: server_status

Статус

Этот инвентарь не гарантирует обратной совместимости. [превью]
Эта инвентаризация поддерживается сообществом Ansible. [сообщество]

Авторы

Lukas Kaemmerling (@lkaemmerling)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

Подсказка

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

© 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/hcloud.html