hetzner.hcloud.hcloud_load_balancer_service – Создание и управление службами облачных балансировщиков нагрузки на Hetzner Cloud.

Примечание

Этот плагин входит в коллекцию hetzner.hcloud (версия 1.2.1).

Для его установки используйте: ansible-galaxy collection install hetzner.hcloud.

Для использования в плейбуке укажите: hetzner.hcloud.hcloud_load_balancer_service.

Новое в версии 0.1.0: of hetzner.hcloud

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

Обзор

Создание, обновление и управление службами облачных балансировщиков нагрузки на Hetzner Cloud.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

hcloud-python >= 1.0.0
hcloud-python >= 1.8.1

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
api_token строка / обязательно				Это токен API для Hetzner Cloud.
destination_port целое число				Порт, на который перенаправляется трафик, т.е. порт, на котором целевые узлы слушают и принимают соединения. Требуется, если службы не существуют и протокол - tcp.
endpoint строка			По умолчанию: "https://api.hetzner.cloud/v1"	Это конечная точка API для Hetzner Cloud.
health_check словарь				Настройка проверок состояния
	http словарь			Дополнительная настройка проверок состояния для протоколов http/https
		domain строка		Домен, который будет установлен в заголовке HTTP HOST
		path строка		Путь, который будет запрошен
		response строка		Ожидаемый ответ; если ответ не соответствует ожидаемому в ходе проверки состояния, целевой узел считается неработоспособным
		status_codes список / элементы=строка		Список ожидаемых кодов состояния HTTP при выполнении проверки состояния.
		tls булево	Варианты: нет ← да	Проверка сертификата TLS, доступно только если протокол проверки состояния - https
	interval целое число			Интервал проверок состояния в секундах
	port целое число			Порт, на котором будет проводиться проверка состояния
	protocol строка		Варианты: http https tcp	Протокол, по которому будут выполняться проверки состояния
	retries целое число			Количество попыток, прежде чем целевой узел будет помечен как неработоспособный
	timeout целое число			Таймаут проверок состояния в секундах
http словарь				Настройка для служб HTTP и HTTPS
	certificates список / элементы=строка			Список имён или идентификаторов сертификатов
	cookie_lifetime целое число			Срок действия cookie, который будет установлен при включении сессий с сохранением состояния, в секундах
	cookie_name строка			Имя cookie, которое будет установлено при включении сессий с сохранением состояния
	redirect_http булево		Варианты: нет ← да	Перенаправление трафика с порта 80 на порт 443, доступно только если протокол - https
	sticky_sessions булево		Варианты: нет ← да	Включить или отключить sticky_sessions
listen_port целое число / обязательно				Порт, на котором служба прослушивает соединения, т.е. порт, к которому могут подключаться пользователи.
load_balancer строка / обязательно				Имя балансировщика нагрузки Hetzner Cloud, к которому принадлежит служба
protocol строка			Варианты: http https tcp	Протокол службы. Требуется, если балансировщик нагрузки не существует.
proxyprotocol булево			Варианты: нет ← да	Включить протокол PROXY.
state строка			Варианты: absent present ←	Состояние балансировщика нагрузки.

См. также

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

Примеры

- name: Create a basic Load Balancer service with Port 80
  hcloud_load_balancer_service:
    load_balancer: my-load-balancer
    protocol: http
    listen_port: 80
    state: present

- name: Ensure the Load Balancer is absent (remove if needed)
  hcloud_load_balancer_service:
    load_balancer: my-Load Balancer
    protocol: http
    listen_port: 80
    state: absent

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

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

Ключевые значения				Возвращаемое значение	Описание
hcloud_load_balancer_service сложный				Всегда	Экземпляр службы балансировщика нагрузки
	destination_port целое число			всегда	Порт, на который перенаправляется трафик, т.е. порт, на котором целевые серверы слушают и принимают подключения. Пример: 80
	health_check сложный			всегда	Настройка проверок состояния
		http сложный		всегда	Дополнительная настройка проверок состояния с протоколами http/https
			domain строка	всегда	Домен, который будет установлен в заголовке HTTP HOST Пример: example.com
			path строка	всегда	Путь, к которому будет осуществляться доступ Пример: /
			response строка	всегда	Ожидаемый ответ; если ответ не соответствует проверке состояния, целевой сервер считается неисправным
			status_codes список / элементы=строка	всегда	Список кодов HTTP-статусов, которые ожидаются при проведении проверки состояния. Пример: ['2??', '3??']
			tls булево	всегда	Проверить сертификат TLS, доступно только если протокол проверки состояния — https
		interval целое число		всегда	Интервал проверок состояния в секундах Пример: 15
		port целое число		всегда	Порт, на котором будет выполняться проверка состояния Пример: 80
		protocol строка		всегда	Протокол, по которому будут выполняться проверки состояния Пример: http
		retries целое число		всегда	Количество попыток повторной проверки, прежде чем целевой сервер будет помечен как неисправный Пример: 3
		timeout целое число		всегда	Время ожидания проверок состояния в секундах Пример: 10
	http сложный			всегда	Настройка для HTTP и HTTPS-сервисов
		certificates список / элементы=строка		всегда	Список имён или идентификаторов сертификатов
		cookie_lifetime целое число		всегда	Срок действия cookie, который будет установлен при включении сессий с сохранением состояния, в секундах Пример: 3600
		cookie_name строка		всегда	Имя cookie, которое будет установлено при включении сессий с сохранением состояния Пример: HCLBSTICKY
		redirect_http булево		всегда	Перенаправление трафика с порта 80 на порт 443, доступно только если протокол — https
		sticky_sessions булево		всегда	Включить или отключить sticky_sessions Пример: True
	listen_port целое число			всегда	Порт, на котором служба слушает, т.е. порт, к которому пользователи могут подключиться. Пример: 443
	load_balancer строка			всегда	Название балансировщика нагрузки, к которому относится служба Пример: my-load-balancer
	protocol строка			всегда	Протокол службы Пример: http
	proxyprotocol булево			всегда	Включить протокол PROXY.

Авторы

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.10/collections/hetzner/hcloud/hcloud_load_balancer_service_module.html