Заметки о выпуске amazon.aws
v11.3.0
Сводка выпуска
В этом минорном выпуске добавлены новые функции и улучшения для модулей autoscaling_group, elb_application_lb, elb_application_lb_info, elb_classic_lb, event_source_aws_cloudtrail, kms_key, s3_bucket, s3_object_info.
Незначительные изменения
- Различные модули и утилиты — выполнен переход с устаревшего
ansible.module_utils._textнаansible.module_utils.common.text.converters(https://github.com/ansible-collections/amazon.aws/pull/2860). - amazon.aws.cloudformation — исправлена проблема, из-за которой создание набора изменений в режиме проверки завершалось ошибкой, если стек не был готов (например, находился в состоянии UPDATE_IN_PROGRESS). Теперь модуль ожидает, пока стек не будет готов (UPDATE_COMPLETE), прежде чем создавать набор изменений (https://github.com/ansible-collections/amazon.aws/pull/1910)
- elb_application_lb_info — исправлена документация возвращаемого значения: теперь она правильно описывает фактические типы и включает ранее отсутствовавшие поля (https://github.com/ansible-collections/amazon.aws/issues/2939).
- extensions/eda/plugins/event_source/aws_sqs_queue.py — добавлена необязательная поддержка обратной связи, благодаря которой событие можно удалить из очереди SQS после получения подтверждения от ansible-rulebook.
- module_utils/errors — добавлена поддержка интерполяции параметров в стиле f-строк в описаниях обработчиков ошибок для предоставления более подробных сообщений об ошибках (https://github.com/ansible-collections/amazon.aws/pull/2944).
- s3_bucket — добавлен параметр O(account_regional) для поддержки создания бакетов в пространстве имён account-regional. Требуется botocore версии не ниже 1.42.67 (https://github.com/ansible-collections/amazon.aws/pull/2960).
- s3_bucket — добавлена поддержка управления конфигурацией журналирования бакетов (https://github.com/ansible-collections/amazon.aws/pull/2855).
Исправления ошибок
- autoscaling_group — исправлено дублирующее присваивание default_cooldown в словаре properties (https://github.com/ansible-collections/amazon.aws/pull/2923).
- elb_application_lb — правила прослушивателя теперь возвращаются отсортированными по приоритету, причём правило по умолчанию отображается последним (https://github.com/ansible-collections/amazon.aws/issues/2939).
- elb_application_lb_info — правила прослушивателя теперь возвращаются отсортированными по приоритету, причём правило по умолчанию отображается последним (https://github.com/ansible-collections/amazon.aws/issues/2939).
- kms_key — исправлено повторное присваивание параметра: вместо повторного получения параметра из параметров модуля теперь используется переданный параметр alias (https://github.com/ansible-collections/amazon.aws/pull/2923).
- module_utils/cloudfront_facts — исправлена ошибка TypeError в CloudFrontFactsServiceManager.describe_cloudfront_property (https://github.com/ansible-collections/community.aws/issues/1915).
- s3_object_info — исправлены повторные присваивания ключей словаря при получении сведений об объектах (https://github.com/ansible-collections/amazon.aws/pull/2923).
v11.2.0
Сводка выпуска
В этом выпуске представлено несколько новых функций и улучшений для коллекции. Среди заметных нововведений — поддержка параметра volume_initialization_rate в ec2_vol для включения скорости инициализации с выделенной производительностью при создании томов из снимков, а также новый параметр protected_from_scale_in в autoscaling_group для управления защитой экземпляров от уменьшения масштаба. Модули Route53 расширены новыми параметрами для маршрутизации на основе задержки, включая routing_region и временный параметр aws_region, предназначенный для поддержки перехода от устаревшего параметра region. В выпуск также вошли исправления безопасности, устраняющие потенциальные уязвимости ReDoS при разборе ARN и идентификаторов групп безопасности EC2, а также ряд внутренних улучшений и рефакторингов для повышения удобства сопровождения кода, качества обработки ошибок и тестируемости модулей и служебных средств плагинов. В плагины инвентаризации добавлены несколько устаревающих параметров, чтобы избежать конфликтов с зарезервированными именами переменных Ansible и модернизировать параметры конфигурации. Кроме того, выпуск включает обновления по модернизации кода, например замену устаревшего использования datetime.utcnow() на варианты с поддержкой часовых поясов, улучшения утилит плагинов инвентаризации, а также различные обновления тестирования и внутреннего обслуживания.
Незначительные изменения
- autoscaling_group — добавлен логический параметр
protected_from_scale_inдля включения или отключения защиты от уменьшения масштаба. Это позволяет пользователям управлять защитой экземпляров в группе автоматического масштабирования от уменьшения масштаба. (https://github.com/ansible-collections/amazon.aws/pull/2207) - aws_cloudtrail — устаревший
datetime.utcnow()заменён наdatetime.now(tz=timezone.utc)с поддержкой часовых поясов (https://github.com/ansible-collections/amazon.aws/pull/2858). - aws_ec2 — добавлена переменная хоста «ec2_tags» (https://github.com/ansible-collections/amazon.aws/pull/2847).
- aws_ec2 — удалён явный параметр
disable_lookups=Falseиз вызовов шаблонов, поскольку он устарел, а False является значением по умолчанию (https://github.com/ansible-collections/amazon.aws/pull/2864). - aws_inventory_base — удалён явный параметр
disable_lookups=Falseиз вызовов шаблонов, поскольку он устарел, а False является значением по умолчанию (https://github.com/ansible-collections/amazon.aws/pull/2864). - aws_rds — добавлена переменная хоста «rds_tags» (https://github.com/ansible-collections/amazon.aws/pull/2847).
- aws_resource_actions — удалён избыточный вызов
list()при использованииsorted(): теперь sorted() может напрямую обрабатывать генераторное выражение, что повышает эффективность (https://github.com/ansible-collections/amazon.aws/pull/2882). - ec2_vol — добавлен необязательный параметр
volume_initialization_rateдля поддержки скорости инициализации с выделенной производительностью при создании тома из снимков. (https://github.com/ansible-collections/amazon.aws/issues/2665) - ec2_vpc_endpoint — устаревший
datetime.utcnow()заменён наdatetime.now(datetime.timezone.utc)с поддержкой часовых поясов (https://github.com/ansible-collections/amazon.aws/pull/2866). - ec2_vpc_nat_gateway — устаревший
datetime.utcnow()заменён наdatetime.now(datetime.timezone.utc)с поддержкой часовых поясов (https://github.com/ansible-collections/amazon.aws/pull/2866). - plugin_utils/inventory — добавлена обработка ошибок ClientError и BotoCoreError в методе _freeze_iam_role (https://github.com/ansible-collections/amazon.aws/pull/2902).
- plugin_utils/inventory — генерация имени сеанса роли вынесена в отдельный метод для улучшения организации кода (https://github.com/ansible-collections/amazon.aws/pull/2902).
- route53 — добавлен параметр
routing_regionдля явного указания региона для наборов записей ресурсов с маршрутизацией на основе задержки (https://github.com/ansible-collections/amazon.aws/issues/2893). - route53 — добавлен временный параметр
aws_region, позволяющий указывать регион AWS для API-запросов на время перехода с параметраregion(https://github.com/ansible-collections/amazon.aws/issues/2893). - route53 — служебная утилита модуля переработана для использования обработки ошибок на основе декораторов. (https://github.com/ansible-collections/amazon.aws/pull/2892)
- route53_health_check — модуль переработан для повышения тестируемости и безопасности типов. (https://github.com/ansible-collections/amazon.aws/pull/2892)
Устаревшие функции
- aws_ec2 — переменная хоста
tagsобъявлена устаревшей во избежание конфликтов с зарезервированными именами переменных Ansible и будет удалена в выпуске после 2026-12-01. Вместо неё используйтеec2_tags(https://github.com/ansible-collections/amazon.aws/pull/2847). - aws_ec2 — параметр
use_contrib_script_compatible_ec2_tag_keysобъявлен устаревшим и будет удалён в выпуске после 2026-12-01. Вместо него используйте структуруec2_tags. (https://github.com/ansible-collections/amazon.aws/pull/2854) - aws_ec2 — параметр
use_contrib_script_compatible_sanitizationобъявлен устаревшим и будет удалён в выпуске после 2026-12-01. Вместо него используйте стандартную очистку имён групп Ansible. (https://github.com/ansible-collections/amazon.aws/pull/2854) - aws_rds — переменная хоста
tagsобъявлена устаревшей во избежание конфликтов с зарезервированными именами переменных Ansible и будет удалена в выпуске после 2026-12-01. Вместо неё используйтеrds_tags(https://github.com/ansible-collections/amazon.aws/pull/2847). - route53 — параметр
regionдля маршрутизации на основе задержки объявлен устаревшим и будет удалён в выпуске после 2027-06-01. Параметрrouting_regionработает точно так же, как сейчас работаетregion, и его следует использовать вместо него (https://github.com/ansible-collections/amazon.aws/issues/2893).
Исправления безопасности
- arn — устранена потенциальная уязвимость ReDoS в регулярном выражении для разбора ARN: вместо нежадного квантификатора используется отрицающий символьный класс (https://github.com/ansible-collections/amazon.aws/pull/2884).
- ec2_security_group — устранена потенциальная уязвимость ReDoS в регулярном выражении для разбора идентификаторов групп безопасности: добавлены отрицающие символьные классы и завершающий якорь (https://github.com/ansible-collections/amazon.aws/pull/2884).
Исправления ошибок
- aws_ssm — исправлена повторная установка соединения при каждой итерации цикла. Теперь плагин корректно устанавливает одно соединение на весь цикл (https://github.com/ansible-collections/amazon.aws/pull/2869).
v11.1.0
Сводка выпуска
В этом выпуске добавлена поддержка косвенного подсчёта узлов для различных ресурсов EC2, RDS и S3. Также представлен новый модуль amazon.aws.ec2_instance_type_info для поддержки типов экземпляров EC2. Кроме того, плагины источников событий aws_cloudtrail и aws_sqs_queue перенесены из коллекции ansible.eda; обратите внимание, что для этой коллекции появилась новая зависимость — aiobotocore >= 2.14.0. Также включено несколько исправлений ошибок для модулей elb_application_lb и s3_object.
Незначительные изменения
- aws_cloudtrail — плагин источника событий перенесён из
ansible.edaвamazon.aws(https://github.com/ansible-collections/amazon.aws/pull/2816). - aws_sqs_queue — плагин источника событий перенесён из
ansible.edaвamazon.aws(https://github.com/ansible-collections/amazon.aws/pull/2816). - косвенный подсчёт узлов — добавлена поддержка запросов к ресурсам баз данных RDS (https://github.com/ansible-collections/amazon.aws/pull/2825).
- косвенный подсчёт узлов — создан запрос для ресурсов сетевых балансировщиков нагрузки (https://github.com/ansible-collections/amazon.aws/pull/2818).
- косвенный подсчёт узлов — создан запрос для EC2 (https://github.com/ansible-collections/amazon.aws/pull/2807).
- косвенный подсчёт узлов — создан запрос для сетевых ресурсов: VPC, подсети, шлюза NAT, интернет-шлюза, виртуального шлюза, таблицы маршрутизации, VPN и пиринга VPC (https://github.com/ansible-collections/amazon.aws/pull/2811).
- косвенный подсчёт узлов — создан запрос для ресурсов хранения: бакета S3 и объекта (https://github.com/ansible-collections/amazon.aws/pull/2811).
- requirements.txt —
aiobotocoreдобавлен в качестве зависимости только для плагинов источников событий (https://github.com/ansible-collections/amazon.aws/pull/2816).
Исправления ошибок
- elb_application_lb — исправлено сравнение действий по умолчанию для нескольких правил, чтобы корректно обрабатывать поле
Orderпри определении необходимости изменения прослушивателя (https://github.com/ansible-collections/amazon.aws/issues/2537). - elb_application_lb — исправлена ошибка, из-за которой создание нового балансировщика нагрузки приложений с правилами прослушивателя завершалось с ошибкой
Parameter validation failed: Invalid type for parameter ListenerArn, value: None(https://github.com/ansible-collections/amazon.aws/issues/2400). - s3_object — исправлена ошибка при использовании PUT с пустой строкой
content(https://github.com/ansible-collections/amazon.aws/pull/2810)
Новые модули
- ec2_instance_type_info — получение сведений о типах экземпляров EC2
v11.0.0
Сводка выпуска
Этот мажорный выпуск включает такие изменения, как переработка служебных средств модулей S3 для объединения дублирующегося кода, добавления исчерпывающих подсказок типов и строк документации, а также упрощения сопровождения. Кроме того, версии botocore и boto3 повышены до 1.35.0, а версия awscli — до 1.34.0.
Значительные изменения
- Коллекция amazon.aws — версия
awscliповышена до 1.34.0 (https://github.com/ansible-collections/amazon.aws/pull/2774). - Коллекция amazon.aws — версии
botocoreиboto3повышены до 1.35.0 (https://github.com/ansible-collections/amazon.aws/pull/2774). - ec2_security_group — удалена поддержка передачи вложенных списков строк в
rules.cidr_ipиrules.cidr_ipv6(https://github.com/ansible-collections/amazon.aws/issues/2777). - iam_user — удалена поддержка ключа возвращаемого значения
iam_user; теперь возвращается толькоuser(https://github.com/ansible-collections/amazon.aws/issues/2777). - lambda_info — удалена поддержка
function(https://github.com/ansible-collections/amazon.aws/issues/2777). - route53_info — удалена поддержка списков в CamelCase (
ResourceRecordSets,HostedZones,HealthChecks,CheckerIpRanges,DelegationSets,HealthCheck) (https://github.com/ansible-collections/amazon.aws/issues/2777). - s3_object — удалена поддержка режима
list; вместо него используйтеs3_object_info(https://github.com/ansible-collections/amazon.aws/issues/2777). - s3_object — удалена поддержка передачи начального
/(https://github.com/ansible-collections/amazon.aws/issues/2777). - s3_object_info — удалена поддержка одновременной передачи
dualstackиendpoint_url(https://github.com/ansible-collections/amazon.aws/issues/2777).
Незначительные изменения
- module_utils/s3 — служебные средства модулей S3 переработаны для объединения дублирующегося кода, добавления исчерпывающих подсказок типов и строк документации, а также упрощения сопровождения (https://github.com/ansible-collections/amazon.aws/pull/2782).
- s3_bucket — модуль переработан для использования централизованных функций-обёрток S3 из module_utils и единообразного применения S3ErrorHandler (https://github.com/ansible-collections/amazon.aws/pull/2782).
- s3_bucket_info — модуль переработан для использования централизованных функций-обёрток S3 из module_utils и единообразного применения S3ErrorHandler (https://github.com/ansible-collections/amazon.aws/pull/2782).
- s3_object — модуль переработан для использования централизованных функций-обёрток S3 из module_utils и единообразного применения S3ErrorHandler (https://github.com/ansible-collections/amazon.aws/pull/2782).
- s3_object_info — модуль переработан для использования централизованных функций-обёрток S3 из module_utils и единообразного применения S3ErrorHandler (https://github.com/ansible-collections/amazon.aws/pull/2782).
v10.3.0
Сводка выпуска
Этот минорный выпуск включает несколько исправлений ошибок в ALB, S3 и подключаемом модуле соединения SSM, усиление защиты при разборе ARN и расширение совместимости с ansible-core >= 2.16.
Незначительные изменения
- meta/runtime.yml — минимальная версия
ansible-coreснижена до2.16. Это расширяет совместимость и не изменяет и не удаляет существующие функции.
Исправления безопасности
- arn — устранена потенциальная уязвимость ReDoS в регулярном выражении для разбора ARN: вместо нежадного квантификатора используется отрицающий символьный класс (https://github.com/ansible-collections/amazon.aws/pull/2884).
- ec2_security_group — устранена потенциальная уязвимость ReDoS в регулярном выражении для разбора идентификаторов групп безопасности: добавлены отрицающие символьные классы и завершающий якорь (https://github.com/ansible-collections/amazon.aws/pull/2884).
Исправления ошибок
- aws_ssm — исправлена повторная установка соединения при каждой итерации цикла. Теперь плагин корректно устанавливает одно соединение на весь цикл (https://github.com/ansible-collections/amazon.aws/pull/2869).
- elb_application_lb — исправлено сравнение действий по умолчанию для нескольких правил, чтобы корректно обрабатывать поле
Orderпри определении необходимости изменения прослушивателя (https://github.com/ansible-collections/amazon.aws/issues/2537). - elb_application_lb — исправлена ошибка, из-за которой создание нового балансировщика нагрузки приложений с правилами прослушивателя завершалось с ошибкой
Parameter validation failed: Invalid type for parameter ListenerArn, value: None(https://github.com/ansible-collections/amazon.aws/issues/2400). - s3_object — исправлена ошибка при использовании PUT с пустой строкой
content(https://github.com/ansible-collections/amazon.aws/pull/2810)
v10.2.0
Сводка выпуска
В этом выпуске добавлена поддержка типа хранилища io2 для RDS, а также внесены другие незначительные изменения, несколько исправлений ошибок и объявлены устаревшими некоторые функции.
Незначительные изменения
- Добавлена поддержка типа хранилища io2 для RDS (https://github.com/ansible-collections/amazon.aws/pull/2748).
- ec2_launch_template — увеличены ограничения
throughputдля томов GP3 в соответствии с обновлёнными ограничениями AWS (https://github.com/ansible-collections/amazon.aws/pull/2749). - ec2_vol — увеличены ограничения
throughputиiopsдля томов GP3 в соответствии с обновлёнными ограничениями AWS (https://github.com/ansible-collections/amazon.aws/pull/2749). - module_utils.s3 — код «501» добавлен в список кодов ошибок, возвращаемых заменами S3 (https://github.com/ansible-collections/amazon.aws/issues/2447).
- module_utils/_s3/common — используется
is_boto3_error_httpstatusдля обработки кодов состояния HTTP 403 и 501 от сервисов, совместимых с S3 (https://github.com/ansible-collections/amazon.aws/pull/2776). - module_utils/botocore — добавлена вспомогательная функция
is_boto3_error_httpstatusдля перехвата исключений boto3 на основе кодов состояния HTTP (https://github.com/ansible-collections/amazon.aws/pull/2776). - route53 — в возвращаемое значение
resource_record_setsдобавлен ключrecord_values, доступный с помощью точечной нотации Jinja2 (https://github.com/ansible-collections/amazon.aws/pull/2772). - sts_assume_role — улучшена обработка ошибок
MalformedPolicyDocument: теперь при передаче недопустимого документа политики выдаётся более понятное сообщение об ошибке (https://github.com/ansible-collections/amazon.aws/pull/2778).
Устаревшие функции
- ec2_vpc_dhcp_option — возвращаемое значение
dhcp_configобъявлено устаревшим и будет удалено в выпуске после 2026-12-01. Вместо него используйтеdhcp_options(https://github.com/ansible-collections/amazon.aws/pull/2772). - ec2_vpc_dhcp_option_info — возвращаемое значение
dhcp_configобъявлено устаревшим и будет удалено в выпуске после 2026-12-01. Вместо него используйтеdhcp_options(https://github.com/ansible-collections/amazon.aws/pull/2772). - route53 — ключ
valuesв возвращаемом значенииresource_record_setsобъявлен устаревшим в пользуrecord_valuesдля совместимости с Jinja2. Ключvaluesбудет удалён в выпуске после 2026-12-01 (https://github.com/ansible-collections/amazon.aws/pull/2772).
Исправления ошибок
- connection/aws_ssm — исправлена ошибка ReferenceError в деструкторе подключаемого модуля соединения aws_ssm во время завершения работы интерпретатора (https://github.com/ansible-collections/amazon.aws/issues/2728).
- lambda_info — исправлена недопустимая документация возвращаемого значения с точечной нотацией (
function.TheName), которую нельзя использовать в шаблонах Jinja2 (https://github.com/ansible-collections/amazon.aws/pull/2772). - s3_bucket — исправлена ошибка при настройке шифрования бакета AES256, если для
bucket_key_enabledявно задано значениеfalse(https://github.com/ansible-collections/amazon.aws/issues/2734).
v10.1.2
Сводка выпуска
В этом выпуске исправлено несколько ошибок.
Исправления ошибок
- Удалены импорты
ansible.module_utils.sixво избежание предупреждений (https://github.com/ansible-collections/amazon.aws/pull/2727). - amazon.aws.autoscaling_instance — установка состояния
terminatedне давала эффекта. Исправление реализует отсутствовавшее состояние завершения работы экземпляра (https://github.com/ansible-collections/amazon.aws/issues/2719). - ec2_vpc_nacl — исправлена проблема при попытке обновить существующее правило сетевого ACL (https://github.com/ansible-collections/amazon.aws/issues/2592).
- s3_object — при загрузке content и content_base64 учитываются заголовки: поддерживаемые ключи (например, ContentType, ContentDisposition, CacheControl) перемещаются на верхний уровень аргументов S3, а остальные ключи помещаются в Metadata. Благодаря этому загрузка содержимого работает согласованно с загрузкой src. (https://github.com/ansible-collections/amazon.aws)
v10.1.1
Сводка выпуска
Этот выпуск содержит исправление ошибки и обновление документации.
Исправления ошибок
- ec2_instance — исправлена опечатка в InsufficientInstanceCapacity. Теперь при возникновении ошибки InsufficientInstanceCapacity повторяется попытка создания Ec2 (https://github.com/ansible-collections/amazon.aws/issues/1038).
v10.1.0
Сводка выпуска
В этот минорный выпуск добавлена поддержка Route53 в качестве имени узла.
Минорные изменения
- inventory/aws_ec2 — добавлена поддержка
Route53в качестве имени узла (https://github.com/ansible-collections/amazon.aws/pull/2580).
v10.0.0
Сводка выпуска
В этом мажорном выпуске добавлена поддержка нового плагина подключения aws_ssm, перенесённого из community.aws, а также внесены несколько исправлений ошибок, минорных изменений и устаревших функций. Кроме того, в этом выпуске минимальные требуемые версии boto3 и botocore повышены до 1.34.0 для соответствия обновлённой поддержке AWS SDK; поддержка ansible-core < 2.17 прекращена. Поскольку AWS SDK объявили о прекращении поддержки Python версий ниже 3.8 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/), поддержка Python версий ниже 3.8 этой коллекцией была объявлена устаревшей в выпуске 9.0.0 и удалена в этом выпуске 10.0.0.
Мажорные изменения
- Коллекция amazon.aws — поддержка
botocore<1.34.0иboto3<1.34.0прекращена. Большинство модулей продолжат работать с более старыми версиями AWS SDK, однако совместимость с ними не гарантируется и не будет проверяться. При использовании старых версий SDK Ansible выдаст предупреждение (https://github.com/ansible-collections/amazon.aws/pull/2426). - Коллекция amazon.aws — поскольку AWS SDK объявили о прекращении поддержки Python версий ниже 3.8 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/), поддержка Python версий ниже 3.8 этой коллекцией была объявлена устаревшей в выпуске 6.0.0 и удалена в выпуске 10.0.0. (https://github.com/ansible-collections/amazon.aws/pull/2426).
- connection/aws_ssm — модуль перенесён из коллекции
community.aws. В сценариях, использующих для этого модуля полное имя коллекции (Fully Qualified Collection Name), его следует заменить наamazon.aws.aws_ssm.
Минорные изменения
- module_utils.s3 — в список кодов ошибок, возвращаемых заменами S3, добавлен «501» (https://github.com/ansible-collections/amazon.aws/issues/2447).
- module_utils/s3 — добавлен начальный ErrorHandler для модулей S3 (https://github.com/ansible-collections/amazon.aws/pull/2060).
- s3_bucket — обновлены обработчики ошибок для более эффективной обработки ошибок, не связанных с AWS (https://github.com/ansible-collections/amazon.aws/pull/2478).
Несовместимые изменения / Руководство по переносу
- Коллекция amazon.aws — поддержка ansible-core < 2.17 прекращена (https://github.com/ansible-collections/amazon.aws/pull/2601).
- Коллекция amazon.aws — поддержка переменной окружения
EC2_ACCESS_KEYбыла объявлена устаревшей в выпуске6.0.0и теперь удалена. Вместо неё используйте параметрaccess_keyили переменную окруженияAWS_ACCESS_KEY_ID(https://github.com/ansible-collections/amazon.aws/pull/2527). - Коллекция amazon.aws — поддержка переменной окружения
EC2_REGIONбыла объявлена устаревшей в выпуске6.0.0и теперь удалена. Вместо неё используйте параметрregionили переменную окруженияAWS_REGION(https://github.com/ansible-collections/amazon.aws/pull/2527). - Коллекция amazon.aws — поддержка переменной окружения
EC2_SECRET_KEYбыла объявлена устаревшей в выпуске6.0.0и теперь удалена. Вместо неё используйте параметрsecret_keyили переменную окруженияAWS_SECRET_ACCESS_KEY(https://github.com/ansible-collections/amazon.aws/pull/2527). - Коллекция amazon.aws — поддержка переменных окружения
EC2_SECURITY_TOKENиAWS_SECURITY_TOKENбыла объявлена устаревшей в выпуске6.0.0и теперь удалена. Вместо них используйте параметрsession_tokenили переменную окруженияAWS_SESSION_TOKEN(https://github.com/ansible-collections/amazon.aws/pull/2527). - Коллекция amazon.aws — поддержка переменных окружения
EC2_URLиS3_URLбыла объявлена устаревшей в выпуске6.0.0и теперь удалена. Вместо них используйте параметрendpoint_urlили переменную окруженияAWS_URL(https://github.com/ansible-collections/amazon.aws/pull/2527). - Коллекция amazon.aws — псевдонимы
access_token,aws_security_tokenиsecurity_tokenпараметраsession_tokenбыли объявлены устаревшими в выпуске6.0.0и теперь удалены. Используйте имяsession_token(https://github.com/ansible-collections/amazon.aws/pull/2527). - Коллекция amazon.aws — псевдоним
boto_profileпараметраprofileбыл объявлен устаревшим в выпуске6.0.0и теперь удалён. Используйте имяprofile(https://github.com/ansible-collections/amazon.aws/pull/2527). - Коллекция amazon.aws — псевдоним
ec2_access_keyпараметраaccess_keyбыл объявлен устаревшим в выпуске6.0.0и теперь удалён. Используйте имяaccess_key(https://github.com/ansible-collections/amazon.aws/pull/2527). - Коллекция amazon.aws — псевдоним
ec2_regionпараметраregionбыл объявлен устаревшим в выпуске6.0.0и теперь удалён. Используйте имяregion(https://github.com/ansible-collections/amazon.aws/pull/2527). - Коллекция amazon.aws — псевдоним
ec2_secret_keyпараметраsecret_keyбыл объявлен устаревшим в выпуске6.0.0и теперь удалён. Используйте имяsecret_key(https://github.com/ansible-collections/amazon.aws/pull/2527). - Коллекция amazon.aws — псевдонимы
endpoint,ec2_urlиs3_urlпараметраendpoint_urlбыли объявлены устаревшими в выпуске6.0.0и теперь удалены. Используйте имяregion(https://github.com/ansible-collections/amazon.aws/pull/2527). - docs_fragments — ранее объявленный устаревшим фрагмент документации
amazon.aws.aws_credentialsудалён; вместо него используйтеamazon.aws.common.plugins(https://github.com/ansible-collections/amazon.aws/pull/2527). - docs_fragments — ранее объявленный устаревшим фрагмент документации
amazon.aws.aws_regionудалён; вместо него используйтеamazon.aws.region.plugins(https://github.com/ansible-collections/amazon.aws/pull/2527). - docs_fragments — ранее объявленный устаревшим фрагмент документации
amazon.aws.awsудалён; вместо него используйтеamazon.aws.common.modules(https://github.com/ansible-collections/amazon.aws/pull/2527). - docs_fragments — ранее объявленный устаревшим фрагмент документации
amazon.aws.ec2удалён; вместо него используйтеamazon.aws.region.modules(https://github.com/ansible-collections/amazon.aws/pull/2527). - ec2_vpc_peering_info — ключ
resultудалён из возвращаемого значения. Вместо него следует использоватьvpc_peering_connections(https://github.com/ansible-collections/amazon.aws/pull/2618). - module_utils.botocore — удалён устаревший параметр
boto3дляget_aws_region()иget_aws_connection_info(); этот параметр не влиял на работу начиная с выпуска 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2443). - module_utils.ec2 — удалён устаревший параметр
boto3дляget_ec2_security_group_ids_from_names()иget_aws_connection_info(); этот параметр не влиял на работу начиная с выпуска 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2603). - rds_param_group — перенаправление удалено; сценарии следует обновить, чтобы использовать rds_instance_param_group (https://github.com/ansible-collections/amazon.aws/pull/2618).
Исправления ошибок
- s3_bucket — списки контроля доступа (ACL) корзины теперь всегда возвращаются (https://github.com/ansible-collections/amazon.aws/pull/2478).
- s3_bucket — исправлена идемпотентность при настройке ACL корзины (https://github.com/ansible-collections/amazon.aws/pull/2478).
v9.5.2
Сводка выпуска
Этот выпуск содержит исправления ошибок в модулях ec2_vpc_nacl, autoscaling_instance, s3_object и исправления ошибок sanity-проверок.
Исправления ошибок
- Удалены импорты
ansible.module_utils.sixво избежание предупреждений (https://github.com/ansible-collections/amazon.aws/pull/2727). - amazon.aws.autoscaling_instance — установка состояния
terminatedне давала результата. Исправление реализует отсутствующее состояние завершения работы экземпляра (https://github.com/ansible-collections/amazon.aws/issues/2719). - ec2_vpc_nacl — исправлена проблема при попытке обновить существующее правило Network ACL (https://github.com/ansible-collections/amazon.aws/issues/2592).
- s3_object — при загрузке content и content_base64 теперь учитываются заголовки: поддерживаемые ключи (например, ContentType, ContentDisposition, CacheControl) передаются в качестве аргументов S3 верхнего уровня, а остальные ключи помещаются в Metadata. Благодаря этому загрузка content работает согласованно с загрузкой src. (https://github.com/ansible-collections/amazon.aws)
v9.5.1
Сводка выпуска
Этот выпуск содержит исправление ошибки и обновление документации.
Исправления ошибок
- ec2_instance — исправлена опечатка в InsufficientInstanceCapacity. Теперь при возникновении ошибки InsufficientInstanceCapacity повторяется попытка создания Ec2 (https://github.com/ansible-collections/amazon.aws/issues/1038).
v9.5.0
Сводка выпуска
Этот минорный выпуск содержит несколько исправлений ошибок и новые функции для модулей route53_info и iam_user_info.
Минорные изменения
- Обновлена версия ansible-lint до 25.1.2 (https://github.com/ansible-collections/amazon.aws/pull/2590).
- iam_user_info — добавлены теги в результаты ListUsers или GetGroup (https://github.com/ansible-collections/amazon.aws/pull/2567).
- iam_user_info — если указано недопустимое имя группы, теперь возвращается пустой список пользователей вместо ошибки Python (https://github.com/ansible-collections/amazon.aws/pull/2567).
- module_utils/modules.py — вызов
deprecate()без указания аргументовcollection_name,versionилиdateприводит к ошибкам sanity-проверки (https://github.com/ansible-collections/amazon.aws/pull/2607).
Исправления ошибок
- iam_user_info — теперь при указании только имени пользователя действительно вызывается GetUser, а не выполняется перебор и фильтрация всех пользователей (https://github.com/ansible-collections/amazon.aws/pull/2567).
- iam_user_info — теперь пользователи действительно фильтруются по префиксу пути, если он указан (https://github.com/ansible-collections/amazon.aws/pull/2567).
- route53_info — из примера с использованием when удалены разделители jijna (https://github.com/ansible-collections/amazon.aws/issues/2594).
v9.4.0
Сводка выпуска
Этот минорный выпуск содержит исправления ошибок и небольшие изменения, необходимые для проверки коллекции на совместимость с будущей версией ansible-core 2.19.
Минорные изменения
- inventory/aws_ec2 — обновлён механизм шаблонов для поддержки изменений ansible-core 2.19 (https://github.com/ansible-collections/amazon.aws/pull/2552).
Исправления ошибок
- lookup/aws_account_attribute — плагин должен возвращать список при
wantlist=True(https://github.com/ansible-collections/amazon.aws/pull/2552).
v9.3.0
Сводка выпуска
Этот минорный выпуск включает два новых модуля (ec2_dedicated_host и ec2_dedicated_host_info), а также новую функцию модуля s3_object, который теперь поддерживает передачу метаданных в режиме create.
Минорные изменения
- s3_object — добавлена поддержка передачи метаданных в режиме
create(https://github.com/ansible-collections/amazon.aws/pull/2529).
Новые модули
- ec2_dedicated_host — создание, обновление или удаление (освобождение) выделенного хоста EC2
- ec2_dedicated_host_info — сбор информации о выделенных хостах EC2 в AWS
v9.2.0
Сводка выпуска
Этот выпуск содержит новый модуль route53_key_signing_key, исправления ошибок, минорные изменения и исправления линтинга в нескольких модулях.
Минорные изменения
- autoscaling_group — исключено присваивание значения неиспользуемой переменной в блоке except (https://github.com/ansible-collections/amazon.aws/pull/2464).
- ec2_ami — исключено повторное определение
delete_snapshotвнутриDeregisterImage.do(https://github.com/ansible-collections/amazon.aws/pull/2444). - ec2_transit_gateway — исключено присваивание значения неиспользуемой переменной
retry_decorator(https://github.com/ansible-collections/amazon.aws/pull/2464). - ec2_vpc_egress_igw — исключено присваивание значения неиспользуемой переменной
vpc_id(https://github.com/ansible-collections/amazon.aws/pull/2464). - ec2_vpc_nacl — исключено присваивание значения неиспользуемой переменной
result(https://github.com/ansible-collections/amazon.aws/pull/2464). - ec2_vpc_vpn — небольшие исправления линтинга (https://github.com/ansible-collections/amazon.aws/pull/2444).
- iam_password_policy — исключено присваивание значения неиспользуемой переменной в блоке except (https://github.com/ansible-collections/amazon.aws/pull/2464).
- iam_role — исключено присваивание значения неиспользуемой переменной в блоке except (https://github.com/ansible-collections/amazon.aws/pull/2464).
- inventory/aws_ec2 — добавлена поддержка выражений jinja2 в переменной
hostnames(https://github.com/ansible-collections/amazon.aws/issues/2402). - kms_key — исключено присваивание значения неиспользуемой переменной в блоке except (https://github.com/ansible-collections/amazon.aws/pull/2464).
- lambda — исключено присваивание значения неиспользуемой переменной
architecture(https://github.com/ansible-collections/amazon.aws/pull/2464). - lambda — исключено присваивание значения неиспользуемой переменной
required_by(https://github.com/ansible-collections/amazon.aws/pull/2464). - module_utils._s3 — явно приведён тип super к родительскому типу (https://github.com/ansible-collections/amazon.aws/pull/2497).
- module_utils.botocore — исключено присваивание неиспользуемых частей результата exc_info (https://github.com/ansible-collections/amazon.aws/pull/2497).
- module_utils.exceptions — исключено присваивание неиспользуемых частей результата exc_info (https://github.com/ansible-collections/amazon.aws/pull/2497).
- module_utils.iam — исключено присваивание значения неиспользуемой переменной
result(https://github.com/ansible-collections/amazon.aws/pull/2464). - module_utils.s3 — исключено присваивание значения неиспользуемой переменной
endpoint(https://github.com/ansible-collections/amazon.aws/pull/2464). - plugin_utils/inventory —
filtersдобавлен в список параметров инвентаризации, поддерживающих шаблоны (https://github.com/ansible-collections/amazon.aws/pull/2379) - route53 — добавлена поддержка записей типа
SSHFP(https://github.com/ansible-collections/amazon.aws/pull/2430). - route53_zone — добавлена поддержка включения подписания DNSSEC для определённой размещённой зоны (https://github.com/ansible-collections/amazon.aws/issues/1976).
- route53_zone — исключено присваивание значений неиспользуемым переменным
current_vpc_idsиcurrent_vpc_regions(https://github.com/ansible-collections/amazon.aws/pull/2464). - s3_bucket — исключено присваивание значения неиспользуемой переменной в блоке except (https://github.com/ansible-collections/amazon.aws/pull/2464).
- s3_bucket — исключено повторное определение
idвнутриhandle_bucket_inventoryиdelete_bucket_inventory(https://github.com/ansible-collections/amazon.aws/pull/2444). - s3_object — исключено повторное определение
key_checkвнутри_head_object(https://github.com/ansible-collections/amazon.aws/pull/2444). - s3_object — упрощена логика
path_check(https://github.com/ansible-collections/amazon.aws/pull/2444). - s3_object — при копировании из S3 в S3 используется метод
copyвместоcopy_object(https://github.com/ansible-collections/amazon.aws/issues/2117). - s3_object_info — добавлена поддержка перечисления объектов с определённым префиксом (https://github.com/ansible-collections/amazon.aws/issues/2477).
- s3_object_info — исключено присваивание значения неиспользуемой переменной в блоке except (https://github.com/ansible-collections/amazon.aws/pull/2464).
Исправления ошибок
- ec2_instance — исправлена проблема, из-за которой модуль экземпляра EC2 не применял группы безопасности, если были указаны одновременно
networkиvpc_subnet_id; причиной была передачаNoneв discover_security_groups() (https://github.com/ansible-collections/amazon.aws/pull/2488). - ec2_vpc_nacl_info — исправлен сбой при перечислении NetworkACL, если ACL не найдены (https://github.com/ansible-collections/amazon.aws/issues/2425).
- iam_access_key — добавлены отсутствовавшие проверки требований (https://github.com/ansible-collections/amazon.aws/pull/2465).
- module_utils.botocore — исправлено назначение псевдонимов типов (https://github.com/ansible-collections/amazon.aws/pull/2497).
- plugin_utils.botocore — исправлено назначение псевдонимов типов (https://github.com/ansible-collections/amazon.aws/pull/2497).
- s3_bucket — при создании корзины в кластере ceph регион по умолчанию больше не используется как ограничение расположения (https://github.com/ansible-collections/amazon.aws/issues/2420).
Новые модули
- route53_key_signing_key — управление ключом подписи ключей (KSK)
v9.1.1
Сводка выпуска
Этот выпуск содержит исправления ошибок в модулях cloudformation, ec2_security_group, lambda, rds_cluster и ec2_vpc_net, а также одно исправление для ec2 module_util.
Исправления ошибок
- cloudformation — исправлена ошибка, из-за которой защита от удаления не обновлялась при использовании create_changeset=true для обновления стека (https://github.com/ansible-collections/amazon.aws/pull/2391).
- ec2_security_group — исправлена проблема режима diff при создании группы безопасности с правилом, содержащим управляемый список префиксов (https://github.com/ansible-collections/amazon.aws/issues/2373).
- ec2_vpc_net — обработаны ipv6_cidr
falseи отсутствие Ipv6CidrBlockAssociationSet в vpc (https://github.com/ansible-collections/amazon.aws/pull/2374). - lambda — из выходных данных модуля удалены данные, не закодированные в UTF-8 (содержимое ZIP-файла Lambda), чтобы избежать ошибки Ansible (https://github.com/ansible-collections/amazon.aws/issues/2386).
- module_utils/ec2 — обрабатывается код ошибки
InvalidElasticIpID.NotFoundв функцииcreate_nat_gateway(); иногда вызовы APIallocate_addressвозвращают идентификатор нового ресурса эластичного IP до того, как на него можно надёжно ссылаться (https://github.com/ansible-collections/amazon.aws/issues/1872). - rds_cluster — исправлена проблема, возникавшая при обновлении домена кластера RDS (https://github.com/ansible-collections/amazon.aws/issues/2390).
v9.1.0
Сводка выпуска
В этом выпуске исправлено несколько ошибок, внесены небольшие изменения, добавлен новый модуль rds_instance_param_group_info и объявлено об устаревании некоторых функций модуля autoscaling_group.
Небольшие изменения
- autoscaling_group — добавлен
group_nameв качестве псевдонима параметраname(https://github.com/ansible-collections/amazon.aws/pull/2396). - autoscaling_group_info — добавлен
group_nameв качестве псевдонима параметраname(https://github.com/ansible-collections/amazon.aws/pull/2396). - autoscaling_instance_refresh — добавлен
group_nameв качестве псевдонима параметраname(https://github.com/ansible-collections/amazon.aws/pull/2396). - autoscaling_instance_refresh_info — добавлен
group_nameв качестве псевдонима параметраname(https://github.com/ansible-collections/amazon.aws/pull/2396). - ec2_instance — исправлена проблема, возникавшая при попытке запустить экземпляры с использованием шаблона запуска в среде AWS, где не определена подсеть по умолчанию (https://github.com/ansible-collections/amazon.aws/issues/2321).
- ec2_metadata_facts — в возвращаемые значения добавлен
ansible_ec2_instance_tags(https://github.com/ansible-collections/amazon.aws/pull/2398). - ec2_transit_gateway — обработка пустого описания при удалении транзитного шлюза (https://github.com/ansible-collections/community.aws/pull/2086).
Устаревшие функции
- autoscaling_group — параметр
decrement_desired_capacityобъявлен устаревшим и будет удален в выпуске 14.0.0 этой коллекции. Управлять экземплярами, подключенными к группе автомасштабирования, можно с помощью модуляamazon.aws.autoscaling_instance(https://github.com/ansible-collections/amazon.aws/pull/2396). - autoscaling_group — параметры
replace_batch_size,lc_checkиlt_checkобъявлены устаревшими и будут удалены в выпуске 14.0.0 этой коллекции. Выполнять последовательную замену экземпляров в группе автомасштабирования можно с помощью модуляamazon.aws.autoscaling_instance_refresh(https://github.com/ansible-collections/amazon.aws/pull/2396). - autoscaling_group — функциональность, предоставляемая параметром
detach_instances, объявлена устаревшей и будет удалена в выпуске 14.0.0 этой коллекции. Управлять экземплярами, подключенными к группе автомасштабирования, можно с помощью модуляamazon.aws.autoscaling_instance(https://github.com/ansible-collections/amazon.aws/pull/2396). - autoscaling_group — функциональность, предоставляемая параметром
replace_all_instances, объявлена устаревшей и будет удалена в выпуске 14.0.0 этой коллекции. Выполнять последовательную замену экземпляров в группе автомасштабирования можно с помощью модуляamazon.aws.autoscaling_instance_refresh(https://github.com/ansible-collections/amazon.aws/pull/2396). - autoscaling_group — функциональность, предоставляемая параметром
replace_instances, объявлена устаревшей и будет удалена в выпуске 14.0.0 этой коллекции. Управлять экземплярами, подключенными к группе автомасштабирования, можно с помощью модуляamazon.aws.autoscaling_instance(https://github.com/ansible-collections/amazon.aws/pull/2396).
Исправления ошибок
- elbv2 — исправлено сравнение прослушивателя балансировщика нагрузки, если DefaultActions содержит любое действие, отличное от forward (https://github.com/ansible-collections/amazon.aws/issues/2377).
Новые модули
- rds_instance_param_group_info — описывает группу параметров RDS.
v9.0.0
Краткое описание выпуска
Этот крупный выпуск включает новый набор поддерживаемых модулей, перенесённых из community.aws, несколько исправлений ошибок, незначительные изменения и устаревшие функции. Также прекращена поддержка botocore<1.31.0 и boto3<1.28.0. В связи с объявлением AWS SDK о прекращении поддержки Python версий ниже 3.8 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) поддержка Python версий ниже 3.8 этой коллекцией объявлена устаревшей в данном выпуске и будет удалена в выпуске 10.0.0.
Крупные изменения
- autoscaling_instance_refresh — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.autoscaling_instance_refresh(https://github.com/ansible-collections/amazon.aws/pull/2338). - autoscaling_instance_refresh_info — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.autoscaling_instance_refresh_info(https://github.com/ansible-collections/amazon.aws/pull/2338). - ec2_launch_template — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_launch_template(https://github.com/ansible-collections/amazon.aws/pull/2348). - ec2_placement_group — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_placement_group. - ec2_placement_group_info — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_placement_group_info. - ec2_transit_gateway — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_transit_gateway. - ec2_transit_gateway_info — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_transit_gateway_info. - ec2_transit_gateway_vpc_attachment — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_transit_gateway_vpc_attachment. - ec2_transit_gateway_vpc_attachment_info — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_transit_gateway_vpc_attachment_info. - ec2_vpc_egress_igw — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_vpc_egress_igw(https://api.github.com/repos/ansible-collections/amazon.aws/pulls/2327). - ec2_vpc_nacl — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_vpc_nacl(https://github.com/ansible-collections/amazon.aws/pull/2339). - ec2_vpc_nacl_info — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_vpc_nacl_info(https://github.com/ansible-collections/amazon.aws/pull/2339). - ec2_vpc_peer — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_vpc_peer. - ec2_vpc_peering_info — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_vpc_peering_info. - ec2_vpc_vgw — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_vpc_vgw. - ec2_vpc_vgw_info — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_vpc_vgw_info. - ec2_vpc_vpn — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_vpc_vpn. - ec2_vpc_vpn_info — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.ec2_vpc_vpn_info. - elb_classic_lb_info — модуль перенесён из коллекции
community.aws. Плейбуки, в которых для этого модуля используется полное имя коллекции, необходимо обновить, заменив его наamazon.aws.elb_classic_lb_info.
Незначительные изменения
- Добавлена поддержка модуля подключения VPC к транзитному шлюзу (https://github.com/ansible-collections/amazon.aws/pull/2314).
- Минимальная версия ansible-lint повышена до 24.7.0 (https://github.com/ansible-collections/amazon.aws/pull/2201).
- Функция
determine_iam_roleперенесена из модуляec2_instanceв модуль module_utils/ec2, чтобы её можно было использовать в модулеcommunity.aws.ec2_launch_template(https://github.com/ansible-collections/amazon.aws/pull/2319). - aws_az_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2163). - aws_region_info — код переработан для использованияAnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2163). - backup_vault — код обновлён: удалены ненужные возвращаемые значения, равные None (https://github.com/ansible-collections/amazon.aws/pull/2105).
- cloudwatchlogs_log_group_metric_filter — добавлена поддержка параметров
unitиdimensions(https://github.com/ansible-collections/amazon.aws/pull/2286) - ec2_ami — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2164). - ec2_ami_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2164). - ec2_eip — добавлена поддержка обновления записи обратного DNS для EIP (https://github.com/ansible-collections/amazon.aws/pull/2292).
- ec2_eip — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2165). - ec2_eip_info — код переработан для использованияAnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2165). - ec2_eni — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2166). - ec2_eni_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2166). - ec2_import_image — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2167). - ec2_import_image_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2167). - ec2_instance — переменные
clientиmoduleпередаются в качестве аргументов функции, а не глобальных переменных (https://github.com/ansible-collections/amazon.aws/pull/2192). - ec2_instance — добавлена возможность повысить или понизить тип существующего экземпляра EC2 (https://github.com/ansible-collections/amazon.aws/issues/469).
- ec2_instance — код переработан для использования
AnsibleEC2Errorи общего кода из module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2192). - ec2_instance_info — вызов устаревшей функции
datetime.utcnow()заменён наdatetime.now(timezone.utc)(https://github.com/ansible-collections/amazon.aws/pull/2192). - ec2_instance_info — код переработан для использования
AnsibleEC2Errorи общего кода из module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2192). - ec2_key — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2168). - ec2_key_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2168). - ec2_security_group — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2169). - ec2_security_group_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2169). - ec2_snapshot — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099). - ec2_snapshot_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099). - ec2_spot_instance — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099). - ec2_spot_instance_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099). - ec2_vol — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2170). - ec2_vol_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2170). - ec2_vpc_dhcp_option — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2097). - ec2_vpc_dhcp_option_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2097). - ec2_vpc_endpoint — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2097). - ec2_vpc_endpoint_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2097). - ec2_vpc_endpoint_service_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2097). - ec2_vpc_igw — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099). - ec2_vpc_igw_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099). - ec2_vpc_nat_gateway — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099). - ec2_vpc_nat_gateway_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099). - ec2_vpc_net — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2158). - ec2_vpc_net_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2158). - ec2_vpc_route_table — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2159). - ec2_vpc_route_table — параметр routes модуля ec2_vpc_route_table обновлён для поддержки идентификатора транзитного шлюза (https://github.com/ansible-collections/amazon.aws/pull/2291).
- ec2_vpc_route_table_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2159). - ec2_vpc_subnet — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2160). - ec2_vpc_subnet_info — код переработан для использования
AnsibleEC2Error, а общий код перенесён в module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2160). - module_utils.botocore — для единообразия использование
botocore.Sessionзаменено наboto3.Session(https://github.com/ansible-collections/amazon.aws/pull/2157). - module_utils.botocore — метод
boto3_connтеперь перехватываетBotoCoreError, а не неполный список подклассов (https://github.com/ansible-collections/amazon.aws/pull/2157). - module_utils/autoscaling — добавлены утилиты для обработки вызовов AWS клиентом
autoscaling(https://github.com/ansible-collections/amazon.aws/pull/2301). - module_utils/ec2 — добавлен общий код для вызовов API AWS Launch template (https://github.com/ansible-collections/amazon.aws/pull/2319).
- module_utils/ec2 — добавлены утилиты для модулей ec2_placement_group* (https://github.com/ansible-collections/amazon.aws/pull/2322).
- module_utils/ec2 — добавлены утилиты для модулей ec2_transit_gateway_* (https://github.com/ansible-collections/amazon.aws/pull/2325).
- module_utils/ec2 — добавлены утилиты для модулей ec2_vpc_peer* (https://github.com/ansible-collections/amazon.aws/pull/2303).
- module_utils/ec2 — добавлены утилиты для модулей ec2_vpc_vgw_* (https://github.com/ansible-collections/amazon.aws/pull/2331).
- module_utils/ec2 — добавлены утилиты для модулей ec2_vpc_vpn* (https://github.com/ansible-collections/amazon.aws/pull/2312).
- module_utils/ec2 — общий код для клиента ec2 перемещён (https://github.com/ansible-collections/amazon.aws/pull/2302).
- module_utils/elbv2 — переработана логика сравнения прослушивателей и правил (https://github.com/ansible-collections/amazon.aws/issues/1981).
- module_utils/rds.py — добавлена общая функциональность из модулей снимков rds (https://github.com/ansible-collections/amazon.aws/pull/2138).
- module_utils/rds.py — переработана общая функциональность клиента boto3, добавлены аннотации типов и строки документации функций (https://github.com/ansible-collections/amazon.aws/pull/2119).
- plugin_utils.botocore — метод
boto3_connтеперь перехватываетBotoCoreError, а не неполный список подклассов (https://github.com/ansible-collections/amazon.aws/pull/2157). - rds_cluster_snapshot — переработана общая функциональность клиента boto3, добавлены аннотации типов и строки документации функций (https://github.com/ansible-collections/amazon.aws/pull/2138).
- rds_instance — добавлена поддержка баз данных CDB с несколькими арендаторами (https://github.com/ansible-collections/amazon.aws/pull/2275).
- rds_instance — переработана общая функциональность клиента boto3, добавлены аннотации типов и строки документации функций (https://github.com/ansible-collections/amazon.aws/pull/2119).
- rds_instance — удалена общая функциональность, добавленная в module_utils/rds.py (https://github.com/ansible-collections/amazon.aws/pull/2138).
- rds_instance_info — переработана общая функциональность клиента boto3, добавлены аннотации типов и строки документации функций (https://github.com/ansible-collections/amazon.aws/pull/2119).
- rds_instance_info — переработана общая функциональность клиента boto3, добавлены аннотации типов и строки документации функций (https://github.com/ansible-collections/amazon.aws/pull/2138).
- rds_instance_snapshot — переработана общая функциональность клиента boto3, добавлены аннотации типов и строки документации функций (https://github.com/ansible-collections/amazon.aws/pull/2138).
- rds_snapshot_info — переработана общая функциональность клиента boto3, добавлены аннотации типов и строки документации функций (https://github.com/ansible-collections/amazon.aws/pull/2138).
- s3_object_info — добавлена поддержка параметра
max_keysиmarker(https://github.com/ansible-collections/amazon.aws/pull/2328).
Несовместимые изменения / руководство по переносу
- Коллекция amazon.aws прекращает поддержку
botocore<1.31.0иboto3<1.28.0. Большинство модулей продолжат работать с более старыми версиями AWS SDK. Однако совместимость со старыми версиями SDK не гарантируется и не будет проверяться. При использовании старых версий SDK Ansible выдаст предупреждение (https://github.com/ansible-collections/amazon.aws/pull/2161). - aws_ec2 — параметр
include_extra_api_callsранее был объявлен устаревшим и теперь удалён (https://github.com/ansible-collections/amazon.aws/pull/2320). - iam_policy — возвращаемый ключ
policiesранее был объявлен устаревшим и теперь удалён; вместо него используйтеpolicy_names(https://github.com/ansible-collections/amazon.aws/pull/2320). - module_utils.botocore — параметр
conn_typeметодаboto3_connтеперь обязателен (https://github.com/ansible-collections/amazon.aws/pull/2157).
Устаревшие функции
- Коллекция amazon.aws — в связи с объявлением AWS SDK о прекращении поддержки Python версий ниже 3.8 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) поддержка Python версий ниже 3.8 этой коллекцией объявлена устаревшей и будет удалена в выпуске 10.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2161).
- ec2_vpc_peer — модуль
ec2_vpc_peerпереименован вec2_vpc_peering. Использование модуля не изменилось. Псевдоним ec2_vpc_peer будет удалён в версии 13.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2356). - ec2_vpc_peering_info — возвращаемый ключ
resultобъявлен устаревшим и будет удалён в выпуске 11.0.0. Вместо него используйте возвращаемый ключvpc_peering_connections(https://github.com/ansible-collections/amazon.aws/pull/2359). - s3_object — поддержка
mode=listобъявлена устаревшей. Вместо неё следует использоватьamazon.aws.s3_object_info(https://github.com/ansible-collections/amazon.aws/pull/2328).
Исправления ошибок
- aws_ec2 — исправлен сбор данных инвентаризации SSM для нескольких (>40) хостов (https://github.com/ansible-collections/amazon.aws/pull/2227).
- ec2_vol — в режиме проверки выводится информация о томе, если он существует (https://github.com/ansible-collections/amazon.aws/pull/2133).
- s3_bucket — исправлена ошибка компиляции Python 3.7, вызванная добавлением информации о типах (https://github.com/ansible-collections/amazon.aws/issues/2287).
- s3_object — исправлена ошибка, из-за которой не учитывался параметр
max_keys(https://github.com/ansible-collections/amazon.aws/pull/2328).
Новые модули
- autoscaling_instance — управление экземплярами, связанными с группами AWS Auto Scaling (ASG)
- autoscaling_instance_info — получение сведений об экземплярах, связанных с группами AWS Auto Scaling (ASG)
- ec2_launch_template_info — сбор сведений о шаблонах запуска и их версиях
- ec2_vpc_egress_igw_info — сбор сведений о шлюзе AWS VPC Egress Only Internet
v8.2.3
Краткое описание выпуска
В этот выпуск вошли исправления ошибок для модулей ec2_instance и s3_bucket.
Исправления ошибок
- ec2_instance — исправлена ошибка, из-за которой модуль экземпляра EC2 не применял группы безопасности при одновременном указании
networkиvpc_subnet_id; причиной была передачаNoneв discover_security_groups() (https://github.com/ansible-collections/amazon.aws/pull/2488). - s3_bucket — при создании бакета в кластере ceph регион по умолчанию больше не используется в качестве ограничения местоположения (https://github.com/ansible-collections/amazon.aws/issues/2420).
v8.2.2
Сводка выпуска
Этот выпуск содержит исправления ошибок для плагина инвентаризации aws_ec2 и модулей cloudformation, ec2_security_group, ec2_vol, ec2_vpc_net, lambda, rds_cluster и s3_bucket.
Исправления ошибок
- aws_ec2 — исправлен сбор инвентаризации SSM для нескольких (>40) хостов (https://github.com/ansible-collections/amazon.aws/pull/2227).
- cloudformation — исправлена ошибка, из-за которой защита от завершения работы не обновлялась при использовании create_changeset=true для обновления стеков (https://github.com/ansible-collections/amazon.aws/pull/2391).
- ec2_security_group — исправлена проблема в режиме diff при создании группы безопасности, содержащей правило со списком управляемых префиксов (https://github.com/ansible-collections/amazon.aws/issues/2373).
- ec2_vol — выводятся сведения о томе, если он существует в режиме проверки (https://github.com/ansible-collections/amazon.aws/pull/2133).
- ec2_vpc_net — обработка ipv6_cidr
falseи отсутствующего Ipv6CidrBlockAssociationSet в VPC (https://github.com/ansible-collections/amazon.aws/pull/2374). - lambda — удаляются данные в кодировке, отличной от UTF-8 (содержимое ZIP-файла Lambda), из вывода модуля, чтобы избежать ошибки Ansible (https://github.com/ansible-collections/amazon.aws/issues/2386).
- rds_cluster — исправлена проблема, возникавшая при обновлении домена кластера RDS (https://github.com/ansible-collections/amazon.aws/issues/2390).
- s3_bucket — исправлена проблема компиляции в Python 3.7, вызванная добавлением сведений о типах (https://github.com/ansible-collections/amazon.aws/issues/2287).
v8.2.1
Сводка выпуска
Это выпуск с исправлением ошибки в модуле iam_role: устранена проблема, из-за которой создавались профили экземпляров IAM при значении create_instance_profile, равном false, а также обработано исключение EntityAlreadyExists, возникавшее, если профиль экземпляра уже существовал.
Исправления ошибок
- iam_role — устранено исключение
EntityAlreadyExists, возникавшее, еслиcreate_instance_profileимел значениеfalse, а профиль экземпляра уже существовал (https://github.com/ansible-collections/amazon.aws/issues/2102). - iam_role — устранена проблема, из-за которой создавались профили экземпляров IAM при значении
create_instance_profile, равномfalse(https://github.com/ansible-collections/amazon.aws/issues/2281).
v8.2.0
Сводка выпуска
Выпуск amazon.aws 8.2.0 включает ряд исправлений ошибок, новые функции и улучшения. Также в этом выпуске объявлено об устаревании модуля amazon.aws.iam_role: поддержка создания и удаления профилей экземпляров IAM с помощью параметров create_instance_profile и delete_instance_profile объявлена устаревшей и будет удалена в одном из выпусков после 2026-05-01.
Незначительные изменения
- cloudwatch_metric_alarm — добавлена поддержка параметра
evaluate_low_sample_count_percentile. - cloudwatch_metric_alarm — добавлена поддержка конфигурации DatapointsToAlarm (https://github.com/ansible-collections/amazon.aws/pull/2196).
- ec2_ami — добавлена поддержка режима загрузки uefi-preferred (https://github.com/ansible-collections/amazon.aws/pull/2253).
- ec2_instance — добавлена поддержка параметров
network_interfacesиnetwork_interfaces_ids, заменяющих устаревший параметрnetwork(https://github.com/ansible-collections/amazon.aws/pull/2123). - ec2_instance — параметр
network.source_dest_checkобъявлен устаревшим и заменён новым параметромsource_dest_check(https://github.com/ansible-collections/amazon.aws/pull/2123). - ec2_instance — добавлена возможность создавать экземпляры с несколькими сетевыми интерфейсами (https://github.com/ansible-collections/amazon.aws/pull/2123).
- ec2_metadata_facts — добавлен параметр
metadata_token_ttl_seconds(https://github.com/ansible-collections/amazon.aws/pull/2209). - rds_cluster — добавлена поддержка конфигурации хранилища с оптимизацией ввода-вывода для кластеров Aurora (https://github.com/ansible-collections/amazon.aws/pull/2063).
- rds_instance — согласно документации boto, для параметра
performance_insights_kms_key_idиспользовался неправильный формат snake_case (https://github.com/ansible-collections/amazon.aws/pull/2163). - s3_bucket — добавлена поддержка инвентаризации бакетов (https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-inventory.html)
- s3_object — добавлена поддержка параметра
expected_bucket_owner(https://github.com/ansible-collections/amazon.aws/issues/2114). - поиск параметров ssm — добавлен новый параметр
droppath, позволяющий исключить иерархический путь поиска из результатов поиска параметров ssm (https://github.com/ansible-collections/amazon.aws/pull/1756).
Устаревшие функции
- iam_role — поддержка создания и удаления профилей экземпляров IAM с помощью параметров
create_instance_profileиdelete_instance_profileобъявлена устаревшей и будет удалена в одном из выпусков после 2026-05-01. Для управления профилями экземпляров IAM можно использовать модульamazon.aws.iam_instance_profile(https://github.com/ansible-collections/amazon.aws/pull/2221).
Исправления ошибок
- cloudwatch_metric_alarm — исправлена идемпотентность при создании оповещения о метрике CloudWatch без измерений (https://github.com/ansible-collections/amazon.aws/pull/1865).
- ec2_instance — исправлена обработка состояния при использовании exact_count (https://github.com/ansible-collections/amazon.aws/pull/1659).
- rds_cluster — при использовании состояний started или stopped в вызов API передаётся только параметр DBClusterIdentifier (https://github.com/ansible-collections/amazon.aws/issues/2197).
- route53 — изменено возвращаемое значение: diff возвращается, только если
module._diffимеет значение true (https://github.com/ansible-collections/amazon.aws/pull/2136). - s3_bucket — перехватывается
UnsupportedArgumentпри вызове APIGetBucketAccelerationConfigв регионе, где он не поддерживается (https://github.com/ansible-collections/amazon.aws/issues/2180). - s3_bucket — изменено поведение по умолчанию нового параметра
accelerate_enabled: конфигурация обновляется, только если параметр явно передан (https://github.com/ansible-collections/amazon.aws/issues/2220). - s3_bucket — исправлены исключения
MethodNotAllowed, возникавшие при получении состояния ускорения передачи в регионах, где эта функция не поддерживается (https://github.com/ansible-collections/amazon.aws/issues/2266). - s3_bucket — исправлены ошибки
TypeError: cannot unpack non-iterable NoneType object, связанные с версионированием бакетов, политиками, тегами или шифрованием (https://github.com/ansible-collections/amazon.aws/pull/2228).
v8.1.0
Сводка выпуска
Этот выпуск содержит несколько улучшений документации и две новые функции для модуля s3_bucket.
Незначительные изменения
- s3_bucket — добавлен
object_lock_default_retentionдля настройки срока хранения по умолчанию Object Lock для бакетов S3 (https://github.com/ansible-collections/amazon.aws/pull/2062). - s3_bucket — добавлена поддержка включения ускорения передачи Amazon S3 с помощью параметра
accelerate_enabled(https://github.com/ansible-collections/amazon.aws/pull/2046).
v8.0.1
Сводка выпуска
Этот выпуск содержит исправления ошибок для модулей s3_object, ec2_instance и backup_plan_info.
Исправления ошибок
- backup_plan_info — исправлена ошибка, позволявшая получать сведения обо всех планах резервного копирования (https://github.com/ansible-collections/amazon.aws/pull/2083).
- ec2_instance — IPv6-адреса больше не игнорируются, если указан один сетевой интерфейс (https://github.com/ansible-collections/amazon.aws/pull/1979).
- s3_object — исправлена проблема, вызывавшая исключения
MemoryErrorпри загрузке больших файлов (https://github.com/ansible-collections/amazon.aws/issues/2107).
v8.0.0
Сводка выпуска
Этот крупный выпуск включает несколько новых функций, исправления ошибок и устаревшие функции. Также удалена часть функциональности iam_role, iam_role_info и module_utils.policy, ранее объявленная устаревшей. Кроме того, удалена поддержка ansible-core<2.15.
Незначительные изменения
- autoscaling_group — удалён неиспользуемый код (https://github.com/ansible-collections/amazon.aws/pull/1996).
- cloudformation — добавлены автоматические повторные попытки при постраничном получении событий стека без фильтра (https://github.com/ansible-collections/amazon.aws/pull/2049).
- cloudtrail — удалён неиспользуемый код (https://github.com/ansible-collections/amazon.aws/pull/1996).
- ec2_instance — удалён неиспользуемый код (https://github.com/ansible-collections/amazon.aws/pull/1996).
- ec2_vol — при удалении тома проверяется, что его состояние не равно
deletedилиdeleting, чтобы обеспечить идемпотентность (https://github.com/ansible-collections/amazon.aws/pull/2052). - ec2_vol — удалён неиспользуемый код (https://github.com/ansible-collections/amazon.aws/pull/1996).
- elb_classic_lb — удалён неиспользуемый код (https://github.com/ansible-collections/amazon.aws/pull/1996).
- kms_key — удалён неиспользуемый код (https://github.com/ansible-collections/amazon.aws/pull/1996).
- lambda_event — добавлена поддержка установки параметра
maximum_batching_window_in_seconds(https://github.com/ansible-collections/amazon.aws/pull/2025). - module_uils/botocore — поддерживаются наборы и кортежи ошибок, а также списки (https://github.com/ansible-collections/amazon.aws/pull/1829).
- module_utils/elbv2 — добавлена поддержка добавления прослушивателя с несколькими сертификатами при создании ALB. Это позволяет модулю elb_application_elb обрабатывать описанный сценарий. (https://github.com/ansible-collections/amazon.aws/pull/1950).
- module_utils/elbv2 — добавлена возможность обновлять
SslPolicy,CertificatesиAlpnPolicyдля прослушивателей TLS (https://github.com/ansible-collections/amazon.aws/issues/1198). - rds_instance — для удаления всех существующих экспортов в
enable_cloudwatch_logs_exportsможно передать пустой список (https://github.com/ansible-collections/amazon.aws/pull/1917). - s3_bucket — переработан код модуля s3_bucket для повышения читаемости и удобства сопровождения (https://github.com/ansible-collections/amazon.aws/pull/2057).
- s3_object — удалён неиспользуемый код (https://github.com/ansible-collections/amazon.aws/pull/1996).
Несовместимые изменения / руководство по переносу
- Коллекция amazon.aws — прекращена поддержка ansible-core < 2.15 (https://github.com/ansible-collections/amazon.aws/pull/2093).
- iam_role —
iam_role.assume_role_policy_documentбольше не преобразуется из CamelCase в snake_case (https://github.com/ansible-collections/amazon.aws/pull/2040). - iam_role_info —
iam_role.assume_role_policy_documentбольше не преобразуется из CamelCase в snake_case (https://github.com/ansible-collections/amazon.aws/pull/2040). - kms_key — возвращаемое значение
policiesпереименовано вkey_policies; его содержимое не изменилось (https://github.com/ansible-collections/amazon.aws/pull/2040). - kms_key_info — возвращаемое значение
policiesпереименовано вkey_policies; его содержимое не изменилось (https://github.com/ansible-collections/amazon.aws/pull/2040). - lambda_event — |
batch_sizeбольше не имеет значения по умолчанию 100. Согласно API boto3 (https://boto3.amazonaws.com/v1/documentation/api/1.26.78/reference/services/lambda.html#Lambda.Client.create_event_source_mapping), значениеbatch_sizeпо умолчанию равно 10 для источников SQS и 100 для потоковых источников (https://github.com/ansible-collections/amazon.aws/pull/2025).
Устаревшие функции
- Плагин инвентаризации aws_ec2 — удаление ранее объявленного устаревшим параметра
include_extra_api_callsзапланировано на выпуск 9.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2040). - cloudformation — параметр
templateобъявлен устаревшим и будет удалён в одном из выпусков после 2026-05-01. Параметрtemplate_bodyможно использовать совместно с плагином поиска (https://github.com/ansible-collections/amazon.aws/pull/2048). - iam_policy — удаление ранее объявленного устаревшим ключа возвращаемого значения
policiesзапланировано на выпуск 9.0.0. Вместо него используйте ключ возвращаемого значенияpolicy_names(https://github.com/ansible-collections/amazon.aws/pull/2040). - module_utils.botocore — параметр
boto3дляget_aws_connection_info()будет удалён в одном из выпусков после 2025-05-01. Параметрboto3игнорируется начиная с выпуска 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047). - module_utils.botocore — параметр
boto3дляget_aws_region()будет удалён в одном из выпусков после 2025-05-01. Параметрboto3игнорируется начиная с выпуска 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047). - module_utils.ec2 — параметр
boto3дляget_ec2_security_group_ids_from_names()будет удалён в одном из выпусков после 2025-05-01. Параметрboto3игнорируется начиная с выпуска 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047). - rds_param_group — модуль
rds_param_groupпереименован вrds_instance_param_group. Способ использования модуля не изменился. Псевдоним rds_param_group будет удалён в версии 10.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2058).
Удалённые функции (ранее объявленные устаревшими)
- iam_role — возвращаемое значение
iam_role.assume_role_policy_document_rawобъявлено устаревшим. Теперьiam_role.assume_role_policy_documentвозвращает данные в том же формате, что иiam_role.assume_role_policy_document_raw(https://github.com/ansible-collections/amazon.aws/pull/2040). - iam_role_info — возвращаемое значение
iam_role.assume_role_policy_document_rawобъявлено устаревшим. Теперьiam_role.assume_role_policy_documentвозвращает данные в том же формате, что иiam_role.assume_role_policy_document_raw(https://github.com/ansible-collections/amazon.aws/pull/2040). - module_utils.policy — ранее объявленная устаревшей функция
sort_json_policy_dict()удалена; рассмотрите возможность использовать вместо неёcompare_policies()(https://github.com/ansible-collections/amazon.aws/pull/2052).
Исправления ошибок
- elb_classic_lb — исправлена ошибка, из-за которой отсутствие
proxy_protocolили его значениеNoneмогло приводить к неожиданному поведению или ошибкам (https://github.com/ansible-collections/amazon.aws/pull/2049). - lambda_event — исправлена работа при значении
batch_sizeбольше 10: добавлена поддержка установкиmaximum_batching_window_in_seconds(https://github.com/ansible-collections/amazon.aws/pull/2025). - lambda_event — ARN функции теперь получается с помощью API AWS (get_function), а не формируется на основе сведений об аккаунте AWS (https://github.com/ansible-collections/amazon.aws/issues/1859).
v7.6.1
Сводка выпуска
Этот выпуск содержит исправления ошибок для модулей ec2_instance и backup_plan_info.
Исправления ошибок
- backup_plan_info — исправлена ошибка, позволявшая получать сведения обо всех планах резервного копирования (https://github.com/ansible-collections/amazon.aws/pull/2083).
- ec2_instance — IPv6-адреса больше не игнорируются, если указан один сетевой интерфейс (https://github.com/ansible-collections/amazon.aws/pull/1979).
v7.6.0
Сводка выпуска
Этот выпуск включает несколько исправлений ошибок, незначительные изменения и новые модули rds (rds_cluster_param_group, rds_cluster_param_group_info и rds_engine_versions_info). Также объявлено об устаревании модуля cloudformation.
Незначительные изменения
- ec2_instance — добавлена поддержка параметра
hostдля placement.tenancy (https://github.com/ansible-collections/amazon.aws/pull/2026). - ec2_vol — при удалении тома проверяется, что его состояние не равно
deletedилиdeleting, чтобы обеспечить идемпотентность (https://github.com/ansible-collections/amazon.aws/pull/2052).
Устаревшие функции
- cloudformation — параметр
templateобъявлен устаревшим и будет удалён в одном из выпусков после 2026-05-01. Параметрtemplate_bodyможно использовать совместно с плагином поиска (https://github.com/ansible-collections/amazon.aws/pull/2048). - module_utils.botocore — параметр
boto3дляget_aws_connection_info()будет удалён в одном из выпусков после 2025-05-01. Параметрboto3игнорируется начиная с выпуска 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047). - module_utils.botocore — параметр
boto3дляget_aws_region()будет удалён в одном из выпусков после 2025-05-01. Параметрboto3игнорируется начиная с выпуска 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047). - module_utils.ec2 — параметр
boto3дляget_ec2_security_group_ids_from_names()будет удалён в одном из выпусков после 2025-05-01. Параметрboto3игнорируется начиная с выпуска 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047).
Исправления ошибок
- iam_managed_policy — исправлена ошибка, из-за которой возникало
ParamValidationErrorпри попытке удалить политику, прикреплённую к роли или пользователю (https://github.com/ansible-collections/amazon.aws/issues/2067). - iam_role_info — исправлена ошибка обработки путей без префикса и/или суффикса
/(https://github.com/ansible-collections/amazon.aws/issues/2065). - s3_object — исправлена проблема с идемпотентностью при копировании объекта, загруженного с помощью составной загрузки (https://github.com/ansible-collections/amazon.aws/issues/2016).
Новые модули
- rds_cluster_param_group — управление группами параметров кластера RDS
- rds_cluster_param_group_info — описание свойств указанной группы параметров кластера RDS.
- rds_engine_versions_info — описание свойств указанных версий ядер СУБД.
v7.5.0
Сводка выпуска
В этом выпуске добавлена новая функция для модуля iam_user_info, исправлены ошибки в модулях cloudwatchlogs_log_group_info и s3_object, а также в плагинах инвентаризации; кроме того, выполнена внутренняя переработка module_utils.
Незначительные изменения
- iam_user_info — добавлен
login_profileдля возврата сведений, полученных от пользователя, чтобы узнать, может ли он входить в консоль AWS (https://github.com/ansible-collections/amazon.aws/pull/2012). - module_utils.iam — функции нормализации переработаны для использования
boto3_resource_to_ansible_dict()иboto3_resource_list_to_ansible_dict()(https://github.com/ansible-collections/amazon.aws/pull/2006). - module_utils.transformations — добавлены вспомогательные функции
boto3_resource_to_ansible_dict()иboto3_resource_list_to_ansible_dict()(https://github.com/ansible-collections/amazon.aws/pull/2006).
Исправления ошибок
- cloudwatchlogs_log_group_info — при вызовах API реализована экспоненциальная задержка, чтобы предотвратить исключения из-за превышения лимита запросов (https://github.com/ansible-collections/amazon.aws/issues/2011).
- plugin_utils.inventory — обеспечено преобразование шаблонных параметров в плагинах поиска (https://github.com/ansible-collections/amazon.aws/issues/1955).
- s3_object — исправлена проблема при копировании объекта с перезаписью метаданных. (https://github.com/ansible-collections/amazon.aws/issues/1991).
v7.4.0
Краткое описание выпуска
В этом выпуске исправлено несколько ошибок и внесены небольшие изменения. Также объявлено об устаревании плагина iam_role_info.
Небольшие изменения
- AnsibeAWSModule — добавлена
fail_json_aws_error()в качестве обертки дляfail_json()иfail_json_aws()при передаче исключенияAnsibleAWSError(https://github.com/ansible-collections/amazon.aws/pull/1997). - iam_access_key — рефакторинг кода для использования
AnsibleIAMErrorиIAMErrorHandler, а также перенос общего кода в module_utils.iam (https://github.com/ansible-collections/amazon.aws/pull/1998). - iam_access_key_info — рефакторинг кода для использования
AnsibleIAMErrorиIAMErrorHandler, а также перенос общего кода в module_utils.iam (https://github.com/ansible-collections/amazon.aws/pull/1998). - iam_group — рефакторинг кода для использования
AnsibleIAMErrorиIAMErrorHandler, а также перенос общего кода в module_utils.iam (https://github.com/ansible-collections/amazon.aws/pull/1998). - iam_instance_profile — рефакторинг кода для использования
AnsibleIAMErrorиIAMErrorHandler, а также перенос общего кода в module_utils.iam (https://github.com/ansible-collections/amazon.aws/pull/1998). - iam_instance_profile_info — рефакторинг кода для использования
AnsibleIAMErrorиIAMErrorHandler, а также перенос общего кода в module_utils.iam (https://github.com/ansible-collections/amazon.aws/pull/1998). - iam_managed_policy — рефакторинг кода для использования
AnsibleIAMErrorиIAMErrorHandler, а также перенос общего кода в module_utils.iam (https://github.com/ansible-collections/amazon.aws/pull/1998). - iam_mfa_device_info — рефакторинг кода для использования
AnsibleIAMErrorиIAMErrorHandler, а также перенос общего кода в module_utils.iam (https://github.com/ansible-collections/amazon.aws/pull/1998). - iam_role — рефакторинг кода для использования
AnsibleIAMErrorиIAMErrorHandler, а также перенос общего кода в module_utils.iam (https://github.com/ansible-collections/amazon.aws/pull/1998). - iam_role_info — рефакторинг кода для использования
AnsibleIAMErrorиIAMErrorHandler, а также перенос общего кода в module_utils.iam (https://github.com/ansible-collections/amazon.aws/pull/1998). - iam_user — рефакторинг кода для использования
AnsibleIAMErrorиIAMErrorHandler, а также перенос общего кода в module_utils.iam (https://github.com/ansible-collections/amazon.aws/pull/1998). - iam_user_info — рефакторинг кода для использования
AnsibleIAMErrorиIAMErrorHandler, а также перенос общего кода в module_utils.iam (https://github.com/ansible-collections/amazon.aws/pull/1998).
Устаревшие функции
- iam_role_info — в одном из выпусков после 2026-05-01 пути должны будут начинаться и заканчиваться на
/(https://github.com/ansible-collections/amazon.aws/pull/1998).
Исправления ошибок
- cloudwatchevent_rule — исправлено добавление кавычек во входные данные JSON для переданного input_template (https://github.com/ansible-collections/amazon.aws/pull/1883).
- lookup/secretsmanager_secret — исправлена проблема, из-за которой при отсутствии вложенного секрета и значении on_missing, равном warn, lookup выдавал ошибку вместо предупреждения (https://github.com/ansible-collections/amazon.aws/issues/1781).
- module_utils/elbv2 — исправлена проблема при создании или изменении правила балансировщика нагрузки типа authenticate-oidc с использованием параметра
ClientSecretиUseExistingClientSecret=true(https://github.com/ansible-collections/amazon.aws/issues/1877).
v7.3.0
Краткое описание выпуска
Выпуск amazon.aws 7.3.0 содержит ряд небольших исправлений ошибок, новые функции и улучшения.
Небольшие изменения
- backup_plan — добавлена возможность задавать
schedule_expression_timezoneдля правил плана резервного копирования при использовании botocore версии >= 1.31.36 (https://github.com/ansible-collections/amazon.aws/issues/1952). - iam_user — обработка ошибок переработана с использованием декоратора (https://github.com/ansible-collections/amazon.aws/pull/1951).
- lambda — добавлена поддержка использования образов ECR для функции (https://github.com/ansible-collections/amazon.aws/pull/1939).
- module_utils.errors — добавлен базовый декоратор для обработки ошибок (https://github.com/ansible-collections/amazon.aws/pull/1951).
- rds_cluster — добавлена поддержка ServerlessV2ScalingConfiguration для операций создания и изменения кластера (https://github.com/ansible-collections/amazon.aws/pull/1839).
- s3_bucket_info — добавлен параметр
bucket_versioningдля возврата состояния версионирования бакета (https://github.com/ansible-collections/amazon.aws/pull/1919). - s3_object_info — исправлено исключение, возникавшее при получении списка объектов из пустого бакета (https://github.com/ansible-collections/amazon.aws/pull/1919).
Исправления ошибок
- backup_plan — исправлена проблема с идемпотентностью при использовании botocore версии >= 1.31.36 (https://github.com/ansible-collections/amazon.aws/issues/1952).
- plugins/inventory/aws_ec2 — исправлен сбой при получении информации более чем о 40 экземплярах с use_ssm_inventory (https://github.com/ansible-collections/amazon.aws/issues/1713).
v7.2.0
Краткое описание выпуска
Этот выпуск содержит новые функции и исправление ошибки.
Небольшие изменения
- ec2_instance — добавлена поддержка изменения параметров метаданных существующего экземпляра (https://github.com/ansible-collections/amazon.aws/pull/1918).
- iam_group — добавлены базовые проверки
nameиpathдля улучшения сообщений об ошибках (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_group —
group_nameдобавлен как псевдоним дляnameдля согласованности с другими модулями IAM (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_instance_profile — добавлены базовые проверки
nameиpathдля улучшения сообщений об ошибках (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_instance_profile — добавлены базовые проверки
nameиpathдля улучшения сообщений об ошибках (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_instance_profile — попытка изменить
pathсуществующего профиля теперь вызывает предупреждение; ранее это изменение молча игнорировалось (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_instance_profile — параметр
prefixпереименован вpathдля согласованности с другими модулями IAM;prefixостается псевдонимом. Изменять плейбуки не требуется (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_instance_profile — значение по умолчанию для
pathудалено. Новые экземпляры по-прежнему будут создаваться с путем по умолчанию/. Изменять плейбуки не требуется (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_managed_policy — добавлены базовые проверки
nameиpathдля улучшения сообщений об ошибках (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_managed_policy —
descriptionпопытка обновить описание теперь вызывает предупреждение; ранее она просто игнорировалась (https://github.com/ansible-collections/amazon.aws/pull/1936). - iam_managed_policy —
policyбольше не является обязательным параметром (https://github.com/ansible-collections/amazon.aws/pull/1936). - iam_managed_policy — добавлена поддержка добавления тегов к управляемым политикам (https://github.com/ansible-collections/amazon.aws/pull/1936).
- iam_managed_policy — более последовательное выполнение повторных попыток при ошибках ограничения частоты запросов (https://github.com/ansible-collections/amazon.aws/pull/1936).
- iam_managed_policy — добавлена поддержка настройки
path(https://github.com/ansible-collections/amazon.aws/pull/1936). - iam_managed_policy — параметр
policy_descriptionпереименован вdescriptionдля согласованности с другими модулями IAM;policy_descriptionостается псевдонимом. Изменять плейбуки не требуется (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_managed_policy — параметр
policy_nameпереименован вnameдля согласованности с другими модулями IAM;policy_nameостается псевдонимом. Изменять плейбуки не требуется (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_role — добавлены базовые проверки
nameиpathдля улучшения сообщений об ошибках (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_role —
prefixиpath_prefixдобавлены как псевдонимы дляpathдля согласованности с другими модулями IAM (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_role —
role_nameдобавлен как псевдоним дляnameдля согласованности с другими модулями IAM (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_role — попытка изменить
pathсуществующего профиля теперь вызывает предупреждение; ранее это изменение молча игнорировалось (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_role — значение по умолчанию для
pathудалено. Новые роли по-прежнему будут создаваться с путем по умолчанию/. Изменять плейбуки не требуется (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_role_info —
pathиprefixдобавлены как псевдонимы дляpath_prefixдля согласованности с другими модулями IAM (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_user — добавлены базовые проверки
nameиpathдля улучшения сообщений об ошибках (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_user —
user_nameдобавлен как псевдоним дляnameдля согласованности с другими модулями IAM (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_user — добавлен параметр
boundaryдля управления граничной политикой пользователей (https://github.com/ansible-collections/amazon.aws/pull/1912). - iam_user — добавлен параметр
pathдля управления путем пользователя (https://github.com/ansible-collections/amazon.aws/pull/1912). - iam_user — в возвращаемое значение добавлен
attached_policies(https://github.com/ansible-collections/amazon.aws/pull/1912). - iam_user — рефакторинг кода для снижения сложности (https://github.com/ansible-collections/amazon.aws/pull/1912).
- iam_user_info —
prefixдобавлен как псевдоним дляpath_prefixдля согласованности с другими модулями IAM (https://github.com/ansible-collections/amazon.aws/pull/1933). - iam_user_info — параметр
pathпереименован вpath_prefixдля согласованности с другими модулями IAM;pathостается псевдонимом. Изменять плейбуки не требуется (https://github.com/ansible-collections/amazon.aws/pull/1933).
Исправления ошибок
- iam_managed_policy — исправлена проблема, из-за которой возвращались только частичные результаты (https://github.com/ansible-collections/amazon.aws/pull/1936).
v7.1.0
Краткое описание выпуска
В этом выпуске добавлены новые функции и исправлено несколько ошибок.
Небольшие изменения
- autoscaling_group — внесены небольшие косметические исправления пробелов в соответствии с PEP8 (https://github.com/ansible-collections/amazon.aws/pull/1846).
- ec2_ami_info — упрощены параметры до
get_image_attribute, чтобы передавать только идентификатор образа (https://github.com/ansible-collections/amazon.aws/pull/1846). - ec2_eip — для установки исходных тегов при создании используется
ResourceTags(https://github.com/ansible-collections/amazon.aws/issues/1843) - ec2_instance — добавлена поддержка параметра AdditionalInfo при создании экземпляра (https://github.com/ansible-collections/amazon.aws/pull/1828).
- ec2_security_group — для установки исходных тегов при создании используется
ResourceTags(https://github.com/ansible-collections/amazon.aws/pull/1844) - ec2_vpc_igw — для установки исходных тегов при создании используется
ResourceTags(https://github.com/ansible-collections/amazon.aws/issues/1843) - ec2_vpc_route_table — для установки исходных тегов при создании используется
ResourceTags(https://github.com/ansible-collections/amazon.aws/issues/1843) - ec2_vpc_subnet — значение по умолчанию для
tagsизменено с{}наNone; чтобы удалить теги из подсети, модулю необходимо явно передать пустую карту (https://github.com/ansible-collections/amazon.aws/pull/1876). - ec2_vpc_subnet — для установки исходных тегов при создании используется
ResourceTags(https://github.com/ansible-collections/amazon.aws/issues/1843) - ec2_vpc_subnet — параметр
wait_timeoutтакже используется для управления максимальным временем ожидания первоначального создания подсетей (https://github.com/ansible-collections/amazon.aws/pull/1848). - iam_group — добавлена поддержка настройки пути группы (https://github.com/ansible-collections/amazon.aws/pull/1892).
- iam_group — добавлено возвращаемое значение attached_policies (https://github.com/ansible-collections/amazon.aws/pull/1892).
- iam_group — код переработан, чтобы избежать использования одной длинной функции (https://github.com/ansible-collections/amazon.aws/pull/1892).
- rds_instance_snapshot — внесены небольшие косметические исправления пробелов в соответствии с PEP8 (https://github.com/ansible-collections/amazon.aws/pull/1846).
Исправления ошибок
- ec2_vpc_subnet — корректно обрабатывается сбой, если подсеть не создана вовремя (https://github.com/ansible-collections/amazon.aws/pull/1848).
- s3_object — исправлена опечатка, приводившая к ложному предупреждению об устаревании при настройке
overwrite=latest(https://github.com/ansible-collections/amazon.aws/pull/1847). - s3_object — при выполнении put с указанием
Content-Typeв метаданных этот модуль (начиная с версии 6.0.0) ошибочно устанавливалContent-Typeв значениеNone, из-за чего операция put завершалась с ошибкой. Теперь указанное значениеContent-Typeучитывается корректно (https://github.com/ansible-collections/amazon.aws/issues/1881).
v7.0.0
Сводка выпуска
Этот крупный выпуск включает новый набор поддерживаемых модулей, перенесённых из community.aws, несколько исправлений ошибок, незначительные изменения и устаревшие функции. Также прекращена поддержка botocore<1.29.0 и boto3<1.26.0. Поскольку AWS SDK объявили о прекращении поддержки Python ниже версии 3.7 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/), поддержка Python ниже версии 3.7 этой коллекцией была объявлена устаревшей в выпуске 6.0.0 и удалена в этом выпуске.
Основные изменения
- aws_region_info — модуль перенесён из коллекции
community.aws. Плейбуки, использующие полное имя коллекции для этого модуля, следует обновить и использоватьamazon.aws.aws_region_info. - aws_s3_bucket_info — модуль перенесён из коллекции
community.aws. Плейбуки, использующие полное имя коллекции для этого модуля, следует обновить и использоватьamazon.aws.aws_s3_bucket_info. - iam_access_key — модуль перенесён из коллекции
community.aws. Плейбуки, использующие полное имя коллекции для этого модуля, следует обновить и использоватьamazon.aws.iam_access_key. - iam_access_key_info — модуль перенесён из коллекции
community.aws. Плейбуки, использующие полное имя коллекции для этого модуля, следует обновить и использоватьamazon.aws.iam_access_key_info. - iam_group — модуль перенесён из коллекции
community.aws. Плейбуки, использующие полное имя коллекции для этого модуля, следует обновить и использоватьamazon.aws.iam_group(https://github.com/ansible-collections/amazon.aws/pull/1755). - iam_managed_policy — модуль перенесён из коллекции
community.aws. Плейбуки, использующие полное имя коллекции для этого модуля, следует обновить и использоватьamazon.aws.iam_managed_policy(https://github.com/ansible-collections/amazon.aws/pull/1762). - iam_mfa_device_info — модуль перенесён из коллекции
community.aws. Плейбуки, использующие полное имя коллекции для этого модуля, следует обновить и использоватьamazon.aws.iam_mfa_device_info(https://github.com/ansible-collections/amazon.aws/pull/1761). - iam_password_policy — модуль перенесён из коллекции
community.aws. Плейбуки, использующие полное имя коллекции для этого модуля, следует обновить и использоватьamazon.aws.iam_password_policy. - iam_role — модуль перенесён из коллекции
community.aws. Плейбуки, использующие полное имя коллекции для этого модуля, следует обновить и использоватьamazon.aws.iam_role(https://github.com/ansible-collections/amazon.aws/pull/1760). - iam_role_info — модуль перенесён из коллекции
community.aws. Плейбуки, использующие полное имя коллекции для этого модуля, следует обновить и использоватьamazon.aws.iam_role_info(https://github.com/ansible-collections/amazon.aws/pull/1760). - s3_bucket_info — модуль перенесён из коллекции
community.aws. Плейбуки, использующие полное имя коллекции для этого модуля, следует обновить и использоватьamazon.aws.s3_bucket_info. - sts_assume_role — модуль перенесён из коллекции
community.aws. Плейбуки, использующие полное имя коллекции для этого модуля, следует обновить и использоватьamazon.aws.sts_assume_role.
Незначительные изменения
- коллекция amazon.aws — применено форматирование кода isort для обеспечения единообразия форматирования (https://github.com/ansible-collections/amazon.aws/pull/1771).
- ec2_instance — добавлена поддержка дополнительных параметров
placementиlicense_specificationsв спецификации запуска экземпляра (https://github.com/ansible-collections/amazon.aws/issues/1824). - ec2_instance_info — добавлен новый параметр
include_attributesдля описания атрибутов экземпляра (https://github.com/ansible-collections/amazon.aws/pull/1577). - ec2_metadata_facts — в подходящих случаях используются f-строки (https://github.com/ansible-collections/amazon.aws/pull/1802).
- ec2_vpc_igw — добавлена возможность подключать/отключать VPC к интернет-шлюзу/от интернет-шлюза (https://github.com/ansible-collections/amazon.aws/pull/1786).
- ec2_vpc_igw — добавлена возможность менять VPC, подключённую к интернет-шлюзу (https://github.com/ansible-collections/amazon.aws/pull/1786).
- ec2_vpc_igw — добавлена возможность создавать интернет-шлюз без подключения VPC (https://github.com/ansible-collections/amazon.aws/pull/1786).
- ec2_vpc_igw — добавлена возможность удалять интернет-шлюз VPC по идентификатору шлюза (https://github.com/ansible-collections/amazon.aws/pull/1786).
- elb_application_lb_info — добавлены новые параметры
include_attributes,include_listenersиinclude_listener_rulesдля возможного ускорения работы модуля за счёт получения меньшего объёма информации (https://github.com/ansible-collections/amazon.aws/pull/1778). - module_utils.botocore — вместо встроенной копии LooseVersion используется packaging.version.Version (https://github.com/ansible-collections/amazon.aws/pull/1587).
- rds_cluster — добавлена поддержка удаления кластера из глобальной базы данных (https://github.com/ansible-collections/amazon.aws/pull/1705).
- rds_cluster — добавлена поддержка ещё одного варианта
stateпод названиемstarted. Он запускает кластер RDS (https://github.com/ansible-collections/amazon.aws/pull/1647/files). - rds_cluster — добавлена поддержка ещё одного варианта
stateпод названиемstopped. Он останавливает кластер RDS (https://github.com/ansible-collections/amazon.aws/pull/1647/files). - route53 — добавлено возвращаемое значение
wait_idпри выполнении изменения (https://github.com/ansible-collections/amazon.aws/pull/1683). - route53_health_check — добавлена поддержка строкового списка параметра
child_health_checksдля указания проверок работоспособности, которые должны быть успешными для вычисляемой проверки работоспособности (https://github.com/ansible-collections/amazon.aws/pull/1631). - route53_health_check — добавлена поддержка целочисленного параметра
health_thresholdдля указания минимального количества дочерних проверок работоспособности, которые должны быть успешными для вычисляемой проверки работоспособности (https://github.com/ansible-collections/amazon.aws/pull/1631). - route53_health_check — добавлена поддержка ещё одного варианта
typeпод названиемCALCULATED(https://github.com/ansible-collections/amazon.aws/pull/1631). - s3_object — разрешено рекурсивное копирование объектов в корзине S3 (https://github.com/ansible-collections/amazon.aws/issues/1379).
- s3_object — в подходящих случаях используются f-строки (https://github.com/ansible-collections/amazon.aws/pull/1802).
Несовместимые изменения / руководство по переносу
- В коллекции amazon.aws прекращена поддержка
botocore<1.29.0иboto3<1.26.0. Большинство модулей продолжат работать со старыми версиями AWS SDK, однако совместимость со старыми версиями SDK не гарантируется и не будет тестироваться. При использовании старых версий SDK Ansible выдаст предупреждение (https://github.com/ansible-collections/amazon.aws/pull/1763). - коллекция amazon.aws — в связи с объявлением AWS SDK о прекращении поддержки Python ниже версии 3.7 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) поддержка Python ниже версии 3.7 этой коллекцией была объявлена устаревшей в выпуске 6.0.0 и удалена в выпуске 7.0.0. (https://github.com/ansible-collections/amazon.aws/pull/1763).
- module_utils — поддержка
module_utils.urlsранее была объявлена устаревшей; компонент удалён (https://github.com/ansible-collections/amazon.aws/pull/1540). - module_utils._version — удалена встроенная копия distutils.version (https://github.com/ansible-collections/amazon.aws/pull/1587).
Устаревшие функции
- ec2_instance —
tenancyиplacement_groupобъявлены устаревшими; вместо них следует использовать атрибутplacement(https://github.com/ansible-collections/amazon.aws/pull/1825).
Исправления ошибок
- плагин инвентаризации aws_ec2 — исправлена ошибка
NoRegionError, возникавшая, когда регионы не указаны и регион не задан (https://github.com/ansible-collections/amazon.aws/issues/1551). - ec2_instance — повторный вызов API при получении ошибки
InvalidInstanceID.NotFound(https://github.com/ansible-collections/amazon.aws/pull/1650). - ec2_vpc_route_table_info — фильтрам по умолчанию назначен пустой словарь (https://github.com/ansible-collections/amazon.aws/issues/1668).
- s3_bucket — исправлена проблема при удалении корзины с объектами без версий (https://github.com/ansible-collections/amazon.aws/issues/1533).
- s3_object — исправлена ошибка
NoSuchTagSet, возникавшая, если конечная точка S3 не поддерживает теги (https://github.com/ansible-collections/amazon.aws/issues/1607). - s3_object — исправлен регресс, связанный с объектами, имя которых начинается с
/(https://github.com/ansible-collections/amazon.aws/issues/1548).
Новые модули
- ec2_import_image — управление задачами импорта образов AWS EC2
- ec2_import_image_info — сбор информации о задачах импорта виртуальных машин
- rds_global_cluster_info — получение информации о глобальных кластерах баз данных Aurora
v6.5.4
Сводка выпуска
Этот выпуск содержит исправления ошибок модуля cloudwatchlogs_log_group_info и плагинов инвентаризации.
Исправления ошибок
- cloudwatchlogs_log_group_info — при вызовах API реализована экспоненциальная задержка, чтобы избежать исключений из-за ограничения частоты запросов (https://github.com/ansible-collections/amazon.aws/issues/2011).
- plugin_utils.inventory — обеспечено преобразование шаблонных параметров в плагинах поиска (https://github.com/ansible-collections/amazon.aws/issues/1955).
v6.5.3
Сводка выпуска
Этот выпуск содержит исправления ошибок модуля``cloudwatchevent_rule`` и плагина поиска secretsmanager_secret.
Исправления ошибок
- cloudwatchevent_rule — устранено добавление кавычек к входным данным JSON для указанного input_template (https://github.com/ansible-collections/amazon.aws/pull/1883).
- lookup/secretsmanager_secret — исправлена проблема: если вложенный секрет отсутствовал, а для on_missing было задано значение warn, поиск выдавал ошибку вместо предупреждения (https://github.com/ansible-collections/amazon.aws/issues/1781).
v6.5.2
Сводка выпуска
Этот выпуск содержит исправление ошибки плагина инвентаризации amazon.aws.aws_ec2 при получении информации более чем о 40 экземплярах с помощью use_ssm_inventory.
Исправления ошибок
- plugins/inventory/aws_ec2 — исправлен сбой при получении информации более чем о 40 экземплярах с параметром use_ssm_inventory (https://github.com/ansible-collections/amazon.aws/issues/1713).
v6.5.1
Сводка выпуска
Этот выпуск содержит несколько исправлений ошибок.
Незначительные изменения
- ec2_vpc_subnet — используется
wait_timeout, чтобы также управлять максимальным временем ожидания первоначального создания подсетей (https://github.com/ansible-collections/amazon.aws/pull/1848).
Исправления ошибок
- ec2_instance — повторный вызов API при получении ошибки
InvalidInstanceID.NotFound(https://github.com/ansible-collections/amazon.aws/pull/1650). - ec2_vpc_subnet — корректно обрабатывается сбой, если подсеть не была создана вовремя (https://github.com/ansible-collections/amazon.aws/pull/1848).
- s3_object — исправлена опечатка, из-за которой при задании
overwrite=latestвыводилось ложное предупреждение об устаревании (https://github.com/ansible-collections/amazon.aws/pull/1847). - s3_object — исправлена ошибка
NoSuchTagSet, возникавшая, если конечная точка S3 не поддерживает теги (https://github.com/ansible-collections/amazon.aws/issues/1607). - s3_object — при выполнении put с указанием
Content-Typeв метаданных этот модуль (начиная с версии 6.0.0) ошибочно задавалContent-TypeзначениеNone, из-за чего операция put завершалась ошибкой. Теперь указанное значениеContent-Typeучитывается корректно (https://github.com/ansible-collections/amazon.aws/issues/1881).
v6.5.0
Сводка выпуска
Этот выпуск — последний запланированный минорный выпуск amazon.aws перед выходом версии 7.0.0. Он содержит исправления документации, а также незначительные изменения и исправления ошибок модулей ec2_ami и elb_application_lb_info.
Незначительные изменения
- ec2_ami — добавлена поддержка
org_arnsиorg_unit_arnsв launch_permissions (https://github.com/ansible-collections/amazon.aws/pull/1690). - elb_application_lb_info — удалён избыточный вызов
describe_load_balancersдля полученияip_address_type(https://github.com/ansible-collections/amazon.aws/pull/1768).
Исправления ошибок
- elb_application_lb_info — обеспечено использование декоратора повторных попыток во всех запросах API (https://github.com/ansible-collections/amazon.aws/issues/1767).
v6.4.0
Сводка выпуска
В этом выпуске добавлены новый модуль amazon.aws.ec2_key_info, улучшения документации, новые функции и исправления ошибок.
Незначительные изменения
- cloudformation — добавлена поддержка
disable_rollbackдля операции обновления стека (https://github.com/ansible-collections/amazon.aws/issues/1681). - ec2_key — добавлена поддержка нового параметра
file_nameдля сохранения закрытого ключа, созданного AWS при создании нового ключа. Если этот параметр задан, созданный закрытый ключ будет удалён из результата работы модуля (https://github.com/ansible-collections/amazon.aws/pull/1704).
Исправления ошибок
- backup_selection — обеспечено добавление новых
Conditionsпри обновлении существующего набора, если ранее таких элементов не было (https://github.com/ansible-collections/amazon.aws/pull/1701).
Новые модули
- ec2_key_info — сбор информации о парах ключей EC2 в AWS
v6.3.0
Сводка выпуска
В этом выпуске добавлены новые функции и несколько исправлений ошибок.
Незначительные изменения
- rds_cluster — добавлена поддержка ещё одного варианта
stateпод названиемstarted. Он запускает кластер RDS (https://github.com/ansible-collections/amazon.aws/pull/1647/files). - rds_cluster — добавлена поддержка ещё одного варианта
stateпод названиемstopped. Он останавливает кластер RDS (https://github.com/ansible-collections/amazon.aws/pull/1647/files). - route53 — добавлено возвращаемое значение
wait_idпри выполнении изменения (https://github.com/ansible-collections/amazon.aws/pull/1683). - route53_health_check — добавлена поддержка строкового списка параметра
child_health_checksдля указания проверок работоспособности, которые должны быть успешными для вычисляемой проверки работоспособности (https://github.com/ansible-collections/amazon.aws/pull/1631). - route53_health_check — добавлена поддержка целочисленного параметра
health_thresholdдля указания минимального количества дочерних проверок работоспособности, которые должны быть успешными для вычисляемой проверки работоспособности (https://github.com/ansible-collections/amazon.aws/pull/1631). - route53_health_check — добавлена поддержка ещё одного варианта
typeпод названиемCALCULATED(https://github.com/ansible-collections/amazon.aws/pull/1631).
Исправления ошибок
- ec2_vpc_route_table_info — фильтрам по умолчанию назначен пустой словарь (https://github.com/ansible-collections/amazon.aws/issues/1668).
- rds_cluster — в список параметров, передаваемых при создании или изменении кластера RDS Multi-AZ, добавлены
AllocatedStorage,DBClusterInstanceClass,StorageType,IopsиEngineMode(https://github.com/ansible-collections/amazon.aws/pull/1657). - rds_cluster — разрешена передача GlobalClusterIdentifier кластеру RDS при создании (https://github.com/ansible-collections/amazon.aws/pull/1663).
v6.2.0
Сводка выпуска
В этом выпуске добавлены новые модули и функции, а также несколько исправлений ошибок.
Незначительные изменения
- backup_selection — добавлены проверка и документация для всех дополнительных параметров conditions (https://github.com/ansible-collections/amazon.aws/pull/1633).
- ec2_instance — переработана обработка проверки ARN (https://github.com/ansible-collections/amazon.aws/pull/1619).
- iam_user — переработана обработка проверки ARN (https://github.com/ansible-collections/amazon.aws/pull/1619).
- module_utils.arn — добавлены
resource_idиresource_typeк возвращаемым значениямparse_aws_arn(https://github.com/ansible-collections/amazon.aws/pull/1619). - module_utils.arn — добавлена функция
validate_aws_arnдля обработки распространённых шаблонов сопоставления ARN (https://github.com/ansible-collections/amazon.aws/pull/1619).
Исправления ошибок
- backup_plan — используется существующая функция
scrub_none_valuesиз module_utils для удаления значений None из вложенных словарей переданных параметров. Вложенные значения None сохранялись и вызывали ошибку при передаче операции клиента boto3 (https://github.com/ansible-collections/amazon.aws/pull/1611). - backup_vault — исправлена ошибка при обновлении тегов резервного хранилища: теперь для добавления и удаления тегов ресурсов резервного копирования используются правильные методы клиента boto3 (https://github.com/ansible-collections/amazon.aws/pull/1610).
- cloudwatchevent_rule — исправлено значение статуса changed: теперь возвращается False, если изменений не было. Ранее модуль ошибочно всегда сообщал об изменении. (https://github.com/ansible-collections/amazon.aws/pull/1589)
- ec2_vpc_nat_gateway — добавлен логический параметр
default_create, позволяющий пользователям выбирать, выводить ли сообщение об ошибке или создавать NAT-шлюз, если адрес EIP не найден. Ранее модуль (ec2_vpc_nat_gateway) при отсутствии EIP ошибочно завершался без сообщения (https://github.com/ansible-collections/amazon.aws/issues/1295). - ec2_vpc_nat_gateway — исправлено поведение NAT-шлюза: при создании частного NAT-шлюза адрес Elastic IP выделяться не должен. Ранее при создании частного NAT-шлюза модуль ошибочно всегда выделял адрес Elastic IP (https://github.com/ansible-collections/amazon.aws/pull/1632).
- lambda_execute — исправлен вывод трассировки стека: между символами теперь не пропускаются пробелы. Ранее модуль ошибочно всегда добавлял лишние пробелы между символами. (https://github.com/ansible-collections/amazon.aws/pull/1615)
- module_utils.backup — исправлена функция get_selection_details: теперь она не возвращает пустой список, если существует несколько наборов резервного копирования (https://github.com/ansible-collections/amazon.aws/pull/1633).
Новые модули
- iam_instance_profile — управление профилями экземпляров IAM
- iam_instance_profile_info — сбор информации о профилях экземпляров IAM
v6.1.0
Сводка выпуска
В этом выпуске представлены новые возможности, несколько исправлений ошибок, а также устаревшие функции.
Незначительные изменения
- ec2_snapshot — добавлена поддержка изменения createVolumePermission (https://github.com/ansible-collections/amazon.aws/pull/1464).
- ec2_snapshot_info — добавлен createVolumePermission в результат (https://github.com/ansible-collections/amazon.aws/pull/1464).
Устаревшие функции
- s3_object — поддержка передачи ключей объектов с начальным
/признана устаревшей и будет удалена в одном из выпусков после 2025-12-01 (https://github.com/ansible-collections/amazon.aws/pull/1549).
Исправления ошибок
- autoscaling_group — исправлена ошибка ValidationError при описании группы автомасштабирования, к которой подключено более 20 целевых групп: запрос разбивается на части (https://github.com/ansible-collections/amazon.aws/pull/1593).
- autoscaling_group_info — исправлена ошибка ValidationError при описании группы автомасштабирования, к которой подключено более 20 целевых групп: запрос разбивается на части (https://github.com/ansible-collections/amazon.aws/pull/1593).
- ec2_instance — исправлена проблема с check_mode при добавлении сетевых интерфейсов (https://github.com/ansible-collections/amazon.aws/issues/1403).
- ec2_metadata_facts — добавлена обработка распаковки данных пользователя экземпляра EC2, сжатых с помощью gzip. Метод fetch_url из ansible.module_utils.urls не распаковывает данные пользователя, если заголовок явно не содержит
Content-Encoding: gzip(https://github.com/ansible-collections/amazon.aws/pull/1575). - elb_application_lb — исправлено отсутствие атрибутов при создании ALB.
create_or_update_alb()включал атрибуты, специфичные для ALB, при обновлении существующего ALB, но не при создании нового ALB (https://github.com/ansible-collections/amazon.aws/issues/1510). - module_utils.acm — исправлена проблема, из-за которой list_certificates возвращал только сертификаты RSA_2048 (https://github.com/ansible-collections/amazon.aws/issues/1567).
- rds_instance — добавлена поддержка CACertificateIdentifier при создании и обновлении экземпляра RDS (https://github.com/ansible-collections/amazon.aws/pull/1459).
v6.0.1
Сводка выпуска
Это исправительный выпуск, содержащий несколько исправлений ошибок для плагина инвентаризации aws_ec2 и модулей s3_bucket и s3_object.
Исправления ошибок
- плагин инвентаризации aws_ec2 — исправлена проблема
NoRegionError, возникавшая, если регионы не указаны и регион не задан (https://github.com/ansible-collections/amazon.aws/issues/1551). - s3_bucket — исправлена проблема при удалении бакета с объектами без версионирования (https://github.com/ansible-collections/amazon.aws/issues/1533).
- s3_object — исправлена регрессия, связанная с объектами, имена которых начинаются с
/(https://github.com/ansible-collections/amazon.aws/issues/1548).
v6.0.0
Сводка выпуска
В этом выпуске добавлены новые плагины и функции. Также включены несколько исправлений ошибок, несовместимые изменения и устаревшие функции. В коллекции amazon.aws прекращена поддержка botocore<1.25.0 и boto3<1.22.0. Поддержка Python 3.6 также прекращена.
Незначительные изменения
- Добавлены действия GitHub для запуска модульных тестов и тестов sanity.(https://github.com/ansible-collections/amazon.aws/pull/1393).
- AnsibleAWSModule — добавлена поддержка переопределения параметров по умолчанию для методов
clientиresource(https://github.com/ansible-collections/amazon.aws/pull/1303). - CONTRIBUTING.md — переработана и дополнена документация для участников (https://github.com/ansible-collections/amazon.aws/issues/924)
- Переработаны плагины инвентаризации и добавлены модульные тесты инвентаризации aws_rds (https://github.com/ansible-collections/amazon.aws/pull/1218).
- Переработан module_utils/cloudfront_facts.py и добавлены модульные тесты (https://github.com/ansible-collections/amazon.aws/pull/1265).
- Для повышения согласованности кода во всей коллекции был запущен форматировщик кода
black(https://github.com/ansible-collections/amazon.aws/pull/1465). - Плагины инвентаризации amazon.aws — дополнительно переработана обработка подключений в плагинах инвентаризации (https://github.com/ansible-collections/amazon.aws/pull/1271).
- Плагины поиска amazon.aws —
aws_access_keyпереименован вaccess_keyдля согласования имен модулей и плагинов;aws_access_keyостается псевдонимом. Это изменение не должно быть заметно пользователям вне документации модулей и плагинов (https://github.com/ansible-collections/amazon.aws/pull/1225). - Плагины поиска amazon.aws —
aws_profileпереименован вprofileдля согласования имен модулей и плагинов;aws_profileостается псевдонимом. Это изменение не должно быть заметно пользователям вне документации модулей и плагинов (https://github.com/ansible-collections/amazon.aws/pull/1225). - Плагины поиска amazon.aws —
aws_secret_keyпереименован вsecret_keyдля согласования имен модулей и плагинов;aws_secret_keyостается псевдонимом. Это изменение не должно быть заметно пользователям вне документации модулей и плагинов (https://github.com/ansible-collections/amazon.aws/pull/1225). - Плагины поиска amazon.aws —
aws_security_tokenпереименован вsession_tokenдля согласования имен модулей и плагинов;aws_security_tokenостается псевдонимом. Это изменение не должно быть заметно пользователям вне документации модулей и плагинов (https://github.com/ansible-collections/amazon.aws/pull/1225). - Модули amazon.aws — массово обновлены операторы импорта после различных переработок (https://github.com/ansible-collections/amazon.aws/pull/1310).
- autoscaling_group — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- aws_account_attribute — плагин поиска
aws_account_attributeпереработан: в качестве базового класса используетсяAWSLookupBase(https://github.com/ansible-collections/amazon.aws/pull/1225). - Инвентаризация aws_ec2 — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- aws_secret — плагин поиска
aws_secretпереработан: в качестве базового класса используетсяAWSLookupBase(https://github.com/ansible-collections/amazon.aws/pull/1225). - aws_secret — плагин поиска
aws_secretпереименован вsecretsmanager_secret;aws_secretостается псевдонимом (https://github.com/ansible-collections/amazon.aws/pull/1225). - aws_ssm — плагин поиска
aws_ssmпереработан: в качестве базового класса используетсяAWSLookupBase(https://github.com/ansible-collections/amazon.aws/pull/1225). - aws_ssm — плагин поиска
aws_ssmпереименован вssm_parameter;aws_ssmостается псевдонимом (https://github.com/ansible-collections/amazon.aws/pull/1225). - backup — добавлена логика для модулей backup_selection* (https://github.com/ansible-collections/amazon.aws/pull/1530).
- Массовый перевод
%и.format()на f-строки (https://github.com/ansible-collections/amazon.aws/pull/1483). - cloud module_utils — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- cloudtrail_info — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- cloudwatchlogs_log_group — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- docs_fragments — фрагмент
amazon.aws.boto3теперь получает сведения о требованиях к версии botocore изmodule_utils.botocore(https://github.com/ansible-collections/amazon.aws/pull/1248). - docs_fragments — общие параметры модулей и плагинов синхронизированы и перенесены в
amazon.aws.common.modulesиamazon.aws.common.plugins(https://github.com/ansible-collections/amazon.aws/pull/1248). - docs_fragments — параметры региона модулей и плагинов синхронизированы и перенесены в
amazon.aws.region.modulesиamazon.aws.region.plugins(https://github.com/ansible-collections/amazon.aws/pull/1248). - ec2_ami — расширено покрытие модуля модульными тестами (https://github.com/ansible-collections/amazon.aws/pull/1159).
- ec2_ami — разрешены повторные попытки waiter
ImageAvailable, если образ не удается найти (https://github.com/ansible-collections/amazon.aws/pull/1321). - ec2_ami_info — добавлено покрытие модульными тестами (https://github.com/ansible-collections/amazon.aws/pull/1252).
- ec2_eip — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- ec2_eni_info — добавлено покрытие модульными тестами (https://github.com/ansible-collections/amazon.aws/pull/1236).
- ec2_instance — исключено изменение
module.params(https://github.com/ansible-collections/amazon.aws/pull/1187). - ec2_instance — обновлен, чтобы не изменять
module.params(https://github.com/ansible-collections/amazon.aws/pull/1337). - ec2_security_group — в спецификации аргументов добавлены параметры правил для улучшения обработки входных данных (https://github.com/ansible-collections/amazon.aws/pull/1214).
- ec2_security_group — переработан
get_target_from_rule()(https://github.com/ansible-collections/amazon.aws/pull/1221). - ec2_security_group — переработано развертывание правил и добавлены модульные тесты (https://github.com/ansible-collections/amazon.aws/pull/1261).
- ec2_snapshot — повторно включены интеграционные тесты (https://github.com/ansible-collections/amazon.aws/pull/1235).
- ec2_snapshot_info — добавлено покрытие модульными тестами (https://github.com/ansible-collections/amazon.aws/pull/1211).
- ec2_vpc_route_table — добавлена поддержка записи Carrier Gateway (https://github.com/ansible-collections/amazon.aws/pull/926).
- ec2_vpc_subnet — после создания подсети повторно запрашиваются ее сведения, если первая попытка не удалась (https://github.com/ansible-collections/amazon.aws/pull/1526).
- Инвентаризация aws ec2 — добавлен параметр
use_ssm_inventoryдля запроса сведений об инвентаризации ssm настроенных экземпляров EC2 и заполнения hostvars (https://github.com/ansible-collections/amazon.aws/issues/704). - Плагины инвентаризации — переработана обработка кэша (https://github.com/ansible-collections/amazon.aws/pull/1285).
- Плагины инвентаризации — переработана проверка файлов (https://github.com/ansible-collections/amazon.aws/pull/1285).
- Интеграционные тесты inventory_aws_ec2 — локальный модуль
test_get_ssm_inventoryзаменен наcommunity.aws.ssm_inventory_info(https://github.com/ansible-collections/amazon.aws/pull/1416). - kms_key_info — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- lambda — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- lambda — вместо повторной реализации используется общий вспомогательный компонент
get_aws_account_info(https://github.com/ansible-collections/amazon.aws/pull/1181). - lambda_alias — переработан, чтобы не передавать сложный ресурс
moduleмежду компонентами (https://github.com/ansible-collections/amazon.aws/pull/1336). - lambda_alias — обновлен, чтобы не изменять
module.params(https://github.com/ansible-collections/amazon.aws/pull/1336). - lambda_execute — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- lambda_info — обновлен, чтобы не изменять
module.params(https://github.com/ansible-collections/amazon.aws/pull/1336). - lambda_layer_info — добавлена поддержка параметра version_number для получения подробных сведений о конкретной версии слоя (https://github.com/ansible-collections/amazon.aws/pull/1293).
- module_utils — RetryingBotoClientWrapper перенесен в module_utils.retries для повторного использования с другими типами плагинов (https://github.com/ansible-collections/amazon.aws/pull/1230).
- module_utils — исключения перенесены в отдельный модуль Python (https://github.com/ansible-collections/amazon.aws/pull/1246).
- module_utils — проверка версии botocore переработана и перенесена в module_utils.botocore для дальнейшего повторного использования (https://github.com/ansible-collections/amazon.aws/pull/1227).
- module_utils.acm — переработан класс ACMServiceManager и добавлены модульные тесты (https://github.com/ansible-collections/amazon.aws/pull/1273).
- module_utils.botocore — добавлена идентификация Ansible AWS User-Agent (https://github.com/ansible-collections/amazon.aws/pull/1306).
- module_utils.botocore —
get_aws_regionиget_aws_connection_infoпереработаны для повторного использования кода плагинами, отличными от модулей (https://github.com/ansible-collections/amazon.aws/pull/1231). - module_utils.policy — код незначительно переработан для снижения сложности и повышения покрытия тестами (https://github.com/ansible-collections/amazon.aws/pull/1136).
- module_utils.s3 — get_s3_connection переработан и перенесен в module_utils для модулей S3; расширен набор модульных тестов module_utils.s3 (https://github.com/ansible-collections/amazon.aws/pull/1139).
- module_utils/botocore — в
_boto3_connдобавлена поддержка передачи словарей конфигурации (https://github.com/ansible-collections/amazon.aws/pull/1307). - plugin_utils — добавлен
AWSConnectionBaseдля поддержки переработки плагинов подключений (https://github.com/ansible-collections/amazon.aws/pull/1340). - rds — AWS постепенно прекращает поддержку aurora1. В интеграционных тестах по умолчанию используется aurora2 (aurora-mysql) (https://github.com/ansible-collections/amazon.aws/pull/1233).
- rds_cluster — функциональные тесты разделены на более мелкие наборы (https://github.com/ansible-collections/amazon.aws/pull/1175).
- rds_cluster_snapshot — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- rds_instance — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- rds_instance_info — добавлено покрытие модульными тестами (https://github.com/ansible-collections/amazon.aws/pull/1132).
- rds_instance_snapshot — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- rds_param_group — удалены резервные варианты импорта для Python 2 (https://github.com/ansible-collections/amazon.aws/pull/1513).
- route53_health_check — удалено предупреждение об устаревании (https://github.com/ansible-collections/community.aws/pull/1335).
- route53_health_check — внесено небольшое исправление для возврата сведений о проверке работоспособности при ее обновлении в Route53 (https://github.com/ansible-collections/amazon.aws/pull/1200).
- route53_health_check — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- route53_info — удалены неиспользуемые импорты (https://github.com/ansible-collections/amazon.aws/pull/1462).
- s3_bucket — добавлена поддержка конечной точки S3 dualstack (https://github.com/ansible-collections/amazon.aws/pull/1305).
- s3_bucket — при возможности более корректно обрабатывается отсутствие разрешений на чтение (https://github.com/ansible-collections/amazon.aws/pull/1406).
- s3_bucket — переработан код подключения к S3 (https://github.com/ansible-collections/amazon.aws/pull/1305).
- s3_object — переработан код подключения к S3 (https://github.com/ansible-collections/amazon.aws/pull/1305).
- s3_object — переработана основная функция для снижения сложности (https://github.com/ansible-collections/amazon.aws/pull/1193).
- s3_object_info — внесены незначительные исправления линтера (https://github.com/ansible-collections/amazon.aws/pull/1181).
- s3_object_info — переработан код подключения к S3 (https://github.com/ansible-collections/amazon.aws/pull/1305).
Несовместимые изменения / Руководство по переносу
- В коллекции amazon.aws прекращена поддержка
botocore<1.25.0иboto3<1.22.0. Большинство модулей продолжат работать со старыми версиями AWS SDK, однако совместимость со старыми версиями SDK не гарантируется и не будет тестироваться. При использовании старых версий SDK Ansible выдаст предупреждение (https://github.com/ansible-collections/amazon.aws/pull/1342). - amazon.aws — удален код совместимости с Python < 3.6 (https://github.com/ansible-collections/amazon.aws/pull/1257).
- ec2_eip — ранее объявленный устаревшим псевдоним
instance_idпараметраdevice_idудален. Вместо него используйте имя параметраdevice_id(https://github.com/ansible-collections/amazon.aws/issues/1176). - ec2_instance — значение по умолчанию для
instance_typeудалено. При запуске новых экземпляров необходимо указать хотя бы один из параметров:instance_typeилиlaunch_template(https://github.com/ansible-collections/amazon.aws/pull/1315). - ec2_vpc_dhcp_options — возвращаемое значение
new_optionsобъявлено устаревшим после переименования вdhcp_config. Используйте возвращаемые значенияdhcp_configилиdhcp_options(https://github.com/ansible-collections/amazon.aws/pull/1327). - ec2_vpc_endpoint — параметр
policy_fileудален. Вместо него можно использовать I(policy) с поиском по файлу (https://github.com/ansible-collections/amazon.aws/issues/1178). - ec2_vpc_net — возвращаемое значение
classic_link_enabledудалено. AWS прекратила поддержку сетей EC2 Classic (https://github.com/ansible-collections/amazon.aws/pull/1374). - ec2_vpc_net_info — возвращаемое значение
classic_link_dns_statusудалено. AWS прекратила поддержку сетей EC2 Classic (https://github.com/ansible-collections/amazon.aws/pull/1374). - ec2_vpc_net_info — возвращаемое значение
classic_link_enabledудалено. AWS прекратила поддержку сетей EC2 Classic (https://github.com/ansible-collections/amazon.aws/pull/1374). - module_utils.cloud — ранее объявленный устаревшим
CloudRetry.backoffудален. Вместо него используйтеCloudRetry.exponential_backoffилиCloudRetry.jittered_backoff(https://github.com/ansible-collections/amazon.aws/issues/1110).
Устаревшие функции
- Коллекция amazon.aws — с учетом политики поддержки Python в AWS SDK (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) ожидается, что поддержка этой коллекцией Python ниже версии 3.8 будет удалена в выпуске после 2024-12-01 (https://github.com/ansible-collections/amazon.aws/pull/1342).
- Коллекция amazon.aws — поскольку AWS SDK объявили о прекращении поддержки Python ниже версии 3.7 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/), поддержка этой коллекцией Python ниже версии 3.7 объявлена устаревшей и будет удалена в выпуске 7.0.0. (https://github.com/ansible-collections/amazon.aws/pull/1342).
- Плагины поиска amazon.aws — псевдоним
boto3_profileдля параметраprofileобъявлен устаревшим; вместо него используйтеprofile(https://github.com/ansible-collections/amazon.aws/pull/1225). - docs_fragments — фрагмент документации
amazon.aws.aws_credentialsобъявлен устаревшим; вместо него используйтеamazon.aws.common.plugins(https://github.com/ansible-collections/amazon.aws/pull/1248). - docs_fragments — фрагмент документации
amazon.aws.aws_regionобъявлен устаревшим; вместо него используйтеamazon.aws.region.plugins(https://github.com/ansible-collections/amazon.aws/pull/1248). - docs_fragments — фрагмент документации
amazon.aws.awsобъявлен устаревшим; вместо него используйтеamazon.aws.common.modules(https://github.com/ansible-collections/amazon.aws/pull/1248). - docs_fragments — фрагмент документации
amazon.aws.ec2объявлен устаревшим; вместо него используйтеamazon.aws.region.modules(https://github.com/ansible-collections/amazon.aws/pull/1248). - module_utils.policy —
ansible_collections.amazon.aws.module_utils.policy.sort_json_policy_dictобъявлен устаревшим; рекомендуется вместо него использоватьansible_collections.amazon.aws.module_utils.poilcies.compare_policies(https://github.com/ansible-collections/amazon.aws/pull/1136). - s3_object — поддержка одновременной передачи
dualstackиendpoint_urlобъявлена устаревшей; параметрdualstackигнорируется, если переданendpoint_url. Поддержка будет удалена в выпуске после 2024-12-01 (https://github.com/ansible-collections/amazon.aws/pull/1305). - s3_object — поддержка передачи значений
overwrite, отличных отalways,never,differentили последнегоlast, объявлена устаревшей. Логические значения следует заменить строкамиalwaysилиnever. Поддержка будет удалена в выпуске после 2024-12-01 (https://github.com/ansible-collections/amazon.aws/pull/1305). - s3_object_info — поддержка одновременной передачи
dualstackиendpoint_urlобъявлена устаревшей; параметрdualstackигнорируется, если переданendpoint_url. Поддержка будет удалена в выпуске после 2024-12-01 (https://github.com/ansible-collections/amazon.aws/pull/1305).
Удаленные функции (ранее объявленные устаревшими)
- ec2_vpc_endpoint_info — удалена поддержка параметра
query. Теперь модульamazon.aws.ec2_vpc_endpoint_infoвыполняет запросы только к конечным точкам. Запросы к сервисам можно выполнять с помощью модуляamazon.aws.ec2_vpc_endpoint_service_info(https://github.com/ansible-collections/amazon.aws/pull/1308). - s3_object — удалена поддержка создания и удаления бакетов с помощью модуля
s3_object. Бакеты S3 можно создавать и удалять с помощью модуляamazon.aws.s3_bucket(https://github.com/ansible-collections/amazon.aws/issues/1112).
Исправления ошибок
- ec2_security_group — файл содержал недостижимый код. Исправление удаляет недостижимый код, устраняя некорректную логику (https://github.com/ansible-collections/amazon.aws/pull/1348).
- ec2_vpc_dhcp_option — повторять
describe_dhcp_optionsпосле создания, если возникаетInvalidDhcpOptionID.NotFound(https://github.com/ansible-collections/amazon.aws/pull/1320). - lambda_execute — исправлена ошибка ожидания, возникавшая при передаче function_arn вместо name (https://github.com/ansible-collections/amazon.aws/issues/1268).
- module_utils — исправлена ошибка
TypeError: deciding_wrapper() got multiple values for argument 'aws_retry'при передаче позиционных аргументов функциям, обёрнутым AnsibleAWSModule.client (https://github.com/ansible-collections/amazon.aws/pull/1230). - rds_param_group — добавлена проверка для завершения задачи с ошибкой при изменении/обновлении rds_param_group в случае попытки изменить семейство группы параметров БД. (https://github.com/ansible-collections/amazon.aws/pull/1169).
- route53_health_check — исправлена проблема с идемпотентностью удаления ключа тега
Nameпри создании health_check с заданнымиuse_unique_namesиtags(https://github.com/ansible-collections/amazon.aws/pull/1253). - s3_bucket — обработана настройка разрешений при отключённом ACL. (https://github.com/ansible-collections/amazon.aws/pull/1168).
Новые плагины
Поиск
- aws_collection_constants — предоставляет различные константы, связанные с коллекцией
Новые модули
- backup_plan — управление планами AWS Backup
- backup_plan_info — описание планов AWS Backup
- backup_restore_job_info — список сведений о заданиях восстановления из резервных копий
- backup_selection — создание, удаление и изменение выбора AWS Backup
- backup_selection_info — описание выборок AWS Backup
- backup_tag — управление тегами плана резервного копирования, хранилища резервных копий и точки восстановления
- backup_tag_info — список тегов ресурсов AWS Backup
- backup_vault — управление хранилищами AWS Backup
- backup_vault_info — описание хранилищ AWS Backup
v5.5.3
Итоги выпуска
В этом выпуске исправлено несколько ошибок в rds_cluster.
Исправления ошибок
- rds_cluster — в список параметров, которые можно передать при создании или изменении кластера RDS Multi-AZ, добавлены
AllocatedStorage,DBClusterInstanceClass,StorageType,IopsиEngineMode(https://github.com/ansible-collections/amazon.aws/pull/1657). - rds_cluster — разрешена передача GlobalClusterIdentifier кластеру RDS при создании (https://github.com/ansible-collections/amazon.aws/pull/1663).
v5.5.2
Исправления ошибок
- cloudwatchevent_rule — исправлено значение статуса changed: теперь оно равно False, если изменений не было. Ранее модуль ошибочно всегда сообщал об изменениях. (https://github.com/ansible-collections/amazon.aws/pull/1589)
- ec2_vpc_nat_gateway — исправлено поведение шлюза NAT: при создании частного шлюза NAT пользователем эластичный IP-адрес не должен выделяться. Ранее модуль ошибочно всегда выделял эластичный IP-адрес при создании частного шлюза NAT (https://github.com/ansible-collections/amazon.aws/pull/1632).
- lambda_execute — исправлен вывод трассировки стека: между символами больше не пропадают пробелы. Ранее модуль ошибочно добавлял лишние пробелы между символами. (https://github.com/ansible-collections/amazon.aws/pull/1615)
v5.5.1
Итоги выпуска
В этом выпуске исправлено несколько ошибок.
Исправления ошибок
- autoscaling_group — исправлена ошибка ValidationError при описании группы автомасштабирования, к которой подключено более 20 целевых групп: запрос разбивается на части (https://github.com/ansible-collections/amazon.aws/pull/1593).
- autoscaling_group_info — исправлена ошибка ValidationError при описании группы автомасштабирования, к которой подключено более 20 целевых групп: запрос разбивается на части (https://github.com/ansible-collections/amazon.aws/pull/1593).
- aws_account_attribute — теперь вызывается правильное
AnsibleLookupErrorвместоAnsibleError(https://github.com/ansible-collections/amazon.aws/issues/1528). - aws_secret — теперь вызывается правильное
AnsibleLookupErrorвместоAnsibleError(https://github.com/ansible-collections/amazon.aws/issues/1528). - aws_service_ip_ranges — теперь вызывается правильное
AnsibleLookupErrorвместоAnsibleError(https://github.com/ansible-collections/amazon.aws/issues/1528). - aws_ssm — теперь вызывается правильное
AnsibleLookupErrorвместоAnsibleError(https://github.com/ansible-collections/amazon.aws/issues/1528). - ec2_instance — исправлена проблема с check_mode при добавлении сетевых интерфейсов (https://github.com/ansible-collections/amazon.aws/issues/1403).
- elb_application_lb — исправлено отсутствие атрибутов при создании ALB.
create_or_update_alb()включал атрибуты, специфичные для ALB, при обновлении существующего ALB, но не при создании нового ALB (https://github.com/ansible-collections/amazon.aws/issues/1510).
v5.5.0
Итоги выпуска
В этом выпуске исправлен ряд ошибок, добавлены новые функции и модули. Это последний запланированный минорный выпуск перед выходом версии 6.0.0.
Незначительные изменения
- Добавлен connectivity_type в модуль ec2_vpc_nat_gateway (https://github.com/ansible-collections/amazon.aws/pull/1267).
- cloudwatch — в модуль cloudwatch добавлены ключи metrics и extended_statistic (https://github.com/ansible-collections/amazon.aws/pull/1133).
- ec2_ami — добавлена поддержка параметров BootMode, TpmSupport и UefiData (https://github.com/ansible-collections/amazon.aws/pull/1037).
- ec2_metadata_facts — добавлена поддержка получения тегов экземпляра из метаданных (https://github.com/ansible-collections/amazon.aws/pull/1186).
- kms_key — добавлен параметр multi_region для create_key (https://github.com/ansible-collections/amazon.aws/pull/1290).
- lambda — добавлена поддержка слоёв функций при создании или обновлении функции Lambda (https://github.com/ansible-collections/amazon.aws/pull/1118).
- lambda_event — добавлена поддержка задания FunctionResponseTypes при создании сопоставлений источников событий Lambda (https://github.com/ansible-collections/amazon.aws/pull/1209).
- module_utils/elbv2 — удалён код совместимости для
botocore < 1.10.30(https://github.com/ansible-collections/amazon.aws/pull/1477). - rds_cluster — добавлен новый параметр
engine_mode(https://github.com/ansible-collections/amazon.aws/pull/941). - rds_cluster — добавлены новые параметры (например,
db_cluster_instance_class,allocated_storage,storage_type,iops) (https://github.com/ansible-collections/amazon.aws/pull/1191). - rds_cluster — список поддерживаемых движков дополнен
mysqlиpostgres(https://github.com/ansible-collections/amazon.aws/pull/1191). - s3_bucket — обеспечена настройка
public_accessперед обновлением политик (https://github.com/ansible-collections/amazon.aws/pull/1511).
Исправления ошибок
- cloudwatch_metric_alarm — при обнаружении изменений больше не учитывается
StateTransitionedTimestamp. (https://github.com/ansible-collections/amazon.aws/pull/1440). - ec2_instance — используется
app_callback -> set_passwordвместоapp_callback -> set_passwd(https://github.com/ansible-collections/amazon.aws/issues/1449). - lambda_info — переменные среды больше не преобразуются в snake_case при запросе конфигурации Lambda. (https://github.com/ansible-collections/amazon.aws/pull/1457).
- rds_instance — исправлен тип
promotion_tier, передаваемого API (https://github.com/ansible-collections/amazon.aws/pull/1475).
Новые модули
- lambda_layer — создание слоя AWS Lambda или удаление версии слоя AWS Lambda
- lambda_layer_info — список слоёв Lambda или их версий
v5.4.0
Итоги выпуска
Этот минорный выпуск содержит исправления ошибок и небольшие новые функции.
Незначительные изменения
- ec2_spot_instance — добавлен параметр
terminate_instancesдля поддержки завершения экземпляров, связанных с запросами Spot. (https://github.com/ansible-collections/amazon.aws/pull/1402). - route53_health_check — добавлена поддержка включения графиков задержки (MeasureLatency) при создании проверки работоспособности Route53. (https://github.com/ansible-collections/amazon.aws/pull/1201).
Исправления ошибок
- ec2_metadata_facts — исправлена ошибка
AttributeErrorпри запуске модуля ec2_metadata_facts на управляемых узлах под управлением Python 2 (https://github.com/ansible-collections/amazon.aws/issues/1358). - ec2_vol — обработан ec2_vol.tags, если связанный экземпляр уже существует (https://github.com/ansible-collections/amazon.aws/pull/1071).
- rds_instance — исправлена ошибка
TypeErrorпри добавлении тегов к базе данных RDS с типом хранилищаgp3(https://github.com/ansible-collections/amazon.aws/pull/1437). - route53_info — добавлен новый ключ результата
health_check_observationsдля операций проверки работоспособности (https://github.com/ansible-collections/amazon.aws/pull/1419). - route53_info — исправлена ошибка
Key Errorпри получении статуса или failure_reason проверки работоспособности (https://github.com/ansible-collections/amazon.aws/pull/1419).
v5.3.0
Итоги выпуска
В этом выпуске представлены некоторые незначительные изменения, исправления ошибок и устаревшие функции.
Незначительные изменения
- ec2_instance — более последовательно возвращает сведения
instances(https://github.com/ansible-collections/amazon.aws/pull/964). - ec2_instance — удалён неиспользуемый импорт (https://github.com/ansible-collections/amazon.aws/pull/1350).
- ec2_key — добавлено покрытие модульными тестами (https://github.com/ansible-collections/amazon.aws/pull/1288).
- ec2_vpc_nat_gateway — обеспечена проверка определения allocation_id перед возможным обращением к нему (https://github.com/ansible-collections/amazon.aws/pull/1350).
- route53_zone — добавлена поддержка связывания нескольких VPC с размещёнными зонами Route53 (https://github.com/ansible-collections/amazon.aws/pull/1300).
- s3_bucket — добавлен параметр для поддержки создания бакетов с включённой блокировкой объектов (https://github.com/ansible-collections/amazon.aws/pull/1372).
Устаревшие функции
- Использование профиля и токенов безопасности одновременно через сочетание переменных среды и параметров объявлено устаревшим; поддержка будет удалена в выпуске 6.0.0. Начиная с выпуска 6.0.0 можно будет передавать только профиль либо токены безопасности независимо от способа их передачи. Чтобы явно запретить получение параметра из переменной среды, передайте в качестве значения параметра пустую строку. Использование профиля и токенов безопасности одновременно было объявлено устаревшим ещё в выпуске 1.2.0, однако в выпуске 5.0.0 это было реализовано лишь частично (https://github.com/ansible-collections/amazon.aws/pull/1355).
Исправления ошибок
- cloudtrail — добавлена поддержка отключения шифрования с помощью
kms_key_id(https://github.com/ansible-collections/amazon.aws/pull/1384). - ec2_key — исправлена проблема при попытке обновить существующую пару ключей тем же материалом ключа (https://github.com/ansible-collections/amazon.aws/pull/1383).
- module_utils/elbv2 — исправлено обнаружение изменений: для параметров
ScopeиSessionTimeoutв правилахauthenticate-oidcдобавлены значения по умолчанию (https://github.com/ansible-collections/amazon.aws/pull/1270). - module_utils/elbv2 — при обработке правил
authenticate-oidcучитывается параметрUseExistingClientSecret(https://github.com/ansible-collections/amazon.aws/pull/1270). - отменено несовместимое изменение, внесённое в версии 5.2.0 при передаче учётных данных через сочетание переменных среды и параметров (https://github.com/ansible-collections/amazon.aws/issues/1353).
- s3_bucket — пустая политика бакета приводила к ошибке JSONDecodeError; теперь эта ситуация обрабатывается корректно (https://github.com/ansible-collections/amazon.aws/pull/1368)
v5.2.0
Итоги выпуска
Минорный выпуск, содержащий исправления ошибок для модуля ec2_eni_info и плагина инвентаризации aws_rds, а также улучшения модуля rds_instance.
Незначительные изменения
- коллекция amazon.aws — переработан код для использования спецификации аргументов
fallbackпри обращении к переменным среды в качестве запасного источника учётных данных безопасности и сведений о подключении AWS (https://github.com/ansible-collections/amazon.aws/pull/1174). - rds_instance — набор интеграционных тестов разбит на несколько небольших тестов (https://github.com/ansible-collections/amazon.aws/pull/1185).
- rds_instance — добавлена поддержка типа хранилища gp3 (https://github.com/ansible-collections/amazon.aws/pull/1266).
Исправления ошибок
- aws_rds — исправлена ошибка плагина инвентаризации RDS, из-за которой игнорировался файл конфигурации (https://github.com/ansible-collections/amazon.aws/issues/1304).
- lambda — исправлен нестабильный интеграционный тест, который предполагал, что в учётной записи нет других функций Lambda (https://github.com/ansible-collections/amazon.aws/issues/1277)
v5.1.0
Сводка выпуска
В этом выпуске представлены некоторые небольшие изменения, исправления ошибок, исправления безопасности и устаревшие функции.
Небольшие изменения
- Коллекция amazon.aws — параметр
aws_access_keyпереименован вaccess_key,access_keyранее был псевдонимом этого параметра, аaws_access_keyостаётся псевдонимом. Это изменение не должно быть заметно пользователям за пределами документации модулей и плагинов. (https://github.com/ansible-collections/amazon.aws/pull/1172). - Коллекция amazon.aws — параметр
aws_secret_keyпереименован вsecret_key,secret_keyранее был псевдонимом этого параметра, аaws_secret_keyостаётся псевдонимом. Это изменение не должно быть заметно пользователям за пределами документации модулей и плагинов. (https://github.com/ansible-collections/amazon.aws/pull/1172). - Коллекция amazon.aws — параметр
security_tokenпереименован вsession_token,security_tokenранее был псевдонимом этого параметра, аsecurity_tokenостаётся псевдонимом. Это изменение не должно быть заметно пользователям за пределами документации модулей и плагинов. (https://github.com/ansible-collections/amazon.aws/pull/1172). - Плагин поиска aws_account_attribute — используется
missing_required_libдля более согласованного сообщения об ошибке, если boto3/botocore недоступен (https://github.com/ansible-collections/amazon.aws/pull/1152). - Инвентаризация aws_ec2 — небольшие исправления линтинга (https://github.com/ansible-collections/amazon.aws/pull/1181).
- Плагин инвентаризации aws_ec2 — используется
missing_required_libдля более согласованного сообщения об ошибке, если boto3/botocore недоступен (https://github.com/ansible-collections/amazon.aws/pull/1152). - Плагин инвентаризации aws_rds — используется
missing_required_libдля более согласованного сообщения об ошибке, если boto3/botocore недоступен (https://github.com/ansible-collections/amazon.aws/pull/1152). - Плагин поиска aws_secret — используется
missing_required_libдля более согласованного сообщения об ошибке, если boto3/botocore недоступен (https://github.com/ansible-collections/amazon.aws/pull/1152). - Плагин поиска aws_ssm — используется
missing_required_libдля более согласованного сообщения об ошибке, если boto3/botocore недоступен (https://github.com/ansible-collections/amazon.aws/pull/1152). - ec2_instance — небольшое исправление для запуска экземпляра в указанной зоне доступности, если
vpc_subnet_idне задан (https://github.com/ansible-collections/amazon.aws/pull/1150). - ec2_instance — переработан код
tower_callback, чтобы проверка параметров выполнялась в рамках спецификации аргументов (https://github.com/ansible-collections/amazon.aws/pull/1199). - ec2_instance — параметр
instance_roleпереименован вiam_instance_profile, чтобы точнее отражать его назначение;instance_roleостаётся псевдонимом (https://github.com/ansible-collections/amazon.aws/pull/1151). - ec2_instance — параметр
tower_callbackпереименован вaap_callback,tower_callbackостаётся псевдонимом. Это изменение не должно быть заметно пользователям за пределами документации модуля (https://github.com/ansible-collections/amazon.aws/pull/1199). - s3_object_info — небольшие исправления линтинга (https://github.com/ansible-collections/amazon.aws/pull/1181).
Устаревшие функции
- Коллекция amazon.aws — поддержка переменной среды
EC2_ACCESS_KEYобъявлена устаревшей и будет удалена в одном из выпусков после 2024-12-01. Вместо неё используйте параметрaccess_keyили переменную средыAWS_ACCESS_KEY_ID(https://github.com/ansible-collections/amazon.aws/pull/1172). - Коллекция amazon.aws — поддержка переменной среды
EC2_REGIONобъявлена устаревшей и будет удалена в одном из выпусков после 2024-12-01. Вместо неё используйте параметрregionили переменную средыAWS_REGION(https://github.com/ansible-collections/amazon.aws/pull/1172). - Коллекция amazon.aws — поддержка переменной среды
EC2_SECRET_KEYобъявлена устаревшей и будет удалена в одном из выпусков после 2024-12-01. Вместо неё используйте параметрsecret_keyили переменную средыAWS_SECRET_ACCESS_KEY(https://github.com/ansible-collections/amazon.aws/pull/1172). - Коллекция amazon.aws — поддержка переменной среды
EC2_SECURITY_TOKENобъявлена устаревшей и будет удалена в одном из выпусков после 2024-12-01. Вместо неё используйте параметрsession_tokenили переменную средыAWS_SESSION_TOKEN(https://github.com/ansible-collections/amazon.aws/pull/1172). - Коллекция amazon.aws — поддержка переменных среды
EC2_URLиS3_URLобъявлена устаревшей и будет удалена в одном из выпусков после 2024-12-01. Вместо них используйте параметрendpoint_urlили переменную средыAWS_ENDPOINT_URL(https://github.com/ansible-collections/amazon.aws/pull/1172). - Коллекция amazon.aws — псевдоним
access_tokenпараметраsession_tokenобъявлен устаревшим и будет удалён в одном из выпусков после 2024-12-01. Вместо него используйте имяsession_token(https://github.com/ansible-collections/amazon.aws/pull/1172). - Коллекция amazon.aws — псевдоним
access_tokenпараметраsession_tokenобъявлен устаревшим и будет удалён в одном из выпусков после 2024-12-01. Вместо него используйте имяsession_token(https://github.com/ansible-collections/amazon.aws/pull/1172). - Коллекция amazon.aws — псевдоним
aws_security_tokenпараметраsession_tokenобъявлен устаревшим и будет удалён в одном из выпусков после 2024-12-01. Вместо него используйте имяsession_token(https://github.com/ansible-collections/amazon.aws/pull/1172). - Коллекция amazon.aws — псевдоним
ec2_access_keyпараметраaccess_keyобъявлен устаревшим и будет удалён в одном из выпусков после 2024-12-01. Вместо него используйте имяaccess_key(https://github.com/ansible-collections/amazon.aws/pull/1172). - Коллекция amazon.aws — псевдоним
ec2_regionпараметраregionобъявлен устаревшим и будет удалён в одном из выпусков после 2024-12-01. Вместо него используйте имяregion(https://github.com/ansible-collections/amazon.aws/pull/1172). - Коллекция amazon.aws — псевдоним
ec2_secret_keyпараметраsecret_keyобъявлен устаревшим и будет удалён в одном из выпусков после 2024-12-01. Вместо него используйте имяsecret_key(https://github.com/ansible-collections/amazon.aws/pull/1172). - Коллекция amazon.aws — псевдоним
security_tokenпараметраsession_tokenобъявлен устаревшим и будет удалён в одном из выпусков после 2024-12-01. Вместо него используйте имяsession_token(https://github.com/ansible-collections/amazon.aws/pull/1172). - ec2_security_group — поддержка передачи вложенных списков в
cidr_ipиcidr_ipv6объявлена устаревшей. Вложенные списки можно передавать через фильтрflattenвместоcidr_ip: '{{ my_cidrs | flatten }}'(https://github.com/ansible-collections/amazon.aws/pull/1213). - module_utils.url —
ansible_collections.amazon.aws.module_utils.urls, предположительно неиспользуемый, объявлен устаревшим и будет удалён в выпуске 7.0.0.
Исправления безопасности
- ec2_instance — устранена утечка пароля в журналы при использовании
tower_callback.windows=Trueиtower_callback.set_password(https://github.com/ansible-collections/amazon.aws/pull/1199).
Исправления ошибок
- ec2_instance — исправлена ошибка
Invalid type for parameter TagSpecifications, value None, возникавшая, если теги не указаны (https://github.com/ansible-collections/amazon.aws/issues/1148). - module_utils.transformations — обеспечено, что
map_complex_typeпо-прежнему возвращает преобразованные элементы, если имеются элементы, отсутствующие в type_map (https://github.com/ansible-collections/amazon.aws/pull/1163).
v5.0.2
Исправления ошибок
- ec2_metadata_facts — исправлена ошибка
AttributeError(https://github.com/ansible-collections/amazon.aws/issues/1134).
v5.0.1
Исправления ошибок
- ec2_vpc_net_info — исправлена ошибка KeyError (https://github.com/ansible-collections/amazon.aws/pull/1109).
- ec2_vpc_net_info — удалён жёстко заданный параметр
ClassicLinkEnabledв случае сбоя запросаClassicLinkDnsSupported(https://github.com/ansible-collections/amazon.aws/pull/1109). - s3_object — повышена надёжность проверки результатов
s3.get_bucket_ownership_controls(https://github.com/ansible-collections/amazon.aws/issues/1115).
v5.0.0
Сводка выпуска
В этом выпуске многие модули сообщества получили статус поддержки Red Hat. Эти модули перенесены из коллекции commuity.aws в коллекцию amazon.aws. В выпуск также вошли новые функции, исправления ошибок, несовместимые изменения и устаревшие функции. В коллекции amazon.aws прекращена поддержка botocore<1.21.0 и boto3<1.18.0. Также прекращена поддержка ansible-core<2.11.
Основные изменения
- autoscaling_group — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.autoscaling_group. - autoscaling_group_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.autoscaling_group_info. - cloudtrail — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.cloudtrail. - cloudwatch_metric_alarm — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.cloudwatch_metric_alarm. - cloudwatchevent_rule — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.cloudwatchevent_rule. - cloudwatchlogs_log_group — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.cloudwatchlogs_log_group. - cloudwatchlogs_log_group_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.cloudwatchlogs_log_group_info. - cloudwatchlogs_log_group_metric_filter — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.cloudwatchlogs_log_group_metric_filter. - ec2_eip — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_eip. - ec2_eip_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_eip_info. - elb_application_lb — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.elb_application_lb. - elb_application_lb_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.elb_application_lb_info. - execute_lambda — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.execute_lambda. - iam_policy — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.iam_policy. - iam_policy_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.iam_policy_info. - iam_user — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.iam_user. - iam_user_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.iam_user_info. - kms_key — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.kms_key. - kms_key_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.kms_key_info. - lambda — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.lambda. - lambda_alias — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.lambda_alias. - lambda_event — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.lambda_event. - lambda_execute — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.lambda_execute. - lambda_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.lambda_info. - lambda_policy — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.lambda_policy. - rds_cluster — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.rds_cluster. - rds_cluster_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.rds_cluster_info. - rds_cluster_snapshot — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.rds_cluster_snapshot. - rds_instance — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.rds_instance. - rds_instance_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.rds_instance_info. - rds_instance_snapshot — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.rds_instance_snapshot. - rds_option_group — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.rds_option_group. - rds_option_group_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.rds_option_group_info. - rds_param_group — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.rds_param_group. - rds_snapshot_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.rds_snapshot_info. - rds_subnet_group — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.rds_subnet_group. - route53 — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.route53. - route53_health_check — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.route53_health_check. - route53_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.route53_info. - route53_zone — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.route53_zone.
Незначительные изменения
- Добавлена возможность записывать и воспроизводить взаимодействие модуля с API для тестирования. Эта функция показана на примере (https://github.com/ansible-collections/amazon.aws/pull/998).
- Из дистрибутива удалён пустой файл __init__.py, поскольку он больше не требовался (https://github.com/ansible-collections/amazon.aws/pull/1018).
- Модули amazon.aws — для единообразия параметр
ec2_urlпереименован вendpoint_url,ec2_urlсохранён как псевдоним (https://github.com/ansible-collections/amazon.aws/pull/992). - aws_caller_info — небольшие исправления линтинга (https://github.com/ansible-collections/amazon.aws/pull/968).
- aws_ec2 — добавлен ключ конфигурации
allow_duplicated_hosts(https://github.com/ansible-collections/amazon.aws/pull/1026). - cloudformation — вместо перехвата
Exceptionтеперь перехватываются более конкретные ошибки (https://github.com/ansible-collections/amazon.aws/pull/968). - cloudwatch_metric_alarm_info — добавлен новый модуль для получения описаний сигналов тревоги метрик CloudWatch (https://github.com/ansible-collections/amazon.aws/pull/988).
- ec2_group — модуль
ec2_groupпереименован вec2_security_group,ec2_groupсохранён как псевдоним (https://github.com/ansible-collections/amazon.aws/pull/897). - ec2_group_info — модуль
ec2_group_infoпереименован вec2_security_group_info,ec2_group_infoсохранён как псевдоним (https://github.com/ansible-collections/amazon.aws/pull/897). - ec2_instance — добавлены ключи hibernation_options и volumes->ebs->encrypted для поддержки остановки и гибернации экземпляра (https://github.com/ansible-collections/amazon.aws/pull/972).
- ec2_instance — расширено применение автоматических повторных попыток для
InsuffienctInstanceCapacity(https://github.com/ansible-collections/amazon.aws/issues/1038). - ec2_metadata_facts — вместо перехвата
Exceptionтеперь перехватываются более конкретные ошибки (https://github.com/ansible-collections/amazon.aws/pull/968). - ec2_security_group — небольшие исправления линтинга (https://github.com/ansible-collections/amazon.aws/pull/968).
- ec2_vpc_endpoint — вместо перехвата
Exceptionтеперь перехватываются более конкретные ошибки (https://github.com/ansible-collections/amazon.aws/pull/968). - ec2_vpc_nat_gateway — небольшие исправления линтинга (https://github.com/ansible-collections/amazon.aws/pull/968).
- ec2_vpc_net_info — проверка классической связи для общих VPC теперь приводит к предупреждению, а не к ошибке (https://github.com/ansible-collections/amazon.aws/pull/984).
- module_utils/acm — добавлен экспоненциальный откат со случайным разбросом (https://github.com/ansible-collections/amazon.aws/pull/946).
- module_utils/elbv2 — теперь
ip_address_typeзадаётся при создании, а не устанавливается повторно после создания (https://github.com/ansible-collections/amazon.aws/pull/940). - module_utils/elbv2 — используются новые средства ожидания с повторными попытками при временных сбоях (https://github.com/ansible-collections/amazon.aws/pull/940).
- module_utils/waf — добавлен экспоненциальный откат со случайным разбросом (https://github.com/ansible-collections/amazon.aws/pull/946).
- module_utils/waiters — добавлены средства ожидания для управления модулем eks_nodegroup (https://github.com/ansible-collections/community.aws/pull/1415).
- s3_bucket —
rgwдобавлен как псевдоним параметраcephдля единообразия с модулемs3_object(https://github.com/ansible-collections/amazon.aws/pull/994). - s3_bucket — параметр
s3_urlобъединён с параметромendpoint_url,s3_urlсохранён как псевдоним (https://github.com/ansible-collections/amazon.aws/pull/994). - s3_object — добавлен параметр
sig_v4, позволяющий пользователю включить версию подписи 4 для операций download/get. (https://github.com/ansible-collections/amazon.aws/pull/1014) - s3_object — небольшие исправления линтинга (https://github.com/ansible-collections/amazon.aws/pull/968).
- s3_object — для единообразия с модулем
s3_bucketпараметрrgwпереименован вceph,rgwсохранён как псевдоним (https://github.com/ansible-collections/amazon.aws/pull/994). - s3_object — параметр
s3_urlобъединён с параметромendpoint_url,s3_urlсохранён как псевдоним (https://github.com/ansible-collections/amazon.aws/pull/994). - s3_object — модуль обновлён для поддержки загрузки файлов в бакет с отключённым ACL (https://github.com/ansible-collections/amazon.aws/pull/921).
- s3_object_info — добавлен новый модуль для получения описаний объектов S3 (https://github.com/ansible-collections/amazon.aws/pull/977).
Несовместимые изменения / руководство по переносу
- Коллекция amazon.aws — прекращена поддержка ansible-core < 2.11 (https://github.com/ansible-collections/amazon.aws/pull/1087).
- Коллекция amazon.aws — прекращена поддержка
botocore<1.21.0иboto3<1.18.0. Большинство модулей продолжат работать со старыми версиями AWS SDK, однако совместимость со старыми версиями SDK не гарантируется и не будет проверяться. При использовании старых версий SDK Ansible выдаст предупреждение (https://github.com/ansible-collections/amazon.aws/pull/934). - doc_fragments — из doc_fragments/aws.py удалено требование к минимальной версии коллекции; теперь эти данные можно получать из doc_fragments/aws_boto3.py (https://github.com/ansible-collections/amazon.aws/pull/985).
- ec2_ami — значение параметра
purge_tagsпо умолчанию изменено сFalseнаTrue(https://github.com/ansible-collections/amazon.aws/pull/916). - ec2_ami — ранее объявленные устаревшими псевдонимы параметров
DeviceName,VirtualNameиNoDeviceудалены. Вместо них используйтеdevice_name,virtual_nameиno_device(https://github.com/ansible-collections/amazon.aws/pull/913). - ec2_eni_info — теперь обеспечивается взаимоисключение параметров
eni_idиfilters. Ранееfiltersигнорировался, если был заданeni_id(https://github.com/ansible-collections/amazon.aws/pull/954). - ec2_instance — значение параметра
purge_tagsпо умолчанию изменено сFalseнаTrue(https://github.com/ansible-collections/amazon.aws/pull/916). - ec2_key — значение параметра
purge_tagsпо умолчанию изменено сFalseнаTrue(https://github.com/ansible-collections/amazon.aws/pull/916). - ec2_vol — значение параметра
purge_tagsпо умолчанию изменено сFalseнаTrue(https://github.com/ansible-collections/amazon.aws/pull/916). - ec2_vpc_dhcp_option_info — ранее объявленные устаревшими псевдонимы параметров
DhcpOptionIdsиDryRunудалены. Вместо них используйтеdhcp_options_idsиno_device(https://github.com/ansible-collections/amazon.aws/pull/913). - ec2_vpc_endpoint — значение параметра
purge_tagsпо умолчанию изменено сFalseнаTrue(https://github.com/ansible-collections/amazon.aws/pull/916). - ec2_vpc_net — значение параметра
purge_tagsпо умолчанию изменено сFalseнаTrue(https://github.com/ansible-collections/amazon.aws/pull/916). - ec2_vpc_route_table — значение параметра
purge_tagsпо умолчанию изменено сFalseнаTrue(https://github.com/ansible-collections/amazon.aws/pull/916). - s3_bucket — удалён ранее объявленный устаревшим псевдоним
S3_URLпараметраs3_url. Обновите плейбуки и используйтеs3_url(https://github.com/ansible-collections/amazon.aws/pull/908). - s3_object — удалён ранее объявленный устаревшим псевдоним
S3_URLпараметраs3_url. Обновите плейбуки и используйтеs3_url(https://github.com/ansible-collections/amazon.aws/pull/908).
Устаревшие функции
- Коллекция amazon.aws — в связи с объявлением AWS SDK о прекращении поддержки Python версий ниже 3.7 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) поддержка Python версий ниже 3.7 в этой коллекции объявлена устаревшей и будет удалена в выпуске после 2023-05-31 (https://github.com/ansible-collections/amazon.aws/pull/935).
- inventory/aws_ec2 — параметр
include_extra_api_callsобъявлен устаревшим; его значение игнорируется без уведомления (https://github.com/ansible-collections/amazon.aws/pull/1097).
Исправления ошибок
- aws_ec2 — устранена регрессия, появившаяся в версии 4.1.0 (https://github.com/ansible-collections/amazon.aws/pull/862) и приводившая к появлению дублирующихся узлов в инвентаре.
- cloudtrail — исправлена ошибка ключа: TagList заменён на TagsList (https://github.com/ansible-collections/amazon.aws/issues/1088).
- ec2_instance — предупреждение об устаревшем значении по умолчанию для
instance_typeтеперь отображается только при указанииcountилиexact_count(https://github.com//issues/980). - ec2_metadata_facts — исправлено исключение
'NoneType' object is not callableпри использовании Ansible 2.13+ (https://github.com/ansible-collections/amazon.aws/issues/942). - module_utils/botocore — исправлена ошибка
object has no attribute 'fail'при обработке ошибок (https://github.com/ansible-collections/amazon.aws/pull/1045). - module_utils/elbv2 — исправлена проблема
KeyErrorпри использованииUseExistingClientSecretвместоClientSecret(https://github.com/ansible-collections/amazon.aws/pull/940). - module_utils/elbv2 — улучшена идемпотентность при сравнении прослушивателей (https://github.com/ansible-collections/community.aws/issues/604).
- s3_object — при составлении списка объектов бакета также используется
ignore_nonexistent_bucket(https://github.com/ansible-collections/amazon.aws/issues/966).
Новые модули
- cloudtrail_info — сбор сведений о журналах трассировки в AWS CloudTrail.
- cloudwatch_metric_alarm_info — сбор сведений о сигналах тревоги для указанной метрики
- s3_object_info — сбор сведений об объектах в S3
v4.5.0
Сводка выпуска
Этот выпуск содержит небольшое исправление ошибки в модуле ec2_vol, незначительные изменения модуля ec2_key и различные исправления документации. Это последний запланированный выпуск серии 4.x.
Незначительные изменения
- ec2_key — небольшой рефакторинг и улучшенное покрытие модульными тестами (https://github.com/ansible-collections/amazon.aws/pull/1288).
Исправления ошибок
- ec2_vol — обработка ec2_vol.tags, когда связанный экземпляр уже существует (https://github.com/ansible-collections/amazon.aws/pull/1071).
v4.4.0
Сводка выпуска
Выпуск amazon.aws 4.4.0 содержит несколько исправлений безопасности и незначительных ошибок.
Незначительные изменения
- ec2_instance — рефакторинг кода
tower_callbackдля проверки параметров в составе спецификации аргументов (https://github.com/ansible-collections/amazon.aws/pull/1199). - ec2_instance — параметр
tower_callbackпереименован вaap_callback,tower_callbackсохранён как псевдоним. Это изменение не должно быть заметно пользователям, за исключением документации модуля (https://github.com/ansible-collections/amazon.aws/pull/1199).
Исправления безопасности
- ec2_instance — устранена утечка пароля в журналы при использовании
tower_callback.windows=Trueиtower_callback.set_password(https://github.com/ansible-collections/amazon.aws/pull/1199).
v4.3.0
Сводка выпуска
Выпуск amazon.aws 4.3.0 содержит ряд незначительных исправлений ошибок и улучшений. После выхода amazon.aws 5.0.0 обратные переносы в серию 4.x будут ограничены исправлениями безопасности и ошибок.
Незначительные изменения
- ec2_instance — расширено применение автоматических повторных попыток для
InsuffienctInstanceCapacity(https://github.com/ansible-collections/amazon.aws/issues/1038).
Исправления ошибок
- ec2_metadata_facts — исправлено исключение
'NoneType' object is not callableпри использовании Ansible 2.13+ (https://github.com/ansible-collections/amazon.aws/issues/942). - module_utils/cloud — исправлена ошибка
ValueError: ansible_collections.amazon.aws.plugins.module_utils.core.__spec__ is Noneв Ansible 2.9 (https://github.com/ansible-collections/amazon.aws/issues/1083).
v4.2.0
Незначительные изменения
- ec2_security_group — для rules->group_name указан тип
list, поскольку этот параметр может принимать иstr, иlist(https://github.com/ansible-collections/amazon.aws/pull/971). - Различные модули — исправления линтинга (https://github.com/ansible-collections/amazon.aws/pull/953).
Устаревшие функции
- module_utils.cloud — удаление
CloudRetry.backoffотложено до выпуска 6.0.0. Рекомендуется обновить пользовательские модули и использовать вместо негоjittered_backoffилиexponential_backoff(https://github.com/ansible-collections/amazon.aws/pull/951).
v4.1.0
Незначительные изменения
- ec2_instance — расширено использование автоматических повторных попыток при временных сбоях (https://github.com/ansible-collections/amazon.aws/issues/927).
- s3_bucket — обновлен модуль для поддержки настройки ключей корзины S3 для SSE-KMS (https://github.com/ansible-collections/amazon.aws/pull/882).
Устаревшие функции
- коллекция amazon.aws — в связи с объявлением AWS SDK о прекращении поддержки Python ниже версии 3.7 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) поддержка Python ниже версии 3.7 в этой коллекции объявлена устаревшей и будет удалена в выпуске после 2023-05-31 (https://github.com/ansible-collections/amazon.aws/pull/935).
Исправления ошибок
- aws_ec2 — обеспечен возврат правильного количества хостов при использовании тегов в качестве имен хостов (https://github.com/ansible-collections/amazon.aws/pull/862).
- elb_application_lb — исправлен
KeyErrorпри распределении нагрузки между двумя целевыми группами (https://github.com/ansible-collections/community.aws/issues/1089). - elb_classic_lb — исправлена ошибка
'NoneType' object has no attributeпри создании нового ELB в режиме проверки с проверкой работоспособности (https://github.com/ansible-collections/amazon.aws/pull/915). - elb_classic_lb — исправлена ошибка
'NoneType' object has no attributeпри создании нового ELB с использованием имен групп безопасности (https://github.com/ansible-collections/amazon.aws/issues/914).
v4.0.0
Крупные изменения
- коллекция amazon.aws — коллекция amazon.aws прекратила поддержку
botocore<1.20.0иboto3<1.17.0. Большинство модулей продолжат работать со старыми версиями AWS SDK, однако совместимость со старыми версиями SDK не гарантируется и не будет проверяться. При использовании старых версий SDK Ansible будет выводить предупреждение (https://github.com/ansible-collections/amazon.aws/pull/574).
Незначительные изменения
- aws_s3 — добавлен параметр
validate_bucket_nameдля управления проверкой имени корзины (https://github.com/ansible-collections/amazon.aws/pull/615). - aws_s3 — модуль
aws_s3переименован вs3_object(https://github.com/ansible-collections/amazon.aws/pull/869). - aws_s3 —
resource_tagsдобавлен в качестве псевдонима параметраtags(https://github.com/ansible-collections/amazon.aws/pull/845). - ec2_eni — тип данных параметра
device_indexизменен на строковый при передаче в вызов APIdescribe_network_inter(https://github.com/ansible-collections/amazon.aws/pull/877). - ec2_eni —
resource_tagsдобавлен в качестве псевдонима параметраtags(https://github.com/ansible-collections/amazon.aws/pull/845). - ec2_group — добавлен
egress_rulesв качестве псевдонима дляrules_egress(https://github.com/ansible-collections/amazon.aws/pull/878). - ec2_group — добавлен
purge_egress_rulesв качестве псевдонима дляpurge_rules_egress(https://github.com/ansible-collections/amazon.aws/pull/878). - ec2_instance — добавлены отсутствующие параметры
metadata_options(https://github.com/ansible-collections/amazon.aws/pull/715). - ec2_key —
resource_tagsдобавлен в качестве псевдонима параметраtags(https://github.com/ansible-collections/amazon.aws/pull/845). - ec2_vpc_net — добавлена поддержка управления VPC по идентификатору (https://github.com/ansible-collections/amazon.aws/pull/848).
- ec2_vpc_subnet — добавлена поддержка параметра OutpostArn (https://github.com/ansible-collections/amazon.aws/pull/598).
- elb_classic_lb —
resource_tagsдобавлен в качестве псевдонима параметраtags(https://github.com/ansible-collections/amazon.aws/pull/845). - s3_bucket — добавлен параметр
validate_bucket_nameдля управления проверкой имени корзины (https://github.com/ansible-collections/amazon.aws/pull/615). - s3_bucket —
resource_tagsдобавлен в качестве псевдонима параметраtags(https://github.com/ansible-collections/amazon.aws/pull/845).
Несовместимые изменения / руководство по переносу
- Теги, начинающиеся с
aws:, не удаляются при очистке тегов; эти теги зарезервированы Amazon и не могут обновляться или удаляться (https://github.com/ansible-collections/amazon.aws/issues/817). - коллекция amazon.aws — параметр
profileтеперь взаимоисключающий с параметрамиaws_access_key,aws_secret_keyиsecurity_token(https://github.com/ansible-collections/amazon.aws/pull/834). - aws_az_info — псевдоним модуля
aws_az_factsбыл объявлен устаревшим в Ansible 2.9 и теперь удален (https://github.com/ansible-collections/amazon.aws/pull/832). - aws_s3 — значение по умолчанию для
ensure overwriteизменено наdifferentвместоalways, чтобы модуль по умолчанию был идемпотентным (https://github.com/ansible-collections/amazon.aws/issues/811). - aws_ssm — параметры on_denied и on_missing теперь по умолчанию имеют значение error для согласованности с aws_secret и базовым классом Lookup (https://github.com/ansible-collections/amazon.aws/issues/617).
- ec2 — модуль
ec2удален в выпуске 4.0.0 и заменен модулемec2_instance(https://github.com/ansible-collections/amazon.aws/pull/630). - ec2_vpc_igw_info — значение по умолчанию для
convert_tagsизменено наTrue(https://github.com/ansible-collections/amazon.aws/pull/835). - elb_classic_lb — факт
ec2_elbудален (https://github.com/ansible-collections/amazon.aws/pull/827). - module_utils — поддержка исходного AWS SDK, также известного как
boto, удалена вместе со всеми соответствующими вспомогательными функциями. Теперь все модули должны использовать AWS SDKboto3/botocore(https://github.com/ansible-collections/amazon.aws/pull/630)
Устаревшие функции
- aws_s3 — псевдоним
S3_URLдля параметра s3_url объявлен устаревшим и будет удален в выпуске 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795). - ec2_ami — псевдоним
DeviceNameдля параметра device_name объявлен устаревшим и будет удален в выпуске 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795). - ec2_ami — псевдоним
NoDeviceдля параметра no_device объявлен устаревшим и будет удален в выпуске 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795). - ec2_ami — псевдоним
VirtualNameдля параметра virtual_name объявлен устаревшим и будет удален в выпуске 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795). - ec2_ami — текущее значение по умолчанию
Falseдляpurge_tagsобъявлено устаревшим и будет изменено в выпуске 5.0.0 наTrue(https://github.com/ansible-collections/amazon.aws/pull/846). - ec2_instance — значение по умолчанию для
`instance_type`объявлено устаревшим; в будущем выпуске необходимо будет указать instance_type или launch_template (https://github.com/ansible-collections/amazon.aws/pull/587). - ec2_instance — текущее значение по умолчанию
Falseдляpurge_tagsобъявлено устаревшим и будет изменено в выпуске 5.0.0 наTrue(https://github.com/ansible-collections/amazon.aws/pull/849). - ec2_key — текущее значение по умолчанию
Falseдляpurge_tagsобъявлено устаревшим и будет изменено в выпуске 5.0.0 наTrue(https://github.com/ansible-collections/amazon.aws/pull/846). - ec2_vol — текущее значение по умолчанию
Falseдляpurge_tagsобъявлено устаревшим и будет изменено в выпуске 5.0.0 наTrue(https://github.com/ansible-collections/amazon.aws/pull/846). - ec2_vpc_dhcp_option_info — псевдоним
DhcpOptionIdsдля параметра dhcp_option_ids объявлен устаревшим и будет удален в выпуске 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795). - ec2_vpc_dhcp_option_info — псевдоним
DryRunдля параметра dry_run объявлен устаревшим и будет удален в выпуске 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795). - ec2_vpc_endpoint — текущее значение по умолчанию
Falseдляpurge_tagsобъявлено устаревшим и будет изменено в выпуске 5.0.0 наTrue(https://github.com/ansible-collections/amazon.aws/pull/846). - ec2_vpc_net — текущее значение по умолчанию
Falseдляpurge_tagsобъявлено устаревшим и будет изменено в выпуске 5.0.0 наTrue(https://github.com/ansible-collections/amazon.aws/pull/848). - ec2_vpc_route_table — текущее значение по умолчанию
Falseдляpurge_tagsобъявлено устаревшим и будет изменено в выпуске 5.0.0 наTrue(https://github.com/ansible-collections/amazon.aws/pull/846). - s3_bucket — псевдоним
S3_URLдля параметра s3_url объявлен устаревшим и будет удален в выпуске 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795). - s3_object — поддержка создания и удаления корзин S3 объявлена устаревшей. Для создания и удаления корзин используйте модуль
amazon.aws.s3_bucket(https://github.com/ansible-collections/amazon.aws/pull/869).
Удаленные функции (ранее объявленные устаревшими)
- cloudformation — параметр
template_formatудален. Модуль не использовал его начиная с Ansible 2.3 (https://github.com/ansible-collections/amazon.aws/pull/833). - ec2_key — параметр
wait_timeoutне оказывал эффекта, был объявлен устаревшим в выпуске 1.0.0 и теперь удален (https://github.com/ansible-collections/amazon.aws/pull/830). - ec2_key — параметр
waitне оказывал эффекта, был объявлен устаревшим в выпуске 1.0.0 и теперь удален (https://github.com/ansible-collections/amazon.aws/pull/830). - ec2_tag — ранее объявленное устаревшим состояние
listудалено. Для просмотра тегов ресурса EC2 можно использовать модульec2_tag_info(https://github.com/ansible-collections/amazon.aws/pull/829). - ec2_vol — ранее объявленное устаревшим состояние
listудалено. Для просмотра томов можно использовать модульec2_vol_info(https://github.com/ansible-collections/amazon.aws/pull/828). - module_utils.batch — класс
ansible_collections.amazon.aws.plugins.module_utils.batch.AWSConnectionудален. Вместо него используйтеAnsibleAWSModule.client()(https://github.com/ansible-collections/amazon.aws/pull/831).
Исправления ошибок
- ec2_group — исправлено необработанное исключение при запуске с
--diffи--checkдля создания новой группы безопасности (https://github.com/ansible-collections/amazon.aws/issues/440). - ec2_instance — добавлено условие для обработки значения
`instance_type`по умолчанию, чтобы устранить сбой при создании экземпляра с шаблоном запуска (https://github.com/ansible-collections/amazon.aws/pull/587). - ec2_instance — при отсутствии разрешения на остановку экземпляра теперь возникает ошибка, если для
stateустановлено значениеrebooted(https://github.com/ansible-collections/amazon.aws/pull/671). - ec2_vpc_igw — для постраничного вывода по возможности используется gateway_id вместо фильтров, чтобы исправить ошибку «объект NoneType не поддерживает индексацию» (https://github.com/ansible-collections/amazon.aws/pull/766).
- ec2_vpc_net — исправлена ошибка, из-за которой конфигурация CIDR обновлялась в режиме проверки (https://github.com/ansible/ansible/issues/62678).
- ec2_vpc_net — исправлена ошибка, из-за которой модуль зависал при обновлении параметров DNS в режиме проверки (https://github.com/ansible/ansible/issues/62677).
- elb_classic_lb — изменено возвращаемое значение метода _format_listeners, чтобы устранить сбой при создании прослушивателей HTTPS (https://github.com/ansible-collections/amazon.aws/pull/860).
v3.5.1
Краткое описание выпуска
3.5.1 — выпуск с исправлением уязвимости безопасности.
Незначительные изменения
- ec2_instance — переработан код
tower_callbackдля обработки проверки параметров в рамках спецификации аргументов (https://github.com/ansible-collections/amazon.aws/pull/1199). - ec2_instance — параметр
tower_callbackпереименован вaap_callback;tower_callbackостается псевдонимом. Это изменение не должно быть заметно пользователям вне документации модуля (https://github.com/ansible-collections/amazon.aws/pull/1199).
Исправления безопасности
- ec2_instance — устранена утечка пароля в журналы при использовании
tower_callback.windows=Trueиtower_callback.set_password(https://github.com/ansible-collections/amazon.aws/pull/1199).
v3.5.0
Краткое описание выпуска
После выпуска amazon.aws 5.0.0 версия 3.5.0 является выпуском с исправлениями ошибок и последним запланированным выпуском ветки 3.x.
Незначительные изменения
- ec2_security_group — для rules->group_name задан тип
list, поскольку он может принимать какstr, так иlist(https://github.com/ansible-collections/amazon.aws/pull/971).
Исправления ошибок
- ec2_metadata_facts — исправлено исключение
'NoneType' object is not callableпри использовании Ansible 2.13 и выше (https://github.com/ansible-collections/amazon.aws/issues/942).
v3.4.0
Незначительные изменения
- ec2_instance — расширено использование автоматических повторных попыток при временных сбоях (https://github.com/ansible-collections/amazon.aws/issues/927).
Исправления ошибок
- elb_application_lb — исправлен
KeyErrorпри распределении нагрузки между двумя целевыми группами (https://github.com/ansible-collections/community.aws/issues/1089). - elb_classic_lb — исправлена ошибка
'NoneType' object has no attributeпри создании нового ELB в режиме проверки с проверкой работоспособности (https://github.com/ansible-collections/amazon.aws/pull/915). - elb_classic_lb — исправлена ошибка
'NoneType' object has no attributeпри создании нового ELB с использованием имен групп безопасности (https://github.com/ansible-collections/amazon.aws/issues/914).
v3.3.1
Краткое описание выпуска
Различные незначительные исправления документации.
v3.3.0
Незначительные изменения
- инвентаризация aws_ec2 — разрешено использовать в имени хоста строковые литералы, не соответствующие параметрам фильтра в ec2 describe-instances (https://github.com/ansible-collections/amazon.aws/pull/826).
- aws_ssm — добавлена поддержка параметра
endpoint(https://github.com/ansible-collections/amazon.aws/pull/837). - module.utils.rds — добавлены retry_codes в возвращаемые данные get_rds_method_attribute для использования в call_method, а также добавлены модульные тесты (https://github.com/ansible-collections/amazon.aws/pull/776).
- module.utils.rds — выполнен рефакторинг для использования возвращаемых данных get_rds_method_attribute (https://github.com/ansible-collections/amazon.aws/pull/776).
- module_utils — к параметру
security_tokenдобавлены новые псевдонимыaws_session_tokenиsession_tokenдля лучшего соответствия boto SDK (https://github.com/ansible-collections/amazon.aws/pull/631). - module_utils.rds — добавлена поддержка и модульные тесты для добавления и удаления ролей IAM в экземпляре базы данных с использованием средств ожидания (https://github.com/ansible-collections/amazon.aws/pull/714).
Исправления ошибок
- Добавлен файл
PSF-license.txtдляplugins/module_utils/_version.py. - плагин поиска aws_account_attribute — исправлены ошибки линтинга в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- плагин инвентаризации aws_ec2 — исправлены ошибки линтинга в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- плагин инвентаризации aws_rds — исправлены ошибки линтинга в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- плагин обратного вызова aws_resource_actions — исправлены ошибки линтинга в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- плагин поиска aws_secret — исправлены ошибки линтинга в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- плагин поиска aws_service_ip_ranges — исправлены ошибки линтинга в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- aws_ssm — исправлена работа переменных среды для настройки клиента (например, AWS_PROFILE, AWS_ACCESS_KEY_ID) (https://github.com/ansible-collections/amazon.aws/pull/837).
- плагин поиска aws_ssm — исправлены ошибки линтинга в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- ec2_instance — модуль ec2_instance не работал в Python 3.8: ключи словаря изменялись во время итерации (https://github.com/ansible-collections/amazon.aws/issues/709).
- module.utils.rds — добавлено средство ожидания для преобразования реплики чтения, чтобы исправить проблему с идемпотентностью (https://github.com/ansible-collections/amazon.aws/pull/714).
- module.utils.rds — добавлена обработка InvalidDBSecurityGroupStateFault при изменении экземпляра базы данных (https://github.com/ansible-collections/amazon.aws/pull/776).
- module.utils.s3 — минимальная длина имени корзины в validate_bucket_name изменена на 3 (https://github.com/ansible-collections/amazon.aws/pull/802).
v3.2.0
Незначительные изменения
- aws_secret — добавлена постраничная обработка для функции
bypath(https://github.com/ansible-collections/amazon.aws/pull/591). - ec2_instance — исправлена область действия предупреждения об устаревании, чтобы оно не выводилось при
stateвabsent(https://github.com/ansible-collections/amazon.aws/pull/719). - ec2_vpc_route_table — добавлена поддержка связывания с интернет-шлюзами (https://github.com/ansible-collections/amazon.aws/pull/690).
- module_utils.elbv2 — добавлена поддержка специфичных для ALB атрибутов и метода compare_elb_attributes для поддержки check_mode в module_utils.elbv2 (https://github.com/ansible-collections/amazon.aws/pull/696).
- s3_bucket — добавлена поддержка принудительного назначения владельца объектов корзины (https://github.com/ansible-collections/amazon.aws/pull/694).
Исправления ошибок
- инвентаризация aws_ec2 — используется параметр конфигурации iam_role_arn для принятия роли перед вызовом DescribeRegions, если конфигурация regions не задана, а предоставленные учетные данные AWS не имеют достаточных прав для выполнения действия DescribeRegions (https://github.com/ansible-collections/amazon.aws/issues/566).
- ec2_vol — не удавалось изменить тип тома с типа, не поддерживающего IOPS (например,
standard), на тип, поддерживающий IOPS (например,gp3) (https://github.com/ansible-collections/amazon.aws/issues/626). - ec2_vpc_igw — исправлена ошибка «объект NoneType не поддерживает индексацию» (https://github.com/ansible-collections/amazon.aws/pull/691).
- ec2_vpc_igw — для описания интернет-шлюзов используется постраничный вывод и добавлена повторная попытка, чтобы исправить ошибку «объект NoneType не поддерживает индексацию» (https://github.com/ansible-collections/amazon.aws/pull/695).
- ec2_vpc_net — в режиме проверки обеспечено отсутствие изменений конфигурации модулем. Обработан случай, когда предоставленный Amazon блок ipv6 включается, затем отключается, а потом включается снова. Связь CIDR для IPv6 (с использованием пула Amazon) не отключается, если свойство ipv6_cidr отсутствует в задаче. Если VPC уже существует и свойство ipv6_cidr указано, текущая конфигурация сохраняется (https://github.com/ansible-collections/amazon.aws/pull/631).
v3.1.1
Незначительные изменения
- версия выпуска коллекции amazon.aws повышена с 3.1.0 до 3.1.1 из-за ошибки, возникшей при загрузке в Galaxy.
v3.1.0
Минорные изменения
- добавлены новые параметры hostvars_prefix и hostvars_suffix для плагинов инвентаризации aws_ec2 и aws_rds (https://github.com/ansible-collections/amazon.aws/issues/535).
- aws_s3 — добавлена опция
validate_bucket_nameдля управления проверкой имени бакета (https://github.com/ansible-collections/amazon.aws/pull/615). - aws_s3 — добавлен вариант latest для параметра
overwrite, позволяющий получить последний объект в S3 (https://github.com/ansible-collections/amazon.aws/pull/595). - ec2_vol — добавлена поддержка параметра OutpostArn (https://github.com/ansible-collections/amazon.aws/pull/597).
- ec2_vol — добавлено присвоение тегов тому при его создании (https://github.com/ansible-collections/amazon.aws/pull/603).
- ec2_vpc_route_table — добавлена поддержка IPv6 при создании таблиц маршрутизации (https://github.com/ansible-collections/amazon.aws/pull/601).
- s3_bucket — добавлена опция
validate_bucket_nameдля управления проверкой имени бакета (https://github.com/ansible-collections/amazon.aws/pull/615).
Устаревшие функции
- ec2_instance — значение по умолчанию для
`instance_type`объявлено устаревшим; в будущей версии необходимо будет указать instance_type или launch_template (https://github.com/ansible-collections/amazon.aws/pull/587).
Исправления ошибок
- Различные модули и плагины — вместо устаревшей стандартной библиотеки Python
distutilsиспользуется включённая в коллекцию версияdistutils.version(https://github.com/ansible-collections/amazon.aws/pull/599). - aws_acm — при получении сертификатов ACM больше не возникает исключение ResourceNotFound.
- aws_s3 — исправлено исключение, возникавшее при использовании модуля для копирования из источника в место назначения, если в источнике отсутствует ключ (https://github.com/ansible-collections/amazon.aws/issues/602).
- ec2_instance — добавлена проверка для обработки значения
`instance_type`по умолчанию, чтобы устранить сбой при создании экземпляра с шаблоном запуска (https://github.com/ansible-collections/amazon.aws/pull/587). - ec2_key — добавлена поддержка типа ключа ED25519 (https://github.com/ansible-collections/amazon.aws/issues/572).
- ec2_vol — значение Iops задаётся в req_obj, даже если оно не изменилось, чтобы можно было изменять типы томов, для которых требуется передавать значение iops в boto. (https://github.com/ansible-collections/amazon.aws/pull/606)
- elb_classic_lb — обработка security_group_ids при указании security_group_names; исправлены неработающие задачи в интеграционном тесте (https://github.com/ansible-collections/amazon.aws/pull/592).
- s3_bucket — добавлена возможность управления ACL на уровне бакета (https://github.com/ansible-collections/amazon.aws/issues/573).
v3.0.0
Крупные изменения
- Коллекция amazon.aws — прекращена поддержка
botocore<1.19.0иboto3<1.16.0. Большинство модулей продолжат работать со старыми версиями AWS SDK, однако совместимость с ними не гарантируется и не будет проверяться. При использовании старых версий SDK Ansible выдаст предупреждение (https://github.com/ansible-collections/amazon.aws/pull/574).
Минорные изменения
- ec2_instance — добавлена поддержка параметра count (https://github.com/ansible-collections/amazon.aws/pull/539).
Несовместимые изменения / Руководство по переносу
- aws_caller_facts — удалён устаревший псевдоним
aws_caller_facts. Вместо него используйтеaws_caller_info. - cloudformation_facts — удалён устаревший псевдоним
cloudformation_facts. Вместо него используйтеcloudformation_info. - ec2_ami_facts — удалён устаревший псевдоним
ec2_ami_facts. Вместо него используйтеec2_ami_info. - ec2_eni_facts — удалён устаревший псевдоним
ec2_eni_facts. Вместо него используйтеec2_eni_info. - ec2_group_facts — удалён устаревший псевдоним
ec2_group_facts. Вместо него используйтеec2_group_info. - ec2_instance_facts — удалён устаревший псевдоним
ec2_instance_facts. Вместо него используйтеec2_instance_info. - ec2_snapshot_facts — удалён устаревший псевдоним
ec2_snapshot_facts. Вместо него используйтеec2_snapshot_info. - ec2_vol_facts — удалён устаревший псевдоним
ec2_vol_facts. Вместо него используйтеec2_vol_info. - ec2_vpc_dhcp_option_facts — удалён устаревший псевдоним
ec2_vpc_dhcp_option_facts. Вместо него используйтеec2_vpc_dhcp_option_info. - ec2_vpc_endpoint_facts — удалён устаревший псевдоним
ec2_vpc_endpoint_facts. Вместо него используйтеec2_vpc_endpoint_info. - ec2_vpc_igw_facts — удалён устаревший псевдоним
ec2_vpc_igw_facts. Вместо него используйтеec2_vpc_igw_info. - ec2_vpc_nat_gateway_facts — удалён устаревший псевдоним
ec2_vpc_nat_gateway_facts. Вместо него используйтеec2_vpc_nat_gateway_info. - ec2_vpc_net_facts — удалён устаревший псевдоним
ec2_vpc_net_facts. Вместо него используйтеec2_vpc_net_info. - ec2_vpc_route_table_facts — удалён устаревший псевдоним
ec2_vpc_route_table_facts. Вместо него используйтеec2_vpc_route_table_info. - ec2_vpc_subnet_facts — удалён устаревший псевдоним
ec2_vpc_subnet_facts. Вместо него используйтеec2_vpc_subnet_info.
Устаревшие функции
- module_utils — поддержка исходного AWS SDK
botoобъявлена устаревшей в пользу SDKboto3/botocore. Все модули на основеbotoлибо объявлены устаревшими, либо перенесены наbotocore; оставшийся код поддержки в module_utils будет удалён в версии 4.0.0 коллекции amazon.aws. Все модули вне коллекций amazon.aws и community.aws, основанные на библиотекеboto, необходимо будет перенести на библиотекиboto3/botocore(https://github.com/ansible-collections/amazon.aws/pull/575).
v2.3.0
Исправления ошибок
- Плагин поиска aws_account_attribute — исправлены ошибки линтера в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- Плагин инвентаризации aws_ec2 — исправлены ошибки линтера в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- Плагин инвентаризации aws_rds — исправлены ошибки линтера в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- Плагин обратного вызова aws_resource_actions — исправлены ошибки линтера в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- Плагин поиска aws_secret — исправлены ошибки линтера в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- Плагин поиска aws_service_ip_ranges — исправлены ошибки линтера в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- Плагин поиска aws_ssm — исправлены ошибки линтера в данных документации (https://github.com/ansible-collections/amazon.aws/pull/701).
- ec2_instance — модуль ec2_instance не работал в Python 3.8: ключи словаря изменялись во время итерации (https://github.com/ansible-collections/amazon.aws/issues/709).
- module.utils.s3 — минимальная длина для validate_bucket_name изменена на 3 (https://github.com/ansible-collections/amazon.aws/pull/802).
v2.2.0
Минорные изменения
- ec2_instance — добавлена поддержка параметра count (https://github.com/ansible-collections/amazon.aws/pull/539).
Исправления ошибок
- Инвентаризация aws_ec2 — если конфигурация regions не задана, а предоставленные учётные данные AWS не обладают достаточными правами для выполнения действия DescribeRegions, перед вызовом DescribeRegions используется параметр конфигурации iam_role_arn для принятия роли. (https://github.com/ansible-collections/amazon.aws/issues/566).
- ec2_vol — значение Iops задаётся в req_obj, даже если оно не изменилось, чтобы можно было изменять типы томов, для которых требуется передавать значение iops в boto. (https://github.com/ansible-collections/amazon.aws/pull/606)
- ec2_vol — не удаётся изменить тип тома, не поддерживающего IOPS (например,
standard), на тип с поддержкой IOPS (например,gp3) (https://github.com/ansible-collections/amazon.aws/issues/626). - ec2_vpc_igw — исправлена ошибка «объект NoneType не поддерживает обращение по индексу» (https://github.com/ansible-collections/amazon.aws/pull/691).
- ec2_vpc_igw — для описания интернет-шлюзов используется пагинатор, а также добавлен повторный вызов для исправления ошибки «объект NoneType не поддерживает обращение по индексу» (https://github.com/ansible-collections/amazon.aws/pull/695).
- elb_classic_lb — обработка security_group_ids при указании security_group_names; исправлены неработающие задачи в интеграционном тесте (https://github.com/ansible-collections/amazon.aws/pull/592).
v2.1.0
Минорные изменения
- aws_service_ip_ranges — добавлена новая опция
ipv6_prefixesдля получения только адресов и префиксов IPV6 сервисов Amazon (https://github.com/ansible-collections/amazon.aws/pull/430) - cloudformation — исправлено обнаружение отсутствия изменений. Иногда при отсутствии изменений набор изменений получает статус FAILED с причиной No updates are to be performed (https://github.com/ansible-collections/amazon.aws/pull/507).
- ec2_ami — добавлена поддержка check_mode (https://github.com/ansible-collections/amazon.aws/pull/516).
- ec2_ami — для присвоения тегов AMI используется вспомогательная функция module_util (https://github.com/ansible-collections/amazon.aws/pull/520).
- ec2_ami — при создании AMI из экземпляра параметры присвоения тегов передаются во время создания (https://github.com/ansible-collections/amazon.aws/pull/551).
- ec2_elb_lb — модуль переименован в
elb_classic_lb(https://github.com/ansible-collections/amazon.aws/pull/377). - ec2_eni — добавлена поддержка check mode (https://github.com/ansible-collections/amazon.aws/pull/534).
- ec2_eni — для присвоения тегов ENI используется вспомогательная функция module_util (https://github.com/ansible-collections/amazon.aws/pull/522).
- ec2_instance — для присвоения тегов используются вспомогательные функции module_util (https://github.com/ansible-collections/amazon.aws/pull/527).
- ec2_key — добавлена поддержка присвоения тегов парам ключей (https://github.com/ansible-collections/amazon.aws/pull/548).
- ec2_snapshot — добавлена поддержка check_mode (https://github.com/ansible-collections/amazon.aws/pull/512).
- ec2_vol — добавлена поддержка check_mode (https://github.com/ansible-collections/amazon.aws/pull/509).
- ec2_vpc_dhcp_option — для присвоения тегов используются вспомогательные функции module_util (https://github.com/ansible-collections/amazon.aws/pull/531).
- ec2_vpc_endpoint — добавлен параметр
vpc_endpoint_security_groupsдля указания группы безопасности, присоединённой к интерфейсной конечной точке (https://github.com/ansible-collections/amazon.aws/pull/544). - ec2_vpc_endpoint — добавлен параметр
vpc_endpoint_subnetsдля указания подсети, присоединённой к интерфейсной или шлюзовой конечной точке (https://github.com/ansible-collections/amazon.aws/pull/544). - ec2_vpc_endpoint — для присвоения тегов используется вспомогательная функция module_util (https://github.com/ansible-collections/amazon.aws/pull/525).
- ec2_vpc_endpoint — для присвоения тегов используются вспомогательные функции module_util (https://github.com/ansible-collections/amazon.aws/pull/531).
- ec2_vpc_igw — для присвоения тегов используется вспомогательная функция module_util (https://github.com/ansible-collections/amazon.aws/pull/523).
- ec2_vpc_igw — для присвоения тегов используются вспомогательные функции module_util (https://github.com/ansible-collections/amazon.aws/pull/531).
- ec2_vpc_nat_gateway — для присвоения тегов используется вспомогательная функция module_util (https://github.com/ansible-collections/amazon.aws/pull/524).
- ec2_vpc_nat_gateway — для присвоения тегов используются вспомогательные функции module_util (https://github.com/ansible-collections/amazon.aws/pull/531).
- elb_classic_lb — добавлены повторные попытки при типичных временных сбоях API AWS (https://github.com/ansible-collections/amazon.aws/pull/377).
- elb_classic_lb — добавлена поддержка check_mode (https://github.com/ansible-collections/amazon.aws/pull/377).
- elb_classic_lb — добавлена поддержка ожидания во время создания (https://github.com/ansible-collections/amazon.aws/pull/377).
- elb_classic_lb — добавлена поддержка ожидания при добавлении и удалении экземпляров (https://github.com/ansible-collections/amazon.aws/pull/377).
- elb_classic_lb — выполнен переход на SDK boto3 (https://github.com/ansible-collections/amazon.aws/pull/377).
- elb_classic_lb — в связи с рефакторингом изменены различные сообщения об ошибках (https://github.com/ansible-collections/amazon.aws/pull/377).
- module_utils.ec2 — общие вспомогательные функции для присвоения тегов перенесены в module_utils.tagging (https://github.com/ansible-collections/amazon.aws/pull/527).
- module_utils.tagging — добавлена новая вспомогательная функция для создания списков TagSpecification (https://github.com/ansible-collections/amazon.aws/pull/527).
Устаревшие функции
- ec2_classic_lb — присвоение факта
ec2_elbобъявлено устаревшим и будет удалено в версии 4.0.0 коллекции. Теперь модуль возвращаетelb, к которому можно обратиться с помощью ключевого слова register (https://github.com/ansible-collections/amazon.aws/pull/552).
Исправления ошибок
- Группа действий AWS — добавлена отсутствующая запись
ec2_instance_facts(https://github.com/ansible-collections/amazon.aws/issues/557) - ec2_ami — исправлена проблема при создании AMI из экземпляра с временными томами (https://github.com/ansible-collections/amazon.aws/issues/511).
- ec2_instance — добавлена проверка, обеспечивающая использование параметра tag(Name), если не переданы ни фильтр, ни параметр name (https://github.com/ansible-collections/amazon.aws/issues/526).
- s3_bucket — улучшена обработка ошибок для более полной поддержки DigitalOcean Space (https://github.com/ansible-collections/amazon.aws/issues/508).
v2.0.0
Основные изменения
- Коллекция amazon.aws — поскольку AWS SDK объявили о прекращении поддержки Python версий ниже 3.6 (https://boto3.amazonaws.com/v1/documentation/api/1.17.64/guide/migrationpy3.html), для этой коллекции теперь требуется Python 3.6 или новее (https://github.com/ansible-collections/amazon.aws/pull/298).
- Коллекция amazon.aws — поддержка
botocore<1.18.0иboto3<1.15.0в коллекции amazon.aws прекращена. Большинство модулей продолжит работать с более старыми версиями AWS SDK, однако совместимость с ними не гарантируется и не будет проверяться. При использовании старых версий SDK Ansible выдаст предупреждение (https://github.com/ansible-collections/amazon.aws/pull/502). - ec2_instance — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_instance. - ec2_instance_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_instance_info. - ec2_vpc_endpoint — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_vpc_endpoint. - ec2_vpc_endpoint_facts — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_vpc_endpoint_info. - ec2_vpc_endpoint_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_vpc_endpoint_info. - ec2_vpc_endpoint_service_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_vpc_endpoint_service_info. - ec2_vpc_igw — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_vpc_igw. - ec2_vpc_igw_facts — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_vpc_igw_facts. - ec2_vpc_igw_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_vpc_igw_info. - ec2_vpc_nat_gateway — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_vpc_nat_gateway. - ec2_vpc_nat_gateway_facts — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_vpc_nat_gateway_info. - ec2_vpc_nat_gateway_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_vpc_nat_gateway_info. - ec2_vpc_route_table — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_vpc_route_table. - ec2_vpc_route_table_facts — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_vpc_route_table_facts. - ec2_vpc_route_table_info — модуль перенесён из коллекции
community.aws. В плейбуках, где используется полное имя коллекции для этого модуля, его следует заменить наamazon.aws.ec2_vpc_route_table_info.
Незначительные изменения
- aws_ec2 — вместо включения в список используется генератор (https://github.com/ansible-collections/amazon.aws/pull/465).
- aws_s3 — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- aws_s3 — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- aws_s3 — добавлены функции
tagsиpurge_tagsдля объекта S3 (https://github.com/ansible-collections/amazon.aws/pull/335) - aws_s3 — добавлен новый режим копирования существующего объекта в другой бакет (https://github.com/ansible-collections/amazon.aws/pull/359).
- aws_secret — добавлена поддержка корректной обработки удалённых секретов (https://github.com/ansible-collections/amazon.aws/pull/455).
- aws_ssm — добавлен параметр
on_missingиon_denied(https://github.com/ansible-collections/amazon.aws/pull/370). - cloudformation — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- cloudformation — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- ec2_ami — при создании AMI теги теперь передаются снимку (снимкам) (https://github.com/ansible-collections/amazon.aws/pull/437).
- ec2_eni — исправлена идемпотентность при указании атрибута
security_groups(https://github.com/ansible-collections/amazon.aws/pull/337). - ec2_eni — увеличено время ожидания завершения отсоединения ENI (https://github.com/ansible-collections/amazon.aws/pull/501).
- ec2_group — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- ec2_group — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- ec2_group — вместо включения в список используется генератор (https://github.com/ansible-collections/amazon.aws/pull/465).
- ec2_group — используется системный модуль ipaddress, доступный в Python >= 3.3, вместо встроенной копии (https://github.com/ansible-collections/amazon.aws/pull/461).
- ec2_instance — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- ec2_instance — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- ec2_instance — добавлен параметр
throughputдля типов томов gp3 (https://github.com/ansible-collections/amazon.aws/pull/433). - ec2_instance — добавлена поддержка управления параметрами метаданных (https://github.com/ansible-collections/amazon.aws/pull/414).
- ec2_instance — удалён ненужный вызов raise при выходе с ошибкой (https://github.com/ansible-collections/amazon.aws/pull/460).
- ec2_instance_info — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- ec2_instance_info — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- ec2_snapshot — модуль переведён на использование библиотеки Python boto3 (https://github.com/ansible-collections/amazon.aws/pull/356).
- ec2_spot_instance_info — добавлен новый модуль для описания указанных запросов Spot Instance (https://github.com/ansible-collections/amazon.aws/pull/487).
- ec2_vol — добавлен параметр
multi_attachдля поддержки Multi-Attach при создании/обновлении тома (https://github.com/ansible-collections/amazon.aws/pull/362). - ec2_vol — смягчены требования к boto3/botocore: для изменения параметра
throughputтребуется только botocore 1.19.27 (https://github.com/ansible-collections/amazon.aws/pull/346). - ec2_vpc_dhcp_option — теперь также возвращает описание ресурса в стиле boto3 в ключе результата
dhcp_options. Оно включает все теги дляdhcp_options_idи имеет тот же формат, что и текущее возвращаемое значениеec2_vpc_dhcp_option_info. (https://github.com/ansible-collections/amazon.aws/pull/252) - ec2_vpc_dhcp_option_info — теперь также возвращает удобный для пользователя ключ
dhcp_config, соответствующий историческому ключуnew_configиз ec2_vpc_dhcp_option, и устраняет необходимость использоватьitems2dict(key_name='key', value_name='values')при разборе вывода модуля. (https://github.com/ansible-collections/amazon.aws/pull/252) - ec2_vpc_subnet — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- ec2_vpc_subnet — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- интеграционные тесты — удалена зависимость от коллекции
community.general(https://github.com/ansible-collections/amazon.aws/pull/361). - module_utils/waiter — добавлен waiter для кластера RDS
cluster_available(https://github.com/ansible-collections/amazon.aws/pull/464). - module_utils/waiter — добавлен waiter для кластера RDS
cluster_deleted(https://github.com/ansible-collections/amazon.aws/pull/464). - module_utils/waiter — добавлен waiter Route53
resource_record_sets_changed(https://github.com/ansible-collections/amazon.aws/pull/350). - s3_bucket — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- s3_bucket — удалены тесты на совместимость со старыми версиями AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/442).
- s3_bucket — добавлена новая опция
object_ownershipдля настройки владения объектами (https://github.com/ansible-collections/amazon.aws/pull/311) - s3_bucket — при проверке существования бакета теперь используется HeadBucket вместо ListBucket (https://github.com/ansible-collections/amazon.aws/pull/357).
Несовместимые изменения / руководство по переносу
- ec2_instance — изменилось поведение ожидания состояния экземпляра. Если в сценариях требуется прежнее поведение — ожидание перехода состояния мониторинга экземпляра в
OKпри запуске нового экземпляра, — в действии необходимо указатьstate: started(https://github.com/ansible-collections/amazon.aws/pull/481). - ec2_snapshot — удалена поддержка бесконечного ожидания, новое значение по умолчанию — 10 минут (https://github.com/ansible-collections/amazon.aws/pull/356).
- ec2_vol_info — значение
attachment_setтеперь представляет собой список подключений с поддержкой Multi-Attach для диска. (https://github.com/ansible-collections/amazon.aws/pull/362). - ec2_vpc_dhcp_option — модуль переработан для использования boto3. Возвращаемые модулем ключи и типы значений теперь согласованы, что отличается от прежнего поведения. Добавлена опция
purge_tags, значение которой по умолчанию —True. (https://github.com/ansible-collections/amazon.aws/pull/252) - ec2_vpc_dhcp_option_info — в возвращаемом значении теперь сохраняется регистр ключей тегов. (https://github.com/ansible-collections/amazon.aws/pull/252)
- module_utils.core — удалён переключатель boto3 из параметра region (https://github.com/ansible-collections/amazon.aws/pull/287).
- module_utils/compat — удалена встроенная копия ipaddress (https://github.com/ansible-collections/amazon.aws/pull/461).
- module_utils/core — функция
scrub_none_parametersобновлена: теперь по умолчанию дляdescend_into_listsустанавливаетсяTrue(https://github.com/ansible-collections/amazon.aws/pull/297).
Устаревшие функции
- ec2 — модуль
ec2на основе boto объявлен устаревшим в пользу модуляec2_instanceна основе boto3. Модульec2будет удалён в выпуске 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/424). - ec2_vpc_dhcp_option — возвращаемый ключ
new_configобъявлен устаревшим и будет удалён в одном из будущих выпусков. Вместо него будет использоватьсяdhcp_config. До этого момента возвращаются оба значения. (https://github.com/ansible-collections/amazon.aws/pull/252)
Исправления ошибок
- aws_s3 — исправлены разрешения на загрузку, если политика ACL бакета S3 требует определённую предопределённую ACL (https://github.com/ansible-collections/amazon.aws/pull/318)
- ec2_ami — исправлена проблема при создании AMI с параметром no_device (https://github.com/ansible-collections/amazon.aws/pull/386)
- ec2_instance —
ec2_instanceпри запуске нового экземпляра ожидал, пока состояние мониторинга экземпляра EC2 станетOK. Из-за этого плейбук мог ждать несколько минут завершения AWS проверок состояния мониторинга (https://github.com/ansible-collections/amazon.aws/pull/481). - ec2_snapshot — исправлена проблема при создании снимка тома без тегов (https://github.com/ansible-collections/amazon.aws/pull/383)
- ec2_vol — исправлен статус
changedпри использованииmodify_volume, если новый диск не подключается. Модуль ошибочно сообщал об отсутствии изменений, даже если параметры дисков были изменены (iops, пропускная способность, тип и т. д.). (https://github.com/ansible-collections/amazon.aws/issues/482). - ec2_vol — исправлена настройка iops и обеспечено обязательное использование параметров iops/пропускной способности (https://github.com/ansible-collections/amazon.aws/pull/334)
- inventory —
include_filtersбольше не будет игнорироваться, еслиfiltersне задан (https://github.com/ansible-collections/amazon.aws/issues/457). - s3_bucket — исправлена обработка ошибок при попытке задать неподдерживаемую функцию (https://github.com/ansible-collections/amazon.aws/pull/391).
- s3_bucket — добавлена корректная обработка исключений
NotImplementedпри получении параметров шифрования (https://github.com/ansible-collections/amazon.aws/issues/390).
Новые модули
- ec2_spot_instance — запрос, остановка, перезагрузка или отмена Spot Instance
- ec2_spot_instance_info — сбор сведений о запросах Spot Instance EC2
v1.5.1
Незначительные изменения
- ec2_instance — удалён ненужный вызов raise при выходе с ошибкой (https://github.com/ansible-collections/amazon.aws/pull/460).
Исправления ошибок
- ec2_vol — исправлен статус
changedпри использованииmodify_volume, если новый диск не подключается. Модуль ошибочно сообщал об отсутствии изменений, даже если параметры дисков были изменены (iops, пропускная способность, тип и т. д.). (https://github.com/ansible-collections/amazon.aws/issues/482). - ec2_vol — исправлена настройка iops и обеспечено обязательное использование параметров iops/пропускной способности (https://github.com/ansible-collections/amazon.aws/pull/334)
v1.5.0
Незначительные изменения
- Плагины инвентаризации AWS — вместо копирования кода используется общий вспомогательный модуль HAS_BOTO3 (https://github.com/ansible-collections/amazon.aws/pull/288).
- Плагины поиска AWS — вместо копирования кода используется общий вспомогательный модуль HAS_BOTO3 (https://github.com/ansible-collections/amazon.aws/pull/288).
- aws_account_attribute — добавлены повторные попытки при распространённых сбоях AWS (https://github.com/ansible-collections/amazon.aws/pull/295).
- Инвентаризация aws_ec2 — добавлен новый ключ конфигурации
use_contrib_script_compatible_ec2_tag_keysдля воспроизведения поведения старого скрипта инвентаризацииec2.py. Если этот параметр включён, каждый тег передаётся с использованием ключаec2_tag_TAGNAME(https://github.com/ansible-collections/amazon.aws/pull/331). - Инвентаризация aws_ec2 — добавлены новые ключи
include_filtersиexclude_filters, позволяющие пользователю составлять инвентаризацию с помощью нескольких запросов (https://github.com/ansible-collections/amazon.aws/pull/328). - Плагин инвентаризации aws_ec2 — добавлена поддержка использования шаблонов Jinja2 в полях аутентификации (https://github.com/ansible-collections/amazon.aws/pull/57).
- cloudformation — добавлена поддержка StackPolicyDuringUpdateBody (https://github.com/ansible-collections/amazon.aws/pull/155).
- ec2_metadata_facts — добавлена поддержка IMDSv2 (https://github.com/ansible-collections/amazon.aws/pull/43).
- ec2_snapshot_info — добавлен
max_resultsвместе с параметромnext_token_id(https://github.com/ansible-collections/amazon.aws/pull/321). - ec2_tag — для добавления тегов к ресурсам используется общий код (https://github.com/ansible-collections/amazon.aws/pull/309).
- ec2_tag_info — для добавления тегов к ресурсам используется общий код (https://github.com/ansible-collections/amazon.aws/pull/309).
- ec2_vol — добавлен параметр
purge_tags(https://github.com/ansible-collections/amazon.aws/pull/242). - ec2_vol — для добавления тегов к ресурсам используется общий код (https://github.com/ansible-collections/amazon.aws/pull/309).
- ec2_vpc_net — используется специальный waiter, обрабатывающий ограничение частоты запросов API (https://github.com/ansible-collections/amazon.aws/pull/270).
- ec2_vpc_subnet — для более последовательной обработки ограничения частоты запросов API используется декоратор AWSRetry (https://github.com/ansible-collections/amazon.aws/pull/270).
- ec2_vpc_subnet — для добавления тегов к ресурсам используется общий код (https://github.com/ansible-collections/amazon.aws/pull/309).
- module_utils.cloudfront_facts — очистка кода линтера (https://github.com/ansible-collections/amazon.aws/pull/291).
- module_utils.ec2 — очистка кода линтера (https://github.com/ansible-collections/amazon.aws/pull/291).
- module_utils/core — добавлена вспомогательная функция
normalize_boto3_result(https://github.com/ansible-collections/amazon.aws/pull/271). - module_utils/core — во вспомогательную функцию
scrub_none_parametersдобавлен параметрdescend_into_lists(https://github.com/ansible-collections/amazon.aws/pull/262). - module_utils/ec2 — добавлены дополнительные вспомогательные функции для добавления тегов к ресурсам EC2 (https://github.com/ansible-collections/amazon.aws/pull/309).
- тесты sanity — добавлен файл ignore.txt для версии 2.12 (https://github.com/ansible-collections/amazon.aws/pull/315).
Исправления ошибок
- ec2_vol — при создании или обновлении теперь сохраняются существующие теги, в том числе Name (https://github.com/ansible-collections/amazon.aws/issues/229)
- ec2_vol — исправлено исключение, возникавшее при отсутствии информации о платформе (https://github.com/ansible-collections/amazon.aws/issues/305).
v1.4.1
Незначительные изменения
- module_utils — служебный модуль ipaddress включён в эту коллекцию. Это устраняет зависимость коллекции от ansible.netcommon (в выпуске 2.0 из неё была удалена эта библиотека). Библиотека ipaddress предоставляется только для внутреннего использования в этой коллекции. (https://github.com/ansible-collections/amazon.aws/issues/273)-
v1.4.0
Незначительные изменения
- aws_ec2 — добавлена конкатенация параметров имени узла
- Плагин инвентаризации aws_ec2 — исключён избыточный импорт
ansible.utils.display.Display(https://github.com/ansible-collections/amazon.aws/pull/226). - Модуль aws_ec2 — обратные фильтры aws instance-state-name !terminated и !shutting-down заменены положительными фильтрами pending, running, stopping, stopped. Проблема 235. (https://github.com/ansible-collections/amazon.aws/pull/237)
- aws_secret — добавлена функциональность
bypath(https://github.com/ansible-collections/amazon.aws/pull/192). - ec2_key — добавлен декоратор AWSRetry для автоматических повторных попыток при распространённых временных сбоях (https://github.com/ansible-collections/amazon.aws/pull/213).
- ec2_vol — добавлена поддержка томов gp3 и изменение существующих томов (https://github.com/ansible-collections/amazon.aws/issues/55).
- module_utils/elbv2 — добавлена логика сравнения правил в compare_rules, учитывающая списки Values, вложенные в словари и уникальные для каждого типа поля. Исправлена проблема (https://github.com/ansible-collections/amazon.aws/issues/187)
- Различные плагины AWS и module_utils — удалены неиспользуемые импорты (https://github.com/ansible-collections/amazon.aws/pull/217).
Исправления ошибок
- ec2_vol — при создании или обновлении теперь возвращается структура с актуальным списком тегов (https://github.com/ansible-collections/amazon.aws/pull/241).
v1.3.0
Незначительные изменения
- aws_caller_info — добавлен декоратор AWSRetry для автоматического повтора при распространённых временных сбоях (https://github.com/ansible-collections/amazon.aws/pull/208)
- aws_s3 — добавлена поддержка загрузки шаблонного содержимого (https://github.com/ansible-collections/amazon.aws/pull/20).
- aws_secret — добавлена опция
on_missingиon_denied(https://github.com/ansible-collections/amazon.aws/pull/122). - ec2_ami — добавлены повторные попытки при ошибках, связанных с ограничением частоты запросов (https://github.com/ansible-collections/amazon.aws/pull/195).
- ec2_ami — исправлена и упрощена логика
max_attemptsпри ожидании завершения создания AMI (https://github.com/ansible-collections/amazon.aws/pull/194). - ec2_ami — значение
wait_timeoutпо умолчанию увеличено до 1200 секунд (https://github.com/ansible-collections/amazon.aws/pull/194). - ec2_ami_info — добавлены повторные попытки при ошибках, связанных с ограничением частоты запросов (https://github.com/ansible-collections/amazon.aws/pull/195).
- ec2_eni — повышена надёжность модуля за счёт добавления средств ожидания и поиска по идентификатору ENI вместо повторных поисковых запросов (https://github.com/ansible-collections/amazon.aws/pull/180).
- ec2_eni_info — повышена надёжность модуля за счёт добавления средств ожидания и поиска по идентификатору ENI вместо повторных поисковых запросов (https://github.com/ansible-collections/amazon.aws/pull/180).
- ec2_group — добавлен декоратор AWSRetry для автоматического повтора при распространённых временных сбоях (https://github.com/ansible-collections/amazon.aws/pull/207)
- ec2_group_info — добавлен декоратор AWSRetry для автоматического повтора при распространённых временных сбоях (https://github.com/ansible-collections/amazon.aws/pull/207)
- ec2_snapshot_info — добавлен декоратор AWSRetry для автоматического повтора при распространённых временных сбоях (https://github.com/ansible-collections/amazon.aws/pull/208)
- ec2_vol — добавлены автоматические повторные попытки при ошибках ограничения частоты запросов AWS (https://github.com/ansible-collections/amazon.aws/pull/199).
- ec2_vol — модуль ec2_vol перенесён на boto3 (https://github.com/ansible-collections/amazon.aws/pull/53).
- ec2_vpc_dhcp_option_info — добавлен декоратор AWSRetry для автоматического повтора при распространённых временных сбоях (https://github.com/ansible-collections/amazon.aws/pull/208)
- module_utils/core — добавлена вспомогательная функция
scrub_none_parametersдля удаления параметров, установленных вNone(https://github.com/ansible-collections/community.aws/issues/251). - module_utils/waiters — добавлены повторные попытки для средств ожидания при тех же кодах ошибок, при которых выполняется повтор с AWSRetry (https://github.com/ansible-collections/amazon.aws/pull/185)
- s3_bucket — добавлена поддержка управления настройками
public_access(https://github.com/ansible-collections/amazon.aws/pull/171).
Исправления ошибок
- ec2 — исправлен код, позволяющий модулю создавать экземпляры EC2 с опцией
ec2_volume_iops(https://github.com/ansible-collections/amazon.aws/pull/177). - ec2 — при запуске и остановке игнорируются завершённые экземпляры и экземпляры, находящиеся в процессе остановки (https://github.com/ansible-collections/amazon.aws/issues/146).
- ec2_group — исправлена обработка ошибок при сбоях добавления тегов (https://github.com/ansible-collections/amazon.aws/issues/210).
- ec2_group_info — исправлен код, чтобы модуль работал с Python 3.8 (словарь становится неизменяемым в цикле) (https://github.com/ansible-collections/amazon.aws/pull/181)
v1.2.1
Незначительные изменения
- ec2_eni — добавлена поддержка тегирования.
- ec2_eni — модуль ec2_eni переведён на boto3, добавлен набор интеграционных тестов.
- ec2_eni_info — добавлены повторные попытки при временных сбоях AWS.
- ec2_eni_info — добавлена поддержка указания идентификатора ENI.
v1.2.0
Незначительные изменения
- ec2 module_utils — обновлено поведение
ec2_connect(boto2), чтобыec2_urlпереопределялregion. - module_utils.core — добавлена поддержка передачи произвольных дополнительных ключей в fail_json_aws, в соответствии с возможностями fail_json.
Устаревшие возможности
- Все модули AWS —
aws_access_key,aws_secret_keyиsecurity_tokenперестанут сочетаться сprofileпосле 2022-06-01.
Исправления ошибок
- ec2 module_utils — гарантировано, что параметр verify в boto3 не переопределяется при задании профиля (https://github.com/ansible-collections/amazon.aws/issues/129)
- s3_bucket — совместимость с Ceph: код ошибки NoSuchTagSetError, используемый Ceph, обрабатывается как эквивалент NoSuchTagSet, используемого AWS
v1.1.0
Крупные изменения
- ec2 module_utils — декоратор
AWSRetryбольше не перехватывает исключенияNotFoundпо умолчанию. ИсключенияNotFoundнеобходимо явно добавлять с помощьюcatch_extra_error_codes. В некоторых модулях AWS может увеличиться количество временных сбоев из-за модели eventual consistency в AWS.
Незначительные изменения
- Добавлены псевдонимы
aws_security_token,aws_endpoint_urlиendpoint_urlдля повышения согласованности имён параметров модулей AWS. - Добавлена поддержка
aws_ca_bundleв модулях AWS на основе boto3 - Добавлена поддержка настройки профилей boto3 с помощью
AWS_PROFILEиAWS_DEFAULT_PROFILE - Добавлена поддержка check_mode в aws_az_info
- Добавлена поддержка check_mode в ec2_eni_info
- Добавлена поддержка check_mode в ec2_snapshot_info
- ansible_dict_to_boto3_filter_list — преобразование целых чисел и логических значений в строки перед использованием в фильтрах.
- aws_direct_connect_virtual_interface — добавлен параметр direct_connect_gateway_id. Это поле применимо только для частных VIF (public=False) и не может использоваться одновременно с virtual_gateway_id.
- cloudformation — если был создан набор изменений, в выходные данные cloudformation возвращается change_set_id.
- ec2 — объявлено устаревшим одновременное использование group и group_id: сейчас group_id игнорируется, если указаны оба параметра.
- ec2_ami_info — разрешены целочисленные и логические значения для фильтрации образов (https://github.com/ansible/ansible/issues/43570).
- ec2_asg — добавлена поддержка максимального срока жизни экземпляра
- ec2_asg — добавлена возможность использовать mixed_instance_policy в группах автомасштабирования, управляемых шаблонами запуска
- ec2_asg — выполнен переход на AnsibleAWSModule
- ec2_placement_group — поле
nameсделано обязательным. - ec2_vol_info — выполнена очистка кода и добавлен декоратор AWSRetry для повышения стабильности
- ec2_vpc_net — включено назначение IPv6 CIDR
Несовместимые изменения / Руководство по переносу
- aws_s3 — теперь можно удалять бакеты с включённым управлением версиями, даже если они не пусты: задайте mode равным delete, чтобы удалить такой бакет и всё его содержимое.
Устаревшие возможности
- cloudformation — опция
template_formatне действует начиная с Ansible 2.3 и будет удалена после 2022-06-01 - cloudformation — опция
template_formatобъявлена устаревшей и будет удалена в одном из последующих выпусков. Модуль игнорирует её начиная с Ansible 2.3. - data_pipeline — опция
versionне действовала и будет удалена после 2022-06-01 - ec2 — в одном из последующих выпусков параметры
groupиgroup_idперестанут сочетаться. Сейчасgroup_idигнорируется, если указаны оба параметра. - ec2_ami — псевдоним
NoDeviceдляno_deviceобъявлен устаревшим и будет удалён после 2022-06-01 - ec2_ami — псевдоним
VirtualNameдляvirtual_nameобъявлен устаревшим и будет удалён после 2022-06-01 - ec2_eip — опция
wait_timeoutне действовала и будет удалена после 2022-06-01 - ec2_key — опция
wait_timeoutне действовала и будет удалена после 2022-06-01 - ec2_key — опция
waitне действовала и будет удалена после 2022-06-01 - ec2_key — опция
wait_timeoutобъявлена устаревшей и будет удалена в одном из последующих выпусков. Она не действует начиная с Ansible 2.5. - ec2_key — опция
waitобъявлена устаревшей и будет удалена в одном из последующих выпусков. Она не действует начиная с Ansible 2.5. - ec2_lc — опция
associate_public_ip_addressне действовала и будет удалена после 2022-06-01 - ec2_tag — опция
listобъявлена устаревшей в пользу ec2_tag_info - ec2_tag — поддержка
listв качестве состояния объявлена устаревшей и будет удалена в одном из последующих выпусков. Для получения тегов ресурса EC2 можно использоватьec2_tag_info.
Исправления ошибок
- aws_ec2 — исправлена идемпотентность при управлении тегами
- aws_ec2 — исправлена идемпотентность при включённых метриках
- aws_s3 — удаляются объекты и маркеры удаления, чтобы можно было удалять бакеты с включённым управлением версиями.
- aws_s3 — выполняется ожидание появления бакета перед настройкой списка управления доступом.
- cloudformation_info — исправлена ошибка KeyError при возврате сведений о стеке или стеках.
- ec2_asg — обеспечено соблюдение
waitпри операциях замены - ec2_launch_template — выходные данные дополнены полями latest_version и default_version в соответствии с документацией
- ec2_transit_gateway — перед обработкой ClientError при описании транзитных шлюзов используется AWSRetry
- ec2_transit_gateway — исправлена проблема, из-за которой значение yes параметра auto_attach не учитывалось (https://github.com/ansible/ansible/issues/61907)
- ec2_vol — исправлена ошибка фильтрации
- s3_bucket — добавлена обработка ответа XNotImplemented для поддержки NetApp StorageGRID.
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/amazon/aws/docsite/CHANGELOG.html