aws_ec2 - источник инвентаризации ec2
Обзор
- Получение хостов инвентаризации из Amazon Web Services EC2.
- Использует файл конфигурации YAML <name>.aws_ec2.yaml (или <name>.aws_ec2.yml).
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| aws_access_key_id | env:AWS_ACCESS_KEY_ID env:AWS_ACCESS_KEY env:EC2_ACCESS_KEY | Ключ доступа AWS для использования. Если вы указали профиль, вам не нужно указывать ключ доступа/секретный ключ/токен сессии. | |
| aws_secret_access_key | env:AWS_SECRET_ACCESS_KEY env:AWS_SECRET_KEY env:EC2_SECRET_KEY | Секретный ключ AWS, соответствующий ключу доступа. Если вы указали профиль, вам не нужно указывать ключ доступа/секретный ключ/токен сессии. | |
| aws_security_token | env:AWS_SECURITY_TOKEN env:AWS_SESSION_TOKEN env:EC2_SECURITY_TOKEN | Токен безопасности AWS, если используется временный ключ доступа и секретный ключ. | |
| boto_profile | env:AWS_PROFILE env:AWS_DEFAULT_PROFILE | Используемый профиль boto. | |
| cache | Значение по умолчанию: нет | записи ini: [inventory ] env:ANSIBLE_INVENTORY_CACHE | Включить/отключить кеширование данных источника инвентаризации, требует настройки плагина кеша для работы. |
| cache_connection | записи ini: [inventory ] env:ANSIBLE_INVENTORY_CACHE_CONNECTION | Данные подключения к кешу или путь, см. документацию по плагину кеша для подробностей. | |
| cache_plugin | записи ini: [inventory ] env:ANSIBLE_INVENTORY_CACHE_PLUGIN | Плагин кеша для использования данных источника инвентаризации. | |
| cache_timeout | Значение по умолчанию: 3600 | записи ini: [inventory ] env:ANSIBLE_INVENTORY_CACHE_TIMEOUT | Срок хранения кеша в секундах |
| compose | Значение по умолчанию: {} | создание переменных из выражений jinja2 | |
| filters | Словарь пар значений фильтров. Доступные фильтры перечислены здесь http://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html#options
| ||
| groups | Значение по умолчанию: {} | добавление хостов в группу на основе условных выражений Jinja2 | |
| hostnames | Список имен хостов в порядке приоритета. Вы можете использовать параметры, указанные в http://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html#options. Для использования тегов в качестве имен хостов используйте синтаксис тег:Имя=Значение для использования имени хоста Имя_Значение или тег:Имя для использования значения тега Имя. | ||
| keyed_groups | Значение по умолчанию: [] | добавление хостов в группу на основе значений переменной | |
| regions | Список регионов, в которых описываются экземпляры EC2. По умолчанию это все регионы, кроме us-gov-west-1 и cn-north-1. | ||
| strict | Значение по умолчанию: нет | Если значение true, недействительные записи — это ошибка, в противном случае пропустить и продолжить Поскольку фактически можно использовать факты в выражениях, они могут не всегда быть доступными, и мы по умолчанию игнорируем эти ошибки. | |
| strict_permissions | По умолчанию, если встречается 403 (Forbidden), этот плагин завершит работу. Вы можете установить strict_permissions в значение False в файле конфигурации инвентаризации, что позволит пропускать ошибки 403. |
Примеры
simple_config_file:
plugin: aws_ec2
boto_profile: aws_profile
regions: # populate inventory with instances in these regions
- us-east-1
- us-east-2
filters:
# all instances with their `Environment` tag set to `dev`
tag:Environment: dev
# all dev and QA hosts
tag:Environment:
- dev
- qa
instance.group-id: sg-xxxxxxxx
# ignores 403 errors rather than failing
strict_permissions: False
hostnames:
- tag:Name=Tag1,Name=Tag2
- tag:CustomDNSName
- dns-name
# constructed features may be used to create custom groups
strict: False
keyed_groups:
- prefix: arch
key: 'architecture'
value: 'x86_64'
- prefix: tag
key: tags
value:
"Name": "Test"
Статус
Автор
- НЕИЗВЕСТНО
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/plugins/inventory/aws_ec2.html
