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 boolean |
| По умолчанию целевые серверы, которые не используются, остаются зарегистрированными. Если необходимо их удалить, установите deregister_unused в значение "да". |
| 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 boolean добавлен в 1.5 |
| При значении "нет" сертификаты SSL для boto-версий >= 2.6.0 не будут проверятся. |
Примечания
Примечание
- Если при регистрации целевого сервера был указан альтернативный порт, необходимо указать и ID целевого сервера, и порт при снятии его с регистрации.
- Если параметры не установлены в модуле, можно использовать следующие переменные окружения в порядке убывания приоритета
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: 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
Статус
- Этот модуль не гарантирует обратной совместимости. [превью]
- Этот модуль поддерживается сообществом 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.7/modules/elb_target_module.html