amazon.aws.aws_rds – rds instance source
Примечание
Этот плагин входит в состав коллекции amazon.aws (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install amazon.aws.
Чтобы использовать его в книге задач, укажите: amazon.aws.aws_rds.
Обзор
- Получение экземпляров и кластеров из Amazon Web Services RDS.
- Использует файл конфигурации YAML, который заканчивается на aws_rds.(yml|yaml).
Требования
Ниже перечислены требования к локальному контрольному узлу, на котором выполняется данная инвентаризация.
- boto3
- botocore
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| aws_access_key строка | env:EC2_ACCESS_KEY env:AWS_ACCESS_KEY env:AWS_ACCESS_KEY_ID | Ключ доступа AWS для использования. псевдонимы: aws_access_key_id | |
| aws_profile строка | env:AWS_DEFAULT_PROFILE env:AWS_PROFILE | Профиль AWS псевдонимы: boto_profile | |
| aws_secret_key строка | env:EC2_SECRET_KEY env:AWS_SECRET_KEY env:AWS_SECRET_ACCESS_KEY | Секретный ключ AWS, соответствующий ключу доступа. псевдонимы: aws_secret_access_key | |
| aws_security_token строка | env:EC2_SECURITY_TOKEN env:AWS_SESSION_TOKEN env:AWS_SECURITY_TOKEN | Токен безопасности AWS, если используются временные ключи доступа и секретные ключи. | |
| cache логическое значение |
| записи ini: [inventory] env:ANSIBLE_INVENTORY_CACHE | Переключатель для включения/выключения кэширования исходных данных инвентаризации, для работы требуется настройка плагина кэша. |
| cache_connection строка | записи ini: [defaults] [inventory] env:ANSIBLE_CACHE_PLUGIN_CONNECTION env:ANSIBLE_INVENTORY_CACHE_CONNECTION | Данные или путь к соединению кэша, для деталей обратитесь к документации плагина кэша. | |
| cache_plugin строка | По умолчанию: "память" | записи ini: [defaults] [inventory] env:ANSIBLE_CACHE_PLUGIN env:ANSIBLE_INVENTORY_CACHE_PLUGIN | Плагин кэша для использования исходных данных инвентаризации. |
| cache_prefix строка | По умолчанию: "ansible_inventory_" | записи ini: [default] [inventory] env:ANSIBLE_CACHE_PLUGIN_PREFIX env:ANSIBLE_INVENTORY_CACHE_PLUGIN_PREFIX | Префикс для использования в файлах/таблицах плагина кэша. |
| cache_timeout целое число | По умолчанию: 3600 | записи ini: [defaults] [inventory] env:ANSIBLE_CACHE_PLUGIN_TIMEOUT env:ANSIBLE_INVENTORY_CACHE_TIMEOUT | Срок хранения кэша в секундах |
| compose словарь | По умолчанию: {} | Создание переменных из выражений Jinja2. | |
| filters строка | По умолчанию: {} | Словарь пар значений фильтров. Доступные фильтры перечислены здесь https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html#options. Если вы фильтруете по db-cluster-id и include_clusters равно True, это будет применяться и к кластерам. | |
| groups словарь | По умолчанию: {} | Добавление хостов в группу на основе условных выражений Jinja2. | |
| iam_role_arn строка | ARN роли IAM для принятия роли для выполнения поиска инвентаризации. Необходимо всё равно предоставить учетные данные AWS с достаточными привилегиями для выполнения действия AssumeRole. | ||
| include_clusters логическое значение |
| Включать ли запрос к кластерам Aurora наряду с экземплярами | |
| keyed_groups список / элементы=строка | По умолчанию: [] | Добавление хостов в группу на основе значений переменной. | |
| regions строка | По умолчанию: [] | Список регионов, в которых необходимо описать экземпляры и кластеры RDS. Доступные регионы перечислены здесь https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html
| |
| statuses список / элементы=строка | По умолчанию: ["creating", "available"] | Список желаемых состояний экземпляров/кластеров, которые необходимо добавить в инвентаризацию. Установите ['all'] в качестве сокращенной записи для поиска всего. | |
| strict логическое значение |
| Если yes, считать неверные записи ошибкой, иначе пропустить и продолжить.Так как в выражениях могут использоваться факты, они могут не всегда быть доступны, и по умолчанию мы игнорируем такие ошибки. | |
| strict_permissions логическое значение |
| По умолчанию, если возникает исключение AccessDenied, этот плагин завершится ошибкой. Вы можете установить strict_permissions в False в файле конфигурации инвентаризации, чтобы разрешить игнорирование ограничений. |
Примеры
plugin: aws_rds
regions:
- us-east-1
- ca-central-1
keyed_groups:
- key: 'db_parameter_groups|json_query("[].db_parameter_group_name")'
prefix: rds_parameter_group
- key: engine
prefix: rds
- key: tags
- key: region
Авторы
- Sloane Hertel (@s-hertel)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/amazon/aws/aws_rds_inventory.html
