Модуль hetzner.hcloud.load_balancer_target — управление целями балансировщика нагрузки Hetzner Cloud

Примечание

Этот модуль входит в коллекцию hetzner.hcloud (версия 6.9.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install hetzner.hcloud. Для использования этого модуля требуются дополнительные зависимости; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: hetzner.hcloud.load_balancer_target.

Добавлено в hetzner.hcloud 0.1.0

Краткое описание
Требования
Параметры
См. также
Примеры
Возвращаемые значения

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

Создание и удаление целей балансировщика нагрузки Hetzner Cloud

Псевдонимы: hcloud_load_balancer_target

Требования

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

python-dateutil >= 2.7.5
requests >=2.20

Параметры

Параметр	Комментарии
api_endpoint псевдонимы: endpoint строка	Конечная точка API Hetzner Cloud. Это значение также можно задать с помощью переменной среды `HCLOUD_ENDPOINT`. По умолчанию: `"https://api.hetzner.cloud/v1"`
api_endpoint_hetzner строка	Конечная точка API Hetzner. Это значение также можно задать с помощью переменной среды `HETZNER_ENDPOINT`. По умолчанию: `"https://api.hetzner.com/v1"`
api_token строка / обязательный	Токен API Hetzner Cloud. Это значение также можно задать с помощью переменной среды `HCLOUD_TOKEN`.
ip строка	IP-адрес выделенного сервера Hetzner; сервер должен принадлежать тому же пользователю, что и проект. Обязательный параметр, если type имеет значение ip
label_selector строка	Селектор меток, используемый для динамического определения целей Обязательный параметр, если type имеет значение label_selector
load_balancer строка / обязательный	Имя или идентификатор балансировщика нагрузки Hetzner Cloud.
server строка	Имя или идентификатор сервера Hetzner Cloud. Обязательный параметр, если type имеет значение server
state строка	Состояние load_balancer_network. Варианты: `"absent"` `"present"` ← (по умолчанию)
type строка / обязательный	Тип цели. Варианты: `"server"` `"label_selector"` `"ip"`
use_private_ip логическое значение	Направлять трафик через частный IP-адрес балансировщика нагрузки по сети Hetzner Cloud. Балансировщик нагрузки должен быть подключён к сети. См. hetzner.hcloud.load_balancer_network Варианты: `false` ← (по умолчанию) `true`

См. также

Документация по API Hetzner: Полный справочник по API Hetzner.

Примеры

- name: Create a server Load Balancer target
  hetzner.hcloud.load_balancer_target:
    type: server
    load_balancer: my-LoadBalancer
    server: my-server
    state: present

- name: Create a label_selector Load Balancer target
  hetzner.hcloud.load_balancer_target:
    type: label_selector
    load_balancer: my-LoadBalancer
    label_selector: application=backend
    state: present

- name: Create an IP Load Balancer target
  hetzner.hcloud.load_balancer_target:
    type: ip
    load_balancer: my-LoadBalancer
    ip: 127.0.0.1
    state: present

- name: Ensure the Load Balancer target is absent (remove if needed)
  hetzner.hcloud.load_balancer_target:
    type: server
    load_balancer: my-LoadBalancer
    server: my-server
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
hcloud_load_balancer_target словарь	Связь между балансировщиком нагрузки и сетью Возвращается: всегда
ip строка	IP-адрес выделенного сервера Возвращается: если type имеет значение ip Образец: `"127.0.0.1"`
label_selector строка	Селектор меток Возвращается: если type имеет значение label_selector Образец: `"application=backend"`
load_balancer строка	Имя балансировщика нагрузки Возвращается: всегда Образец: `"my-LoadBalancer"`
server строка	Имя сервера Возвращается: если type имеет значение server Образец: `"my-server"`
type строка	Тип цели балансировщика нагрузки Возвращается: всегда Образец: `"server"`
use_private_ip логическое значение	Направлять трафик через частный IP-адрес балансировщика нагрузки по сети Hetzner Cloud. Балансировщик нагрузки должен быть подключён к сети. См. hetzner.hcloud.load_balancer_network Возвращается: всегда Образец: `true`

Авторы

Lukas Kaemmerling (@lkaemmerling)

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

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