ec2_lc_find – Поиск конфигураций запуска AWS Autoscaling
Описание
- Возвращает список соответствующих конфигураций запуска для заданного имени, а также другую полезную информацию
- Результаты могут быть отсортированы и ограничены
- Зависит от модуля boto
- Основано на работе Тома Бэмфорда (https://github.com/tombamford)
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- boto
- boto3
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| 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 для вывода в общий список, созданный во время выполнения плейбука. Также можно использовать переменную окружения ANSIBLE_DEBUG_BOTOCORE_LOGS. |
| ec2_url строка | URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если таковая имеется. | |
| limit - | Количество результатов для отображения. Соответствует нотации срезов Python, например, list[:limit]. | |
| name_regex - / обязательно | Конфигурация запуска, которую нужно сопоставить Будет скомпилирована как регулярное выражение | |
| profile строка | Использует профиль boto. Работает только с boto >= 2.24.0. | |
| region - / обязательно | Регион AWS для использования. псевдонимы: aws_region, ec2_region | |
| security_token строка | Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token | |
| sort_order - |
| Порядок сортировки результатов. |
| 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
Примеры
# Note: These examples do not set authentication details, see the AWS Guide for details.
# Search for the Launch Configurations that start with "app"
- ec2_lc_find:
name_regex: app.*
sort_order: descending
limit: 2
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| arn строка | при обнаружении конфигурации запуска | Имя AMI Пример: arn:aws:autoscaling:eu-west-1:12345:launchConfiguration:d82f050e-e315:launchConfigurationName/yourproject |
| associate_public_address булево | при обнаружении конфигурации запуска | Назначить общедоступный адрес или нет Пример: True |
| block_device_mappings список | при обнаружении конфигурации запуска | Свойства отображений блочных устройств конфигурации запуска |
| classic_link_vpc_security_groups список | при обнаружении конфигурации запуска | Свойства групп безопасности VPC классической связи конфигурации запуска |
| created_time строка | при обнаружении конфигурации запуска | Время создания Пример: 2016-06-29T14:59:22.222000+00:00 |
| ebs_optimized булево | при обнаружении конфигурации запуска | Свойство оптимизации EBS конфигурации запуска |
| image_id строка | при обнаружении конфигурации запуска | ID AMI Пример: ami-0d75df7e |
| instance_monitoring строка | при обнаружении конфигурации запуска | Свойство мониторинга экземпляра конфигурации запуска Пример: {'Enabled': False} |
| instance_type строка | при обнаружении конфигурации запуска | Тип экземпляра ec2 Пример: t2.small |
| kernel_id строка | при обнаружении конфигурации запуска | Ядро конфигурации запуска |
| keyname строка | при обнаружении конфигурации запуска | SSH ключ конфигурации запуска Пример: mykey |
| name строка | при обнаружении конфигурации запуска | Имя конфигурации запуска Пример: myapp-v123 |
| ram_disk_id строка | при обнаружении конфигурации запуска | Свойство дисковой памяти конфигурации запуска |
| security_groups список | при обнаружении конфигурации запуска | Группы безопасности конфигурации запуска |
| user_data строка | при обнаружении конфигурации запуска | Данные пользователя, используемые для запуска экземпляра Пример: ZXhwb3J0IENMT1VE |
Статус
- Данный модуль не гарантирует обратной совместимости. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Jose Armesto (@fiunchinho)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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_lc_find_module.html