elb_target – Управление целевым узлом в группе целевых узлов
Новая версия 2.5.
Обзор
- Используется для регистрации или отмены регистрации целевого узла в группе целевых узлов
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- boto
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aws_access_key строка | Ключ доступа AWS. Если не задано, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. псевдонимы: ec2_access_key, access_key | |
| aws_secret_key строка | Секретный ключ AWS. Если не задано, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. псевдонимы: ec2_secret_key, secret_key | |
| debug_botocore_endpoint_logs логический тип добавлен в 2.8 |
| Использовать регистратор botocore.endpoint для анализа уникальных (а не общих) API-вызовов «ресурс:действие», выполненных во время задачи, выводив список в ключ resource_actions результатов задачи. Используйте обратный вызов aws_resource_action для вывода общего списка, выполненного во время выполнения playbook. Переменная окружения ANSIBLE_DEBUG_BOTOCORE_LOGS также может быть использована. |
| deregister_unused логический тип |
| По умолчанию целевые узлы, которые не используются, остаются зарегистрированными. Если нужно их удалить, установите deregister_unused в значение «да». |
| ec2_url строка | URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задано, используется значение переменной окружения EC2_URL, если таковая имеется. | |
| profile строка | Использует профиль boto. Работает только с boto >= 2.24.0. | |
| region строка | AWS регион для использования. Если не указано, используется значение переменной окружения AWS_REGION или EC2_REGION, если таковая имеется. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
псевдонимы: aws_region, ec2_region | |
| security_token строка | AWS STS security token. Если не задано, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token | |
| state - / обязательно |
| Регистрация или отмена регистрации целевого узла. |
| target_az - | Зона доступности или все. Это определяет, получает ли целевой узел трафик от узлов балансировщика нагрузки в указанной зоне доступности или со всех включенных зон доступности для балансировщика нагрузки. Этот параметр не поддерживается, если тип целевого узла группы целевых узлов — это экземпляр. | |
| target_group_arn - | Amazon Resource Name (ARN) группы целевых узлов. Взаимоисключающий с target_group_name. | |
| target_group_name - | Имя группы целевых узлов. Взаимоисключающий с target_group_arn. | |
| target_id - / обязательно | Идентификатор целевого узла. | |
| target_port - | По умолчанию: "Порт по умолчанию для целевого узла — это порт для группы целевых узлов." | Порт на целевом узле. Вы можете указать переопределение порта. Если целевой узел уже зарегистрирован, вы можете зарегистрировать его снова, используя другой порт. |
| target_status - |
| Блокирует и ожидает, пока статус целевого узла не станет равным заданному значению. Для получения дополнительной информации о статусе целевого узла см. https://docs.aws.amazon.com/elasticloadbalancing/latest/application/target-group-health-checks.html#target-health-states
|
| target_status_timeout - | По умолчанию: 60 | Максимальное время в секундах ожидания изменения статуса целевого узла |
| validate_certs логический тип |
| При значении «нет» сертификаты SSL не будут проверены для версий boto >= 2.6.0. |
Примечания
Примечание
- Если вы указали переопределение порта при регистрации целевого узла, вы должны указать и идентификатор целевого узла, и порт при его отмене регистрации.
- Если параметры не заданы в модуле, можно использовать следующие переменные окружения в порядке убывания приоритета
AWS_URLилиEC2_URL,AWS_ACCESS_KEY_IDилиAWS_ACCESS_KEYилиEC2_ACCESS_KEY,AWS_SECRET_ACCESS_KEYилиAWS_SECRET_KEYилиEC2_SECRET_KEY,AWS_SECURITY_TOKENилиEC2_SECURITY_TOKEN,AWS_REGIONилиEC2_REGION - Ansible использует файл конфигурации boto (обычно ~/.boto), если учетные данные не предоставлены. См. https://boto.readthedocs.io/en/latest/boto_config_tut.html
-
AWS_REGIONилиEC2_REGIONобычно используются для указания региона AWS, когда это необходимо, но это также можно настроить в файле конфигурации boto
Примеры
# Note: These examples do not set authentication details, see the AWS Guide for details.
# Register an IP address target to a target group
- elb_target:
target_group_name: myiptargetgroup
target_id: i-1234567
state: present
# Register an instance target to a target group
- elb_target:
target_group_name: mytargetgroup
target_id: i-1234567
state: present
# Deregister a target from a target group
- elb_target:
target_group_name: mytargetgroup
target_id: i-1234567
state: absent
# Modify a target to use a different port
# Register a target to a target group
- elb_target:
target_group_name: mytargetgroup
target_id: i-1234567
target_port: 8080
state: present
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [preview]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Rob White (@wimnat)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/elb_target_module.html