ec2_asg_lifecycle_hook – Создание, удаление или обновление циклов жизни AWS ASG

Новая версия 2.5.

Описание
Требования
Параметры
Примечания
Примеры
Статус

Описание

При отсутствии указанного цикла создаст новый.
Если цикл найден, но предоставленные параметры отличаются, обновит существующий цикл.
Если состояние = absent и цикл существует, удалит его.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться данный модуль.

boto
boto3>=1.4.4
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
autoscaling_group_name - / обязательно		Имя группы автоматического масштабирования, к которой вы хотите назначить цикл жизни.
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:action», сделанных во время задачи, выводя набор в ключ resource_actions в результатах задачи. Используйте обратный вызов aws_resource_action для вывода в общий список, созданный во время выполнения playbook. Может также использоваться переменная среды ANSIBLE_DEBUG_BOTOCORE_LOGS.
default_result -	Варианты: ABANDON ← CONTINUE	Определяет действие, которое группа автоматического масштабирования должна выполнить, если таймаут цикла жизни истек или произошла непредвиденная ошибка. Этот параметр может быть либо CONTINUE, либо ABANDON.
ec2_url строка		Адрес, используемый для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль будет использовать конечные точки EC2). Игнорируется в модулях, где требуется регион. Должен быть указан во всех остальных модулях, если регион не используется. Если не указан, используется значение переменной среды EC2_URL, если она существует.
heartbeat_timeout -	По умолчанию: "3600 (1 час)"	Время в секундах, которое может пройти, прежде чем истечет таймаут цикла жизни. При истечении таймаута цикла жизни автоматическое масштабирование выполняет действие по умолчанию. Вы можете предотвратить истечение таймаута цикла жизни, вызвав RecordLifecycleActionHeartbeat.
lifecycle_hook_name - / обязательно		Имя цикла жизни.
notification_meta_data -		Содержит дополнительную информацию, которую вы хотите включить всякий раз, когда автоматическое масштабирование отправляет сообщение целевому объекту уведомления.
notification_target_arn -		ARN целевого объекта уведомления, который автоматическое масштабирование будет использовать для уведомления вас, когда экземпляр находится в состоянии перехода для цикла жизни. Этот объект может быть либо очередью SQS, либо темой SNS. Если вы укажете пустую строку, это переопределяет текущий ARN.
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
role_arn -		ARN роли IAM, которая разрешает группе автоматического масштабирования публиковать в указанный целевой объект уведомления.
security_token строка		Токен безопасности AWS STS. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token
state -	Варианты: present ← absent	Создание или удаление цикла жизни. Present обновляет существующий цикл или создает его, если он не найден.
transition - / обязательно	Варианты: autoscaling:EC2_INSTANCE_TERMINATING autoscaling:EC2_INSTANCE_LAUNCHING	Состояние экземпляра, к которому вы хотите прикрепить цикл жизни.
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

Примеры

# Create / Update lifecycle hook
- ec2_asg_lifecycle_hook:
    region: eu-central-1
    state: present
    autoscaling_group_name: example
    lifecycle_hook_name: example
    transition: autoscaling:EC2_INSTANCE_LAUNCHING
    heartbeat_timeout: 7000
    default_result: ABANDON

# Delete lifecycle hook
- ec2_asg_lifecycle_hook:
    region: eu-central-1
    state: absent
    autoscaling_group_name: example
    lifecycle_hook_name: example

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Игорь 'Tsigankov' Eyrich (@tsiganenok) <tsiganenok@gmail.com>

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 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/ec2_asg_lifecycle_hook_module.html