community.google.gce_lb – создание/удаление ресурсов балансировщика нагрузки GCE
Примечание
Этот плагин входит в коллекцию community.google (версия 1.0.0).
Для его установки используйте: ansible-galaxy collection install community.google.
Чтобы использовать его в книге задач, укажите: community.google.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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/google/gce_lb_module.html
