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 | |
| deregister_unused bool |
| По умолчанию целевые узлы, которые не используются, остаются зарегистрированными. Если необходимо удалить их, установите deregister_unused в yes. |
| ec2_url | URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если она существует. | |
| profile (добавлено в 1.6) | Использует профиль 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 (добавлено в 1.6) | Токен безопасности AWS STS. Если не задан, используется значение переменной окружения 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 |
| Блокирует и ожидает, пока статус целевого узла будет равен заданному значению. Подробнее о статусе целевого узла см. http://docs.aws.amazon.com/elasticloadbalancing/latest/application/target-group-health-checks.html#target-health-states
|
| target_status_timeout | По умолчанию: 60 | Максимальное время в секундах ожидания изменения статуса целевого узла |
| validate_certs bool (добавлено в 1.5) |
| При значении "no" сертификаты 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), если учетные данные не предоставлены. См. http://boto.readthedocs.org/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: 10.0.0.10
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, что означает, что его интерфейс не гарантированно будет обратной совместимостью.
Техническое обслуживание
Этот модуль помечен как community, что означает, что его поддерживает сообщество Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.
Автор
- 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.6/modules/elb_target_module.html