Spec-Zone.ru › Ansible 2.5

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
    Варианты:
  • yes
  • no
По умолчанию целевые ресурсы, которые не используются, остаются зарегистрированными. Для их удаления установите 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
обязательно
    Варианты:
  • present
  • absent
Регистрация или отмена регистрации целевого ресурса.
target_az
Зона доступности или все зоны. Определяет, получает ли целевой ресурс трафик от узлов балансировщика нагрузки в указанной зоне доступности или из всех активных зон доступности для балансировщика. Этот параметр не поддерживается, если тип целевого ресурса в группе целевых ресурсов — экземпляр.
target_group_arn
Amazon Resource Name (ARN) группы целевых ресурсов. Взаимоисключающий с target_group_name.
target_group_name
Имя группы целевых ресурсов. Взаимоисключающий с target_group_arn.
target_id
обязательно
Идентификатор целевого ресурса.
target_port По умолчанию:
Порт по умолчанию для целевого ресурса — порт группы целевых ресурсов.
Порт, на котором прослушивает целевой ресурс. Можно указать альтернативный порт. Если целевой ресурс уже зарегистрирован, можно зарегистрировать его снова с использованием другого порта.
target_status
    Варианты:
  • initial
  • healthy
  • unhealthy
  • unused
  • draining
  • unavailable
Блокирует и ожидает, пока статус целевого ресурса не станет равным заданному значению. Дополнительные сведения о статусах целевых ресурсов см. в 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
  • yes ←
При значении "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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API