community.general.gce_lb – создание/удаление ресурсов балансировщика нагрузки GCE
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в плейбуке укажите: community.general.gce_lb.
Обзор
- Этот модуль может создавать и удалять ресурсы балансировщика нагрузки Google Compute Engine
loadbalancerиhttphealthcheck. Основной ресурс балансировщика – это ресурсload_balancer, а параметры проверки работоспособности всех имеют префикс httphealthcheck. Полная документация по балансировке нагрузки Google Compute Engine находится по адресу https://developers.google.com/compute/docs/load-balancing/. Однако модуль ansible упрощает конфигурацию, следуя модели libcloud. Полные инструкции по установке и конфигурации модулей gce* можно найти в комментариях к файлу ansible/test/gce_tests.py.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- apache-libcloud >= 0.13.3, >= 0.17.0 при использовании JSON-креденциалов
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| credentials_file путь | путь к JSON-файлу, связанному с электронной почтой учетной записи службы | |
| external_ip строка | внешний статический IPv4 (или автоматически назначенный) адрес для балансировщика | |
| httphealthcheck_healthy_count целое число | Значение по умолчанию: 2 | количество последовательных успешных проверок перед отметкой узла как активного |
| httphealthcheck_host строка | заголовок хоста для передачи в запросах проверки HTTP | |
| httphealthcheck_interval целое число | Значение по умолчанию: 5 | длительность в секундах между каждым запросом проверки работоспособности |
| httphealthcheck_name строка | идентификатор имени для проверки работоспособности HTTP | |
| httphealthcheck_path строка | Значение по умолчанию: "/" | путь URL для проверки работоспособности HTTP |
| httphealthcheck_port целое число | Значение по умолчанию: 80 | TCP-порт для проверки работоспособности HTTP |
| httphealthcheck_timeout целое число | Значение по умолчанию: 5 | таймаут в секундах до того, как запрос будет считаться неудачной проверкой |
| httphealthcheck_unhealthy_count целое число | Значение по умолчанию: 2 | количество последовательных неудачных проверок перед отметкой узла как неактивного |
| members список / элементы=строка | список пар зона/имя узла, например ['us-central1-a/www-a', ...] | |
| name строка | имя ресурса балансировщика | |
| pem_file путь | путь к файлу pem, связанному с электронной почтой учетной записи службы. Этот параметр устарел. Используйте 'credentials_file'. | |
| port_range строка | порт (диапазон портов) для переадресации, например 80 или 8000-8888. По умолчанию все порты. | |
| project_id строка | ваш идентификатор проекта GCE | |
| protocol строка | Значение по умолчанию: "tcp" | протокол, используемый для переадресации пакетов балансировщиком, tcp или udp Доступные варианты: tcp или udp. |
| region строка | регион GCE, в котором определен балансировщик | |
| service_account_email строка | электронная почта учетной записи службы | |
| state строка | Значение по умолчанию: "present" | желаемое состояние балансировщика Доступные варианты: active, present, absent, deleted. |
Примеры
- name: Simple example of creating a new LB, adding members, and a health check
local_action:
module: gce_lb
name: testlb
region: us-central1
members: ["us-central1-a/www-a", "us-central1-b/www-b"]
httphealthcheck_name: hc
httphealthcheck_port: 80
httphealthcheck_path: "/up"
Авторы
- Eric Johnson (@erjohnso) <erjohnso@google.com>
© 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/community/general/gce_lb_module.html
