ec2_lc_find - Поиск конфигураций запуска экземпляров AWS Autoscaling
Новая версия 2.2.
Обзор
- Возвращает список соответствующих конфигураций запуска экземпляров для заданного имени вместе с другой полезной информацией
- Результаты могут быть отсортированы и ограничены
- Зависит от 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 | |
| ec2_url | URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если она есть. | |
| limit | Количество результатов для отображения. Соответствует обозначению среза в Python, например, list[:limit]. | |
| name_regex обязательно | Конфигурация запуска экземпляра для поиска Будет скомпилирована как регулярное выражение | |
| profile (добавлен в 1.6) | Использует профиль boto. Работает только с boto >= 2.24.0. | |
| region обязательно | Регион AWS для использования. Псевдонимы: aws_region, ec2_region | |
| security_token (добавлен в 1.6) | Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token | |
| sort_order |
| Порядок сортировки результатов. |
| validate_certs bool (добавлен в 1.5) |
| При значении "нет", сертификаты 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.
# 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 строка | при нахождении конфигурации запуска экземпляра | Идентификатор AMI Пример: ami-0d75df7e |
| instance_monitoring строка | при нахождении конфигурации запуска экземпляра | Свойство мониторинга экземпляра конфигурации запуска экземпляра Пример: {'Enabled': False} |
| instance_type строка | при нахождении конфигурации запуска экземпляра | Тип экземпляра ec2 Пример: t2.small |
| kernel_id строка | при нахождении конфигурации запуска экземпляра | Ядро конфигурации запуска экземпляра для использования |
| keyname строка | при нахождении конфигурации запуска экземпляра | Ключ SSH конфигурации запуска экземпляра Пример: mykey |
| name строка | при нахождении конфигурации запуска экземпляра | Имя конфигурации запуска экземпляра Пример: myapp-v123 |
| ram_disk_id строка | при нахождении конфигурации запуска экземпляра | Свойство диска RAM конфигурации запуска экземпляра |
| security_groups список | при нахождении конфигурации запуска экземпляра | Группы безопасности конфигурации запуска экземпляра |
| user_data строка | при нахождении конфигурации запуска экземпляра | Данные пользователя, используемые для запуска экземпляра Пример: ZXhwb3J0IENMT1VE |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Поддержка и техническое обслуживание модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Хосе Арместо (@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.6/modules/ec2_lc_find_module.html