elb_target — Управление целевым ресурсом в группе целевых ресурсов
Новое в версии 2.5.
Обзор
- Используется для регистрации или отмены регистрации целевого ресурса в группе целевых ресурсов
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- boto
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aws_access_key | По умолчанию: None |
Ключ доступа AWS. Если не задан, используется значение переменной среды AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY.
Псевдонимы: ec2_access_key, access_key |
| aws_secret_key | По умолчанию: None |
Секретный ключ AWS. Если не задан, используется значение переменной среды AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY.
Псевдонимы: ec2_secret_key, secret_key |
| deregister_unused |
|
По умолчанию целевые ресурсы, которые не используются, остаются зарегистрированными. Для их удаления установите deregister_unused в значение yes. |
| ec2_url | По умолчанию: None |
URL для подключения к EC2 или облаку Eucalyptus (по умолчанию используется конечная точка EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если не используется регион. Если не задан, используется значение переменной среды EC2_URL, если она задана. |
| profile (добавлен в 1.6) |
По умолчанию: None |
Использует профиль 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) |
По умолчанию: None |
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 |
|
Блокирует и ожидает, пока статус целевого ресурса не станет равным заданному значению. Дополнительные сведения о статусах целевых ресурсов см. в http://docs.aws.amazon.com/elasticloadbalancing/latest/application/target-group-health-checks.html#target-health-states
|
| target_status_timeout | По умолчанию: 60 |
Максимальное время ожидания в секундах изменения статуса целевого ресурса |
| validate_certs (добавлен в 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
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется обратной совместимостью.
Автор
- 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.5/modules/elb_target_module.html