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. Основной ресурс балансировщика (LB) — ресурсload_balancer, а параметры проверки состояния (health check) имеют префикс 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 (или автоматически назначенный) адрес для LB | |
| 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" | желаемое состояние LB допустимые значения: 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/google/gce_lb_module.html
