Spec-Zone.ru › Ansible 2.11

community.aws.ec2_lc_find – Поиск конфигураций запуска AWS Autoscaling

Примечание

Этот плагин входит в коллекцию community.aws (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install community.aws.

Для использования в книге задач укажите: community.aws.ec2_lc_find.

Новое в версии 1.0.0: коллекции community.aws

  • Обзор
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

  • Возвращает список соответствующих конфигураций запуска для заданного имени, а также другую полезную информацию.
  • Результаты могут быть отсортированы и порезаны.
  • Зависит от boto.
  • Основано на работе Тома Бэмфорда https://github.com/tombamford

Требования

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

  • boto
  • boto3
  • python >= 2.6

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
aws_access_key
строка
Ключ доступа AWS. Если не задан, используется значение переменной среды AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY.
Если задан параметр profile, этот параметр игнорируется.
Передача параметров aws_access_key и profile одновременно устарела и параметры станут взаимоисключающими после 2022-06-01.

псевдонимы: ec2_access_key, access_key
aws_ca_bundle
путь
Расположение файла с пакетом сертификатов доверенных центров сертификации (CA) для проверки SSL-сертификатов.
Используется только для модулей на основе boto3.
Примечание: пакет CA считывается на стороне модуля и может потребоваться явное копирование с контроллера, если он не выполняется локально.
aws_config
словарь
Словарь для модификации конфигурации botocore.
Параметры можно найти по адресу https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config.
Для модулей boto используется только ключ 'user_agent'. См. http://boto.cloudhackers.com/en/latest/boto_config_tut.html#boto для получения дополнительной информации о конфигурации boto.
aws_secret_key
строка
Секретный ключ AWS. Если не задан, используется значение переменной среды AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY.
Если задан параметр profile, этот параметр игнорируется.
Передача параметров aws_secret_key и profile одновременно устарела и параметры станут взаимоисключающими после 2022-06-01.

псевдонимы: ec2_secret_key, secret_key
debug_botocore_endpoint_logs
логическое значение
    Варианты:
  • нет ←
  • да
Используйте логирования botocore.endpoint для разбора уникальных (а не общих) API-вызовов «ресурс:действие», выполняемых во время задачи, выводит набор в ключ task_results. Используйте обратный вызов aws_resource_action для вывода в общий список, созданный во время выполнения книги задач. Также может быть использована переменная среды ANSIBLE_DEBUG_BOTOCORE_LOGS.
ec2_url
строка
URL для подключения к облаку EC2 или Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной среды EC2_URL, если таковая имеется.

псевдонимы: aws_endpoint_url, endpoint_url
limit
целое число
Количество результатов, которое нужно отобразить.
Соответствует синтаксису среза в Python, например, list[:limit].
name_regex
строка / обязательный
Конфигурация запуска для сопоставления.
Будет скомпилирована как регулярное выражение.
profile
строка
Использует профиль boto. Работает только с boto >= 2.24.0.
Использование profile переопределяет aws_access_key, aws_secret_key и security_token, и поддержка их передачи одновременно с profile устарела.
aws_access_key, aws_secret_key и security_token будут взаимоисключающими с profile после 2022-06-01.

псевдонимы: aws_profile
region
строка
Регион AWS, который необходимо использовать. Если не указан, используется значение переменной среды AWS_REGION или EC2_REGION, если таковая имеется. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region

псевдонимы: aws_region, ec2_region
security_token
строка
Токен безопасности AWS STS. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN.
Если задан параметр profile, этот параметр игнорируется.
Передача параметров security_token и profile одновременно устарела и параметры станут взаимоисключающими после 2022-06-01.

псевдонимы: aws_security_token, access_token
sort_order
строка
    Варианты:
  • по возрастанию ←
  • по убыванию
Порядок сортировки результатов.
validate_certs
логическое значение
    Варианты:
  • нет
  • да ←
Если установлено в «нет», SSL-сертификаты не будут проверяться для версий boto >= 2.6.0.

Примечания

Примечание

  • Если параметры не заданы в модуле, могут быть использованы следующие переменные среды в порядке убывания приоритета AWS_URL или EC2_URL, AWS_PROFILE или AWS_DEFAULT_PROFILE, 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, AWS_CA_BUNDLE
  • 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.

- name: Search for the Launch Configurations that start with "app"
  community.aws.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


Авторы

  • Хосе Арместо (@fiunchinho)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/aws/ec2_lc_find_module.html

Spec-Zone.ru

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