Руководство по переносу Ansible 9
- Плейбук
- Командная строка
- Устаревшее
- Модули
- Плагины
- Перенос пользовательских скриптов
- Сети
- Руководство по переносу для версии v9.11.0
- Руководство по переносу для версии v9.10.0
- Руководство по переносу для версии v9.9.0
- Руководство по переносу для версии v9.8.0
- Руководство по переносу для версии v9.7.0
- Руководство по переносу для версии v9.6.0
- Руководство по переносу для версии v9.5.1
- Руководство по переносу для версии v9.4.0
- Руководство по переносу для версии v9.3.0
- Руководство по переносу для версии v9.2.0
- Руководство по переносу для версии v9.1.0
- Руководство по переносу для версии v9.0.0
Ansible 9 основан на Ansible-core 2.16.
Мы рекомендуем прочитать эту страницу вместе с Журналом изменений Ansible 9, чтобы понять, какие обновления вам могут потребоваться.
Плейбук
-
Условные выражения — из-за устранения уязвимости CVE-2023-5764 в ansible-core 2.16.1, условные выражения с вложенными блоками шаблонов могут завершаться с сообщением «
Conditional is marked as unsafe, and cannot be evaluated.», когда вложенный шаблон обращается к данным из ненадежных источников, таких как результаты модулей или переменные, помеченные!unsafe. Условные выражения с вложенными шаблонами могут быть источником вредоносного внедрения шаблонов при ссылке на ненадежные данные, и их почти всегда можно переписать без вложенных шаблонов. Условные выражения задач плейбука, такие какwhenиuntil, уже давно показывают предупреждения о нежелательности использования вложенных шаблонов в условных выражениях; это предупреждение также распространяется на внезадачные условные выражения, такие как действиеassert.- name: task with a module result (always untrusted by Ansible) shell: echo "hi mom" register: untrusted_result # don't do it this way... # - name: insecure conditional with embedded template consulting untrusted data # assert: # that: '"hi mom" is in {{ untrusted_result.stdout }}' - name: securely access untrusted values directly as Jinja variables instead assert: that: '"hi mom" is in untrusted_result.stdout'
Командная строка
Устаревшее
Модули
Удалённые модули
Уведомления об устаревании
Заметные изменения в модулях
Плагины
Перенос пользовательских скриптов
Сети
Руководство по переносу для версии v9.11.0
Устаревшие возможности
- Коллекция
ngine_io.exoscaleустарела. Она будет удалена из Ansible 11, если никто не начнёт её поддерживать до Ansible 11. Более подробную информацию см. в Процессе удаления коллекций для неподдерживаемых коллекций (https://forum.ansible.com/t/2572). - Коллекция sensu.sensu_go будет удалена из Ansible 12 из-за нарушений требований к включению Ansible. У коллекции есть нерешённые ошибки проверки работоспособности. Более подробную информацию, включая то, как это можно отменить, см. в Процессе удаления коллекций для коллекций, не удовлетворяющих требованиям к коллекциям (https://forum.ansible.com/t/8380).
Руководство по переносу для версии v9.10.0
Критические изменения
community.mysql
- Коллекция — поддержка коннектора mysqlclient устарела — используйте вместо него коннектор PyMySQL! Мы прекратим тестирование на его совместимость в версии коллекции 4.0.0 и удалим соответствующий код в 5.0.0 (https://github.com/ansible-collections/community.mysql/issues/654).
- mysql_info — возвращаемое переменной
users_infoзначение фильтраplugin_auth_stringсодержит хэшированный пароль и вводит в заблуждение; оно будет удалено из community.mysql 4.0.0. Используйте вместо него значение возвратаplugin_hash_string(https://github.com/ansible-collections/community.mysql/pull/629). - mysql_user — псевдоним
userаргументаnameустарел и будет удалён в версии коллекции 5.0.0. Используйте вместо него аргументname.
Устаревшие возможности
community.vmware
- vmware_cluster — модуль устарел и будет удалён в community.vmware 6.0.0 (https://github.com/ansible-collections/community.vmware/pull/2143).
- vmware_cluster_drs — модуль устарел и будет удалён в community.vmware 6.0.0 (https://github.com/ansible-collections/community.vmware/pull/2136).
- vmware_cluster_vcls — модуль устарел и будет удалён в community.vmware 6.0.0 (https://github.com/ansible-collections/community.vmware/pull/2156).
Руководство по переносу для версии v9.9.0
Известные проблемы
community.docker
- docker_container — при указании MAC-адреса для сети контейнера, если сеть присоединяется после создания контейнера (например, из-за проверок идемпотентности), MAC-адрес в некоторых случаях игнорируется Docker Daemon (https://github.com/ansible-collections/community.docker/pull/933).
Устаревшие возможности
community.docker
- Коллекция устарела, и больше не поддерживаются все версии ansible-core, которые сейчас находятся в статусе окончания поддержки, согласно матрице поддержки ansible-core . Это означает, что в следующем основном выпуске коллекции не будет поддерживаться ansible-core 2.11, ansible-core 2.12, ansible-core 2.13 и ansible-core 2.14.
community.routeros
- Коллекция устарела, и больше не поддерживаются все версии Ansible/ansible-base/ansible-core, которые сейчас находятся в статусе окончания поддержки, согласно матрице поддержки ansible-core . Это означает, что в следующем основном выпуске коллекции не будет поддерживаться Ansible 2.9, ansible-base 2.10, ansible-core 2.11, ansible-core 2.12, ansible-core 2.13 и ansible-core 2.14.
community.sops
- Коллекция устарела, и больше не поддерживаются все версии Ansible/ansible-base/ansible-core, которые сейчас находятся в статусе окончания поддержки, согласно матрице поддержки ansible-core . Это означает, что в следующем основном выпуске коллекции не будет поддерживаться Ansible 2.9, ansible-base 2.10, ansible-core 2.11, ansible-core 2.12, ansible-core 2.13 и ansible-core 2.14.
Руководство по переносу для версии v9.8.0
Добавленные коллекции
- ieisystem.inmanage (версия 2.0.0)
- vmware.vmware (версия 1.3.0)
Основные изменения
fortinet.fortios
- Добавлен файл sanity_test.yaml для запуска тестов CI в GitHub.
- Поддержка Ansible-core 2.17.
- Поддержка новых версий FOS 7.4.4.
Устаревшие возможности
- Коллекция
frr.frrустарела. Она будет удалена из Ansible 11, если никто не начнёт её поддерживать до Ansible 11. Более подробную информацию см. в Процессе удаления коллекций для неподдерживаемых коллекций (https://forum.ansible.com/t/6243). - Коллекция
openvswitch.openvswitchустарела. Она будет удалена из Ansible 11, если никто не начнёт её поддерживать до Ansible 11. Более подробную информацию см. в Процессе удаления коллекций для неподдерживаемых коллекций (https://forum.ansible.com/t/6245).
Руководство по переносу для v9.7.0
Известные проблемы
community.general
- homectl - модуль не работает под Python 3.13 и новее, так как он полагается на удалённый
cryptмодуль стандартной библиотеки (https://github.com/ansible-collections/community.general/issues/4691, https://github.com/ansible-collections/community.general/pull/8497). - udm_user - модуль не работает под Python 3.13 и новее, так как он полагается на удалённый
cryptмодуль стандартной библиотеки (https://github.com/ansible-collections/community.general/issues/4690, https://github.com/ansible-collections/community.general/pull/8497).
Основные изменения
containers.podman
- Добавлены mount и unmount для томов
- Добавлены несколько подсетей для сетей
- Добавлены новые параметры для podman_container
- Добавлены новые параметры для модуля pod
- Добавлен podman search
- Улучшена идемпотентность для сетевых операций в podman_container
- Переработана идемпотентность для модуля Podman Pod
Удаленные функции
community.grafana
- удален устаревший
messageаргумент вgrafana_dashboard
Руководство по переносу для v9.6.0
Добавленные коллекции
- kaytus.ksmanage (версия 1.2.1)
Известные проблемы
community.docker
-
Обратите внимание, что исправление для requests 2.32.0, включенное в community.docker 3.10.1, исправляет только проблемы с встроенным Docker SDK для Python. Модули и плагины, использующие Docker SDK для Python, по-прежнему могут давать сбои из-за того, что SDK в настоящее время несовместим с requests 2.32.0.
Если у вас по-прежнему возникают проблемы с requests 2.32.0, такие как сообщения об ошибках, подобные
Not supported URL scheme http+docker, ограничьте использование requests до<2.32.0.
Изменения, требующие переработки
community.ciscosmb
- в фактах интерфейса «bandwith» изменено на «bandwidth»
Устаревшие функции
amazon.aws
- 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).
community.crypto
- фрагмент документации acme - фрагмент документации по умолчанию
community.crypto.acme[.documentation]устарел и будет удален из community.crypto 3.0.0. Замените его на новые фрагментыcommunity.crypto.acme.basicиcommunity.crypto.acme.account(https://github.com/ansible-collections/community.crypto/pull/735). - модульные утилиты acme.backends - метод
get_cert_information()для бэкенда криптографии ACME должен быть реализован начиная с community.crypto 3.0.0 (https://github.com/ansible-collections/community.crypto/pull/736). - модульные утилиты crypto.module_backends.common - модульные утилиты
crypto.module_backends.commonустарели и будут удалены из community.crypto 3.0.0. Используйте улучшенную утилитуargspecвместо нее (https://github.com/ansible-collections/community.crypto/pull/749).
community.docker
- docker_compose - Модуль Docker Compose v1 устарел и будет удалён из community.docker 4.0.0. Перейдите к модулю
community.docker.docker_compose_v2, который работает с Docker Compose v2 (https://github.com/ansible-collections/community.docker/issues/823, https://github.com/ansible-collections/community.docker/pull/833). - различные модули и плагины - параметр
ssl_versionустарел и будет удален из community.docker 4.0.0. Он уже удален из Docker SDK для Python 7.0.0, и раньше был необходим только для решения проблем с SSL/TLS (https://github.com/ansible-collections/community.docker/pull/853).
Руководство по переносу для v9.5.1
Основные изменения
containers.podman
- Добавлена поддержка quadlet для модулей Podman
fortinet.fortios
- Добавлены заметки для модулей резервного копирования в документации в модулях monitor и monitor_fact.
- Поддерживаются новые версии FOS 7.4.2 и 7.4.3, и поддержка типа данных mac_address в коллекции.
- Обновление документации для поддерживаемых версий с последней до фиксированной версии.
- Обновление требуемой версии ansible до 2.15.
Устаревшие функции
community.crypto
- модульные утилиты acme.backends - начиная с community.crypto, все реализации
CryptoBackendдолжны переопределятьget_ordered_csr_identifiers(). Текущая реализация по умолчанию, которая просто сортирует результатget_csr_identifiers(), будет удалена (https://github.com/ansible-collections/community.crypto/pull/725).
community.general
- плагин обратной связи hipchat - служба hipchat прекратила работу, а самохостящая версия прекратила поддержку с 2020 года. Поэтому плагин обратной связи устарел и будет удалён из community.general 10.0.0, если никто не предоставит убедительных причин для его сохранения (https://github.com/ansible-collections/community.general/issues/8184, https://github.com/ansible-collections/community.general/pull/8189).
community.vmware
- vmware_guest_tools_info -
vm_tools_install_statusбудет удалено из следующей основной версии (5.0.0) коллекции, так как вызов API, предоставляющий эту информацию, устарел в VMware. Используйтеvm_tools_running_status/vm_tools_version_statusвместо этого (https://github.com/ansible-collections/community.vmware/issues/2033).
Руководство по переносу для v9.4.0
Устаревшие функции
amazon.aws
- iam_role_info - в релизе после 2026-05-01 пути должны начинаться и заканчиваться с
/(https://github.com/ansible-collections/amazon.aws/pull/1998).
Руководство по портированию для v9.3.0
Основные изменения
community.mysql
- Версия коллекции 2.*.* устарела, больше не будут производиться исправления ошибок. Пожалуйста, рассмотрите возможность обновления до последней версии.
fortinet.fortios
- Обновите все значения булевых переменных на true/false в документации и примерах.
- Обновите документ log_fact.
- Обновите сообщение о несоответствии версий с диапазонами версий.
- Обновите требуемую версию Ansible до 2.14.
- Обновите поддерживаемые диапазоны версий вместо конкретных номеров версий, чтобы уменьшить размер коллекции.
Устаревшие функции
- Коллекция
inspur.smсчитается не поддерживаемой и будет удалена из Ansible 11, если никто не начнёт её поддерживать до Ansible 11. Подробнее см. Процесс удаления устаревших коллекций, включая информацию о том, как это отменить (https://forum.ansible.com/t/2854). - Коллекция
netapp.storagegridсчитается не поддерживаемой и будет удалена из Ansible 11, если никто не начнёт её поддерживать до Ansible 11. Подробнее см. Процесс удаления устаревших коллекций, включая информацию о том, как это отменить (https://forum.ansible.com/t/2811). - Коллекция
purestorage.fusionустарела. Она будет удалена из Ansible 10, если никто не начнёт её поддерживать до Ansible 10. Подробнее см. Процесс удаления устаревших коллекций (https://forum.ansible.com/t/3712).
community.crypto
- openssl_csr_pipe, openssl_privatekey_pipe, x509_certificate_pipe - текущее поведение режима проверки устарело и изменится в community.crypto 3.0.0. Текущее поведение аналогично модулям без
_pipe: если объект нужно (пере)генерировать, устанавливается только статусchanged, но объект не обновляется. Начиная с community.crypto 3.0.0, модули будут игнорировать режим проверки и всегда действовать так, как если бы режим проверки не был активен. Это поведение можно уже сейчас реализовать, добавивcheck_mode: falseв задачу. Если вы считаете, что это нарушает ваш случай использования этого модуля, пожалуйста, создайте проблему в репозитории community.crypto (https://github.com/ansible-collections/community.crypto/issues/712, https://github.com/ansible-collections/community.crypto/pull/714).
Руководство по портированию для v9.2.0
Добавленные коллекции
- community.library_inventory_filtering_v1 (версия 1.0.0)
Известные проблемы
dellemc.openmanage
- idrac_firmware - Проблема(279282) - Этот модуль не поддерживает обновление прошивки с использованием HTTP, HTTPS и FTP-общих папок с аутентификацией на iDRAC8.
- idrac_network_attributes - Проблема(279049) - Если для параметра
ome_network_attributesпредоставлены недопустимые значения, этот модуль не выдает корректное сообщение об ошибке. - ome_device_network_services - Проблема(212681) - Модуль не предоставляет правильное сообщение об ошибке, если для следующих параметров предоставлены недопустимые значения: port_number, community_name, max_sessions, max_auth_retries и idle_timeout.
- ome_device_power_settings - Проблема(212679) - Модуль отображает следующее сообщение, если значение, предоставленное для параметра
power_cap, не находится в допустимом диапазоне от 0 до 32767,Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI. - ome_device_quick_deploy - Проблема(275231) - Этот модуль не развертывает новую конфигурацию в слот с отключенным IPv6.
- ome_diagnostics - Проблема(279193) - Экспорт журналов коллекции SupportAssist в местоположение общего доступа завершается неудачно на версии OME 4.0.0.
- ome_smart_fabric_uplink - Проблема(186024) - Модуль поддерживается OpenManage Enterprise Modular, однако он не позволяет создавать несколько uplink с одинаковым именем. Если uplink создаётся с тем же именем, что и существующий uplink, то существующий uplink изменяется.
Основные изменения
community.docker
- Коллекция
community.dockerтеперь зависит от коллекцииcommunity.library_inventory_filtering_v1. Эта утилитарная коллекция предоставляет функциональность фильтрации хостов для плагинов инвентаризации. Если вы используете пакет Ansible community, обе коллекции включены, и вам не нужно ничего делать. Если вы устанавливаете коллекцию сansible-galaxy collection install, она будет установлена автоматически. Если вы устанавливаете коллекцию, копируя файлы коллекции в место, где Ansible-core может её найти, например, клонируя репозиторий Git, вам нужно убедиться, что вы также установили зависимость, если вы используете плагины инвентаризации (https://github.com/ansible-collections/community.docker/pull/698).
community.hashi_vault
- requirements - пакет
requests, необходимый дляhvac, теперь имеет более ограниченный диапазон для этой коллекции в определённых случаях использования из-за нарушающих безопасность изменений вansible-core, которые были обратно перенесены (https://github.com/ansible-collections/community.hashi_vault/pull/416).
dellemc.openmanage
- Все модули OME улучшены для поддержки переменных среды
OME_USERNAMEиOME_PASSWORDв качестве резервного варианта для учетных данных. - Все модули iDRAC и Redfish улучшены для поддержки переменных среды
IDRAC_USERNAMEиIDRAC_PASSWORDв качестве резервного варианта для учетных данных. - idrac_certificates - Модуль улучшен для поддержки импорта и экспорта
CUSTOMCERTIFICATE. - idrac_gather_facts - Данный модуль улучшен для поддержки защищенного загрузки.
- idrac_license - Введён модуль для настройки лицензий iDRAC.
infoblox.nios_modules
- Обновление поддержки версии Ansible с 2.13 до 2.16.
- Обновление поддержки версии Python с 3.8 до 3.10.
Устаревшие функции
community.dns
- Плагины инвентаризации hetzner_dns_records и hosttech_dns_records - опция
filtersбыла переименована вsimple_filters. Старое имя перестанет работать в community.hrobot 2.0.0 (https://github.com/ansible-collections/community.dns/pull/181).
community.docker
- docker_container - значение по умолчанию
ignoreдля параметраimage_name_mismatchустарело и будет переключено наrecreateв community.docker 4.0.0. Будет выводиться предупреждение об устаревании в ситуациях, где используется значение по умолчанию, и где поведение изменится после изменения значения по умолчанию (https://github.com/ansible-collections/community.docker/pull/703).
community.general
- consul_acl - модуль устарел и будет удалён в community.general 10.0.0.
consul_tokenиconsul_policyмогут быть использованы вместо него (https://github.com/ansible-collections/community.general/pull/7901).
community.hrobot
- Плагин инвентаризации robot - опция
filtersбыла переименована вsimple_filters. Старое имя перестанет работать в community.hrobot 2.0.0 (https://github.com/ansible-collections/community.hrobot/pull/94).
Руководство по портированию для v9.1.0
Известные проблемы
dellemc.openmanage
- idrac_firmware - Проблема(279282) - Этот модуль не поддерживает обновление прошивки с использованием HTTP, HTTPS и FTP-общих папок с аутентификацией на iDRAC8.
- idrac_network_attributes - Проблема(279049) - Если для параметра
ome_network_attributesпредоставлены недопустимые значения, этот модуль не выдает корректное сообщение об ошибке. - ome_device_network_services - Проблема(212681) - Модуль не предоставляет правильное сообщение об ошибке, если для следующих параметров предоставлены недопустимые значения: port_number, community_name, max_sessions, max_auth_retries и idle_timeout.
- ome_device_power_settings - Проблема(212679) - Модуль отображает следующее сообщение, если значение, предоставленное для параметра
power_cap, не находится в допустимом диапазоне от 0 до 32767,Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI. - ome_device_quick_deploy - Проблема(275231) - Этот модуль не развертывает новую конфигурацию в слот с отключенным IPv6.
- ome_diagnostics - Проблема(279193) - Экспорт журналов коллекции SupportAssist в местоположение общего доступа завершается неудачно на версии OME 4.0.0.
- ome_smart_fabric_uplink - Проблема(186024) - Модуль поддерживается OpenManage Enterprise Modular, однако он не позволяет создавать несколько uplink с одинаковым именем. Если uplink создаётся с тем же именем, что и существующий uplink, то существующий uplink изменяется.
Изменения, вносящие несовместимость
Ansible-core
- assert - Вложенная шаблонизация может привести к невозможности вычисления условного оператора. См. руководство по портированию для получения дополнительной информации.
Руководство по переносу для v9.0.0
Добавленные коллекции
- ibm.storage_virtualize (версия 2.1.0)
- telekom_mms.icinga_director (версия 1.34.1)
Известные проблемы
Ansible-core
- ansible-galaxy - завершается в середине установки роли, если эта роль содержит внутренние классы Java (файлы с $ в имени файла). Это сделано по умолчанию, чтобы исключить временные или резервные файлы. (https://github.com/ansible/ansible/pull/81553).
- ansible-test - Тест
pep8sanity не может обнаружить проблемы с отступами в f-строках (E201, E202) в Python 3.10 и 3.11. Они правильно обнаруживаются в Python 3.12. См. (https://github.com/PyCQA/pycodestyle/issues/1190).
community.crypto
- Разметка Ansible будет отображаться в сыром виде в текстовом выводе ansible-doc для ansible-core до версии 2.15. Если у вас возникли проблемы с расшифровкой разметки документации, пожалуйста, обновитесь до ansible-core 2.15 (или новее) или прочитайте документацию HTML по адресу https://docs.ansible.com/ansible/devel/collections/community/crypto/.
community.dns
- Разметка Ansible будет отображаться в сыром виде в текстовом выводе ansible-doc для ansible-core до версии 2.15. Если у вас возникли проблемы с расшифровкой разметки документации, пожалуйста, обновитесь до ansible-core 2.15 (или новее) или прочитайте документацию HTML по адресу https://docs.ansible.com/ansible/devel/collections/community/dns/.
community.docker
- Разметка Ansible будет отображаться в сыром виде в текстовом выводе ansible-doc для ansible-core до версии 2.15. Если у вас возникли проблемы с расшифровкой разметки документации, пожалуйста, обновитесь до ansible-core 2.15 (или новее) или прочитайте документацию HTML по адресу https://docs.ansible.com/ansible/devel/collections/community/docker/.
community.general
- Разметка Ansible будет отображаться в сыром виде в текстовом выводе ansible-doc для ansible-core до версии 2.15. Если у вас возникли проблемы с расшифровкой разметки документации, пожалуйста, обновитесь до ansible-core 2.15 (или новее) или прочитайте документацию HTML по адресу https://docs.ansible.com/ansible/devel/collections/community/general/ (https://github.com/ansible-collections/community.general/pull/6539).
community.hrobot
- Разметка Ansible будет отображаться в сыром виде в текстовом выводе ansible-doc для ansible-core до версии 2.15. Если у вас возникли проблемы с расшифровкой разметки документации, пожалуйста, обновитесь до ansible-core 2.15 (или новее) или прочитайте документацию HTML по адресу https://docs.ansible.com/ansible/devel/collections/community/hrobot/.
community.routeros
- Разметка Ansible будет отображаться в сыром виде в текстовом выводе ansible-doc для ansible-core до версии 2.15. Если у вас возникли проблемы с расшифровкой разметки документации, пожалуйста, обновитесь до ansible-core 2.15 (или новее) или прочитайте документацию HTML по адресу https://docs.ansible.com/ansible/devel/collections/community/routeros/.
community.sops
- Разметка Ansible будет отображаться в сыром виде в текстовом выводе ansible-doc для ansible-core до версии 2.15. Если у вас возникли проблемы с расшифровкой разметки документации, пожалуйста, обновитесь до ansible-core 2.15 (или новее) или прочитайте документацию HTML по адресу https://docs.ansible.com/ansible/devel/collections/community/sops/.
dellemc.openmanage
- ca_path отсутствует - Проблема(275740) - Роли idrac_attributes, redfish_storage_volume и idrac_server_powerstate имеют отсутствующий параметр ca_path.
- idrac_firmware - Проблема(276335) - Этот модуль завершается ошибкой на версии Python 3.11.x с NFS-разделями. Используйте другую версию Python или другой тип раздела.
- idrac_firmware - Проблема(279282) - Этот модуль не поддерживает обновление микропрограммы с помощью HTTP, HTTPS и FTP-разделов с аутентификацией на iDRAC8.
- idrac_network_attributes - Проблема(279049) - Если для параметра
ome_network_attributesпредоставлены недопустимые значения, то этот модуль не выдает правильное сообщение об ошибке. - idrac_redfish_storage_controller - Проблема(256164) - Если для одного из атрибутов в предоставленном списке атрибутов для конфигурации контроллера предоставлено неправильное значение, то этот модуль не завершается с ошибкой.
- ome_device_network_services - Проблема(212681) - Модуль не выдает соответствующее сообщение об ошибке, если для следующих параметров предоставлены недопустимые значения — port_number, community_name, max_sessions, max_auth_retries и idle_timeout.
- ome_device_power_settings - Проблема(212679) - Модуль отображает следующее сообщение, если значение для параметра
power_capне находится в допустимом диапазоне от 0 до 32767,Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI. - ome_device_quick_deploy - Проблема(275231) - Этот модуль не развертывает новую конфигурацию в слот, у которого отключен IPv6.
- ome_smart_fabric_uplink - Проблема(186024) - Несмотря на то, что модуль поддерживается OpenManage Enterprise Modular, он не позволяет создавать несколько каналов связи с одинаковым именем. Если канал связи создается с таким же именем, что и существующий канал связи, существующий канал связи изменяется.
Изменения, нарушающие обратную совместимость
Ansible-core
- Любой плагин, использующий систему конфигурации и запись
cliдля использованияtimeoutиз командной строки, увидит изменение значения, если пользователь настроил его любым из способов с более низким приоритетом. Если вы полагаетесь на это поведение для использования глобального/общего тайм-аута из константы DEFAULT_TIMEOUT, пожалуйста, обратитесь к документации по конфигурации плагинов, чтобы добавить перекрывающиеся записи. - ansible-test - Тестовые плагины, которые используют контейнеры, больше не поддерживают повторное использование запущенных контейнеров. Предыдущее поведение было незадокументированной, непроверенной функцией.
- Модуль service больше не будет постоянно настраивать переменные/флаги для openbsd при выполнении операций enable/disable, этот модуль никогда не предназначался для выполнения этого типа работы, только для управления самим состоянием службы. Вместо этого следует создать и использовать модуль rcctl_config или аналогичный.
amazon.aws
- Коллекция 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).
community.aws
- Коллекция community.aws прекратила поддержку
botocore<1.29.0иboto3<1.26.0. Большинство модулей будут продолжать работать со старыми версиями AWS SDK, однако совместимость со старыми версиями SDK не гарантируется и не будет проверяться. При использовании старых версий SDK Ansible будет выдавать предупреждение (https://github.com/ansible-collections/amazon.aws/pull/1763). - aws_region_info - Модуль был перемещен из коллекции
community.aws. Playbooks, использующие полное имя коллекции для этого модуля, должны быть обновлены для использованияamazon.aws.aws_region_info. - aws_s3_bucket_info - Модуль был перемещен из коллекции
community.aws. Playbooks, использующие полное имя коллекции для этого модуля, должны быть обновлены для использованияamazon.aws.aws_s3_bucket_info. - community.aws collection - из-за объявления 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).
- iam_access_key - Модуль был перемещен из коллекции
community.aws. Playbooks, использующие полное имя коллекции для этого модуля, должны быть обновлены для использованияamazon.aws.iam_access_key. - iam_access_key_info - Модуль был перемещен из коллекции
community.aws. Playbooks, использующие полное имя коллекции для этого модуля, должны быть обновлены для использованияamazon.aws.iam_access_key_info. - iam_group - Модуль был перемещен из коллекции
community.aws. Playbooks, использующие полное имя коллекции для этого модуля, должны быть обновлены для использованияamazon.aws.iam_group(https://github.com/ansible-collections/community.aws/pull/1945). - iam_managed_policy - Модуль был перемещен из коллекции
community.aws. Playbooks, использующие полное имя коллекции для этого модуля, должны быть обновлены для использованияamazon.aws.iam_managed_policy(https://github.com/ansible-collections/community.aws/pull/1954). - iam_mfa_device_info - Модуль был перемещен из коллекции
community.aws. Playbooks, использующие полное имя коллекции для этого модуля, должны быть обновлены для использованияamazon.aws.iam_mfa_device_info(https://github.com/ansible-collections/community.aws/pull/1953). - iam_password_policy - Модуль был перемещен из коллекции
community.aws. Playbooks, использующие полное имя коллекции для этого модуля, должны быть обновлены для использованияamazon.aws.iam_password_policy. - iam_role - Модуль был перемещен из коллекции
community.aws. Playbooks, использующие полное имя коллекции для этого модуля, должны быть обновлены для использованияamazon.aws.iam_role(https://github.com/ansible-collections/community.aws/pull/1948). - iam_role_info - Модуль был перемещен из коллекции
community.aws. Playbooks, использующие полное имя коллекции для этого модуля, должны быть обновлены для использованияamazon.aws.iam_role_info(https://github.com/ansible-collections/community.aws/pull/1948). - s3_bucket_info - Модуль был перемещен из коллекции
community.aws. Playbooks, использующие полное имя коллекции для этого модуля, должны быть обновлены для использованияamazon.aws.s3_bucket_info. - sts_assume_role - Модуль был перемещен из коллекции
community.aws. Playbooks, использующие полное имя коллекции для этого модуля, должны быть обновлены для использованияamazon.aws.sts_assume_role.
community.general
- Плагин lookup collection_version - удален код совместимости для ansible-base 2.10 и ansible-core 2.11 (https://github.com/ansible-collections/community.general/pull/7269).
- gitlab_project - добавлена поддержка
default_branchдля обновления проекта. Если вы использовали модуль до сих пор сdefault_branchдля обновления проекта, значениеdefault_branchигнорировалось. Убедитесь, что вы либо не передаете значение, если не уверены, какое именно значение вы хотите использовать, чтобы избежать непредвиденных изменений, нарушающих обратную совместимость (https://github.com/ansible-collections/community.general/pull/7158). - Плагин обратного вызова selective - удален код совместимости для Ansible 2.9 и ansible-core 2.10 (https://github.com/ansible-collections/community.general/pull/7269).
- vardict module utils -
VarDictбольше не будет принимать переменные с именами_var,get_metaиas_dict(https://github.com/ansible-collections/community.general/pull/6647). - version module util - удалено резервное копирование для ansible-core 2.11. Все модули и плагины, которые используют версии коллекций, больше не работают с ansible-core 2.11 (https://github.com/ansible-collections/community.general/pull/7269).
community.hashi_vault
- Минимальная необходимая версия
hvacтеперь1.2.1(https://docs.ansible.com/ansible/devel/collections/community/hashi_vault/docsite/user_guide.html#hvac-version-specifics).
community.vmware
- Удалена поддержка версии ansible-core < 2.15.0.
- vmware_dvs_host - удалены значения по умолчанию для
vmnicsиlag_uplinks(https://github.com/ansible-collections/community.vmware/issues/1516). - vmware_host_acceptance - удален
acceptance_levelи использованы его опции вstate. Это также означает, что больше не будет состоянияlist. Чтобы получить информацию о текущем уровне принятия, используйте новый модульvmware_host_acceptance_info(https://github.com/ansible-collections/community.vmware/issues/1872). - vmware_vm_info - добавлена длина префикса к IP-адресам в vm_network, поэтому теперь они отображаются, например, как 10.76.33.228/24, а не просто 10.76.33.228 (https://github.com/ansible-collections/community.vmware/issues/1761).
dellemc.enterprise_sonic
- sonic_aaa - Добавлен атрибут default_auth в argspec для замены удаленных атрибутов group и local. Это изменение позволяет упорядоченную аутентификацию входа в систему. (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/195).
hetzner.hcloud
- Отказ от поддержки ansible-core 2.12
- Отказ от поддержки python 3.7
- hcloud-python 1.20.0 теперь требуется для полной совместимости
- плагин инвентаризации - Не устанавливайте переменные изображения сервера (
image_id,image_os_flavorиimage_name) при отсутствии определения изображения сервера.
Основные изменения
amazon.aws
- 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.
chocolatey.chocolatey
- win_chocolatey - добавление опций для указания контрольных сумм
- win_chocolatey_facts - добавление опции фильтра / подмножества (gather_subset)
cisco.ios
- В этом релизе удалены ранее устаревшие модули и несколько атрибутов из этой коллекции. Подробности см. в разделе «Удаленные функции».
cisco.nxos
- Подробности см. в разделе «Удаленные функции».
- В этом релизе удалено четыре из ранее устаревших модулей из этой коллекции.
cloudscale_ch.cloud
- Минимальная требуемая версия Ansible повышена до 2.13.0
community.mysql
- Коллекция community.mysql больше не поддерживает
ansible-core 2.12иansible-core 2.13. Хотя мы не принимаем активных мер для предотвращения использования, и нет планов по внедрению несовместимого кода в модули, мы прекратим тестирование этих версий. Обе версии находятся или скоро будут находиться в конце жизненного цикла, и если вы все еще используете их, рекомендуется как можно скорее обновить доlatest Ansible / ansible-core 2.15 or later(https://github.com/ansible-collections/community.mysql/pull/574). - mysql_role - Значение по умолчанию аргумента
column_case_sensitiveбудет изменено наtrueв community.mysql 4.0.0. Если ваш плейбук ожидал автоматического преобразования столбца в верхний регистр для привилегий ролей, вы должны явно установить это значение в false (https://github.com/ansible-collections/community.mysql/issues/578). - mysql_user - Значение по умолчанию аргумента
column_case_sensitiveбудет изменено наtrueв community.mysql 4.0.0. Если ваш плейбук ожидал автоматического преобразования столбца в верхний регистр для привилегий пользователей, вы должны явно установить это значение в false (https://github.com/ansible-collections/community.mysql/issues/577).
community.postgresql
- Модули postgres - минимальная поддерживаемая версия библиотеки psycopg2 составляет 2.5.1 (https://github.com/ansible-collections/community.postgresql/pull/556).
- postgresql_pg_hba - удален устаревший аргумент
order. Сортировкаsduзадана жёстко (https://github.com/ansible-collections/community.postgresql/pull/496). - postgresql_privs - удален устаревший аргумент
usage_on_types. Используйте опциюtypeаргументаtypeдля явного управления привилегиями типов PG (https://github.com/ansible-collections/community.postgresql/issues/208). - postgresql_query - удалены устаревшие аргументы
path_to_scriptиas_single_query. Используйте модульpostgresql_scriptдля выполнения запросов из скриптов (https://github.com/ansible-collections/community.postgresql/issues/189). - postgresql_user - перемещение удаления устаревшего аргумента
privsв community.postgresql 4.0.0 (https://github.com/ansible-collections/community.postgresql/issues/493). - postgresql_user - удален устаревший аргумент
groups. Используйте вместо него модульpostgresql_membership(https://github.com/ansible-collections/community.postgresql/issues/300).
community.sap
- все модули теперь являются перенаправлением на новую коллекцию community.sap_libs
community.vmware
- vmware_vasa - добавлен новый модуль для регистрации/удаления поставщика VASA
- vmware_vasa_info - добавлен новый модуль для получения информации о существующих поставщиках VASA
fortinet.fortimanager
- Поддержка всех версий FortiManager в 6.2, 6.4, 7.0, 7.2 и 7.4. 139 новых модулей.
- Поддержка аутентификации на основе токенов.
fortinet.fortios
- Добавление новой версии fortios 7.4.1.
- Добавление файла readthedocs.yaml.
- Форматирование содержимого файла changelog.yml.
- Улучшение функции
no_logв некоторых модулях; - Улучшение документации для добавления примечаний и примеров в Раздел «Вопросы и ответы» для модулей, использующих целые числа в качестве ключа mkey.
- Улучшение документации и примеров для
seq_numвfortios_router_static; - Улучшение документации для
member_pathво всех модулях; - Поддержка новых версий FOS.
- Обновление версии Ansible с 2.9 до 2.14.
- Обновление раздела «Вопросы и ответы» по настройке многофакторной аутентификации FortiToken;
- Обновление раздела «Вопросы и ответы» с решением проблемы Ansible всегда отправляет запросы GET/PUT как POST.
- Обновление файла requirement.txt для указания sphinx_rtd_theme==1.3.0
- обновление требуемой версии Ansible до 2.14.0 в файле runtime.yml.
grafana.grafana
- Добавление роли Grafana Server пользователем @gardar
- Настраиваемые группы пользователей агента пользователем @NormanJS
- Поддержка плагинов Grafana для локальной установки Grafana пользователем @ishanjainn
- Обновление сервиса для режима потока пользователем @bentonam
Удаленные коллекции
- cisco.nso (ранее включена версия: 1.0.3)
- community.fortios (ранее включена версия: 1.0.0)
- community.google (ранее включена версия: 1.0.0)
- community.skydive (ранее включена версия: 1.0.0)
- ngine_io.vultr (ранее включена версия: 1.1.3)
- servicenow.servicenow (ранее включена версия: 1.0.6)
Удаленные возможности
- Коллекция
cisco.nsoбыла признана не обновляемой и удалена из Ansible 9 (https://github.com/ansible-community/community-topics/issues/155). Пользователи по-прежнему могут установить эту коллекцию с помощьюansible-galaxy collection install cisco.nso. - Коллекция
community.fortiosбыла признана не обновляемой и удалена из Ansible 9 (https://github.com/ansible-community/community-topics/issues/162). Пользователи по-прежнему могут установить эту коллекцию с помощьюansible-galaxy collection install community.fortios. - Коллекция
community.googleбыла признана не обновляемой и удалена из Ansible 9 (https://github.com/ansible-community/community-topics/issues/160). Пользователи по-прежнему могут установить эту коллекцию с помощьюansible-galaxy collection install community.google. - Коллекция
community.skydiveбыла признана не обновляемой и удалена из Ansible 9 (https://github.com/ansible-community/community-topics/issues/171). Пользователи по-прежнему могут установить эту коллекцию с помощьюansible-galaxy collection install community.skydive. - Коллекция
ngine_io.vultrбыла признана не обновляемой и удалена из Ansible 9 (https://github.com/ansible-community/community-topics/issues/257). Пользователи по-прежнему могут установить эту коллекцию с помощьюansible-galaxy collection install ngine_io.vultr. - Коллекция servicenow.servicenow удалена из Ansible 9. Устаревшая коллекция servicenow.servicenow была удалена из Ansible 7, но случайно добавлена в Ansible 8. Подробности об обсуждении удаления см. в разделе обсуждения удаления. Пользователи по-прежнему могут установить эту коллекцию с помощью
ansible-galaxy collection install servicenow.servicenow.
ansible-core
- ActionBase - удален устаревший метод
_remote_checksum - PlayIterator - удалены устаревшие методы
cache_block_tasksиget_original_task - Удален устаревший класс
FileLock - Удалена поддержка Python 3.9 на контроллере. Требуется Python 3.10 или более поздняя версия.
- Удален
include, который устарел в Ansible 2.12. Используйтеinclude_tasksилиimport_tasksвместо него. -
Templar- удален устаревший параметрshared_loader_objметода__init__ -
fetch_url- удалена автоматическая отменаdecompressпри отсутствии gzip -
get_action_args_with_defaults- удален устаревший параметр методаredirected_names - ansible-test - Удалена поддержка удаленных целевых систем Windows 2012 и 2012-R2
- inventory_cache - удален устаревший параметр конфигурации ini
default.fact_caching_prefix, используйтеdefaults.fact_caching_prefixвместо него. - module_utils/basic.py - Удалена поддержка Python 3.5 в качестве удаленной версии. Теперь требуется Python 2.7 или Python 3.6 и выше.
- stat - удален неиспользуемый параметр
get_md5.
ansible.windows
- win_get_url - Удален устаревший псевдоним параметра
passwordd, используйтеurl_passwordвместо него. - win_get_url - Удалены устаревшие псевдонимы параметров
userиusername, используйтеurl_usernameвместо них. - win_package - Удален устаревший параметр модуля
ensure, используйтеstateвместо него. - win_package - Удален устаревший параметр модуля
productid, используйтеproduct_idвместо него. - win_package - Удалены устаревшие параметры модуля
username,user_name,password, иuser_password. Используйтеbecomeсbecome_flags: logon_type=new_credentials logon_flags=netcredentials_onlyв задаче вместо них для того же функционала. - win_reboot - Удалена проверка обратной совместимости, где
ignore_errors: trueбудет обрабатываться какignore_unreachable: trueв дальнейшем. В будущемignore_errors: trueбудет просто игнорировать ошибки, встреченные плагином, а не недоступный хост. Используйтеignore_unreachable: trueдля игнорирования этой ошибки, как и любой другой модуль. - win_regedit - Удалена поддержка использования
pathс косыми чертами в качестве разделителя ключей. Использование косых черт устарело с Ansible 2.9. Если в значенииwin_regeditpathиспользуются косые черты, убедитесь, что вы заменили косую черту/на обратную косую черту\. Если значение заключено в двойные кавычки, обратная косая черта должна быть удвоена. - win_updates - Удален устаревший псевдоним
blacklist, используйтеreject_listвместо него. - win_updates - Удален устаревший псевдоним
whitelist, используйтеaccept_listвместо него. - win_updates - Удален устаревший параметр модуля
use_scheduled_task. Этот параметр не изменял функциональность модуля и может быть безопасно удален из записи задачи. - win_uri - Удален устаревший псевдоним параметра
password, используйтеurl_passwordвместо него. - win_uri - Удалены устаревшие псевдонимы параметров
userиusername, используйтеurl_usernameвместо них.
cisco.ios
- Модуль ios_logging устарел в пользу ios_logging_global.
- Атрибут next_hop_self устарел для bgp_address_family с nexthop_self.
cisco.nxos
- Модуль nxos_bgp удален в этом релизе.
- Модуль nxos_bgp_af удален в этом релизе.
- Модуль nxos_bgp_neighbor удален в этом релизе.
- Модуль nxos_bgp_neighbor_af удален в этом релизе.
community.ciscosmb
- Удалены тесты для Python 2.6 и 2.7
- Удалены тесты для Ansible 2.9
community.general
- Коллекция больше не поддерживает ansible-core 2.11 и ansible-core 2.12. Части коллекции могут по-прежнему работать с этими версиями ansible-core, но другие могут не работать (https://github.com/ansible-collections/community.general/pull/7269).
- ansible_galaxy_install - поддержка Ansible 2.9 и ansible-base 2.10 удалена (https://github.com/ansible-collections/community.general/pull/7358).
- consul - если
state=absent, параметрыscript,ttl,tcp,http, иintervalбольше не могут быть указаны (https://github.com/ansible-collections/community.general/pull/7358). - gconftool2 -
state=getудален. Используйте модульcommunity.general.gconftool2_infoвместо него (https://github.com/ansible-collections/community.general/pull/7358). - gitlab_runner - удалено значение по умолчанию для параметра
access_level. Чтобы восстановить предыдущее поведение, явно задайте его значениеref_protected(https://github.com/ansible-collections/community.general/pull/7358). - htpasswd - удален код для passlib <1.6 (https://github.com/ansible-collections/community.general/pull/6901).
- manageiq_polices -
state=listудален. Используйте модульcommunity.general.manageiq_policies_infoвместо него (https://github.com/ansible-collections/community.general/pull/7358). - manageiq_tags -
state=listудален. Используйте модульcommunity.general.manageiq_tags_infoвместо него (https://github.com/ansible-collections/community.general/pull/7358). - mh.mixins.cmd module utils - класс
ArgFormatудален (https://github.com/ansible-collections/community.general/pull/7358). - mh.mixins.cmd module utils - миксин
CmdMixinудален. Используйтеcommunity.general.plugins.module_utils.cmd_runner.CmdRunnerвместо него (https://github.com/ansible-collections/community.general/pull/7358). - mh.mixins.cmd module utils - модуль утилит mh.mixins.cmd удален после удаления всего его содержимого (https://github.com/ansible-collections/community.general/pull/7358).
- mh.module_helper module utils - классы
CmdModuleHelperиCmdStateModuleHelperудалены. Используйтеcommunity.general.plugins.module_utils.cmd_runner.CmdRunnerвместо них (https://github.com/ansible-collections/community.general/pull/7358). - proxmox module utils - удалены неиспользуемые импорты (https://github.com/ansible-collections/community.general/pull/6873).
- xfconf - устаревший параметр
disable_factsбыл удален (https://github.com/ansible-collections/community.general/pull/7358).
community.hashi_vault
- Минимально поддерживаемая версия
ansible-coreтеперь2.14, поддержка2.13снята (https://github.com/ansible-collections/community.hashi_vault/pull/403).
community.vmware
- Удален модуль util
version(https://github.com/ansible-collections/community.vmware/issues/1639). - vmware_guest - удалено указание конфигурации CDROM в виде словаря, используйте список (https://github.com/ansible-collections/community.vmware/issues/1472).
- vmware_host_lockdown - удалены устаревшие состояния
absentиpresent(https://github.com/ansible-collections/community.vmware/issues/1517). - vmware_rest_client - удален устаревший метод
get_tag_by_category()(https://github.com/ansible-collections/community.vmware/issues/1898).
community.windows
- Удалены тесты для Server 2012 и Server 2012 R2, так как они достигли статуса окончания жизненного цикла от Microsoft. Эти версии ОС могут продолжать работать, но не будут тестироваться в CI.
- win_nssm - Удален устаревший параметр модуля
app_parameters, используйтеargumentsвместо него. - win_psmodule - Удален устаревший параметр модуля
url, используйтеcommunity.windows.win_psrepositoryдля управления репозиториями вместо него. - win_psmodule - Больше не будет удалять
repositoryуказанное приstate: absent, используйтеcommunity.windows.win_psrepositoryдля управления репозиториями вместо него. - win_scheduled_tasks - Удалена поддержка триггера
repetition, определённого как список записей словарей. Укажитеrepetitionв качестве значения словаря, а не списка словарей.
dellemc.openmanage
- Модуль
dellemc_get_firmware_inventoryудален и заменён на модульidrac_firmware_info. - Модуль
dellemc_get_system_inventoryудален и заменён на модульidrac_system_info.
hetzner.hcloud
- hcloud_datacenter_facts Удалён устаревший модуль фактов
- hcloud_floating_ip_facts Удалён устаревший модуль фактов
- hcloud_image_facts Удалён устаревший модуль фактов
- hcloud_location_facts Удалён устаревший модуль фактов
- hcloud_server_facts Удалён устаревший модуль фактов
- hcloud_server_type_facts Удалён устаревший модуль фактов
- hcloud_ssh_key_facts Удалён устаревший модуль фактов
- hcloud_volume_facts Удалён устаревший модуль фактов
Устаревшие функции
- Коллекция
community.azureсчитается неподдерживаемой и будет удалена из Ansible 10, если никто не начнет её поддерживать до Ansible 10. См. Процесс удаления неподдерживаемых коллекций для получения более подробной информации, в том числе о том, как это можно отменить (https://github.com/ansible-community/community-topics/issues/263). - Коллекция
hpe.nimbleсчитается неподдерживаемой и будет удалена из Ansible 10, если никто не начнет её поддерживать до Ansible 10. См. Процесс удаления неподдерживаемых коллекций для получения более подробной информации, в том числе о том, как это можно отменить (https://github.com/ansible-community/community-topics/issues/254). - Коллекция
netapp.azureсчитается неподдерживаемой и будет удалена из Ansible 10, если никто не начнет её поддерживать до Ansible 10. См. Процесс удаления неподдерживаемых коллекций для получения более подробной информации, в том числе о том, как это можно отменить (https://github.com/ansible-community/community-topics/issues/234). - Коллекция
netapp.elementswсчитается неподдерживаемой и будет удалена из Ansible 10, если никто не начнет её поддерживать до Ansible 10. См. Процесс удаления неподдерживаемых коллекций для получения более подробной информации, в том числе о том, как это можно отменить (https://github.com/ansible-community/community-topics/issues/235). - Коллекция
netapp.um_infoсчитается неподдерживаемой и будет удалена из Ansible 10, если никто не начнет её поддерживать до Ansible 10. См. Процесс удаления неподдерживаемых коллекций для получения более подробной информации, в том числе о том, как это можно отменить (https://github.com/ansible-community/community-topics/issues/244). - Коллекция
community.sapбыла переименована вcommunity.sap_libs. Пока обе коллекции включены в Ansible. Коллекция будет полностью удалена из Ansible 10. Обновите свои FQCN сcommunity.sapнаcommunity.sap_libs. - Коллекция
ibm.spectrum_virtualizeбыла переименована вibm.storage_virtualize. Пока обе коллекции включены в Ansible. Содержимоеibm.spectrum_virtualizeбудет заменено устаревшими перенаправлениями в Ansible 10.0.0. Коллекция будет полностью удалена из Ansible в конечном итоге. Обновите свои FQCN сibm.spectrum_virtualizeнаibm.storage_virtualize. - Коллекция
t_systems_mms.icinga_directorбыла переименована вtelekom_mms.icinga_director. Пока обе коллекции включены в Ansible. Содержимоеt_systems_mms.icinga_directorбыло заменено устаревшими перенаправлениями в Ansible 9.0.0. Коллекция будет полностью удалена из Ansible 11. Обновите свои FQCN сt_systems_mms.icinga_directorнаtelekom_mms.icinga_director.
ansible-core
- Устаревший параметр конфигурации ini
collections_paths, используйте единственное числоcollections_pathвместо него - Устарела переменная окружения
ANSIBLE_COLLECTIONS_PATHS, используйте единственное числоANSIBLE_COLLECTIONS_PATHвместо него - Плагины старых переменных, использующие точки входа
get_host_varsилиget_group_varsустарели. Плагин должен быть обновлён для наследования отBaseVarsPluginи определять методget_varsкак точку входа. - Поддержка Windows Server 2012 и 2012 R2 была удалена, так как срок поддержки от Microsoft истек 10 октября 2023 года. Эти версии Windows больше не будут тестироваться в этом выпуске Ansible, и нельзя гарантировать, что они будут продолжать работать в будущем.
-
Параметр конфигурации
STRING_CONVERSION_ACTIONустарел, так как он больше не используется в кодовом базисе Ansible Core. - Вариант «smart» для установки плагина подключения удаляется, поскольку его основная цель (выбор между ssh и paramiko) теперь неактуальна.
- Фильтры vault и unfault - устарел не документированный параметр
vaultidи будет удален в ansible-core 2.20. Используйтеvault_idвместо него. - yum_repository - устарел параметр «keepcache» (https://github.com/ansible/ansible/issues/78693).
amazon.aws
- ec2_instance - устаревание
tenancyиplacement_groupв пользу атрибутаplacement(https://github.com/ansible-collections/amazon.aws/pull/1825). - s3_object - поддержка передачи ключей объектов с префиксом
/устарела и будет удалена в релизе после 2025-12-01 (https://github.com/ansible-collections/amazon.aws/pull/1549).
ansible.netcommon
- libssh - опции ssh_*_args теперь помечены как удаляемые после 2026-01-01.
ansible.windows
- Добавлена предупреждение при использовании Server 2012 или 2012 R2 с модулем
setup. Эти ОС приближаются к концу срока поддержки и не будут тестироваться в CI, когда это произойдёт. - win_domain - Модуль устарел в пользу модуля
microsoft.ad.domain, модульansible.windows.win_domainбудет удален в релизе3.0.0этой коллекции. - win_domain_controller - Модуль устарел в пользу модуля
microsoft.ad.domain_controller, модульansible.windows.win_domain_controllerбудет удален в релизе3.0.0этой коллекции. - win_domain_membership - Модуль устарел в пользу модуля
microsoft.ad.membership, модульansible.windows.win_domain_membershipбудет удален в релизе3.0.0этой коллекции.
cisco.ios
- ios_snmp_server - устарела traps.envmon.fan, используйте traps.envmon.fan_enable
- ios_snmp_server - устарела traps.mpls_vpn, используйте traps.mpls
- ospfv2 - удалена passive_interface, используйте passive_interfaces (список интерфейсов)
cisco.iosxr
- Модуль iosxr_bgp устарел в пользу iosxr_bgp_global, iosxr_bgp_neighbor_address_family и iosxr_bgp_address_family.
- iosxr_l2_interfaces - устарела q_vlan, используйте qvlan (поддержка VLAN в строковом формате, например «any»)
community.ciscosmb
- Поддержка Python 2.6 и 2.7
- Поддержка Ansible 2.9
community.crypto
- get_certificate - значение по умолчанию
falseопцииasn1_base64устарело и будет изменено наtrueв community.crypto 3.0.0 (https://github.com/ansible-collections/community.crypto/pull/600).
community.general
- Модуль CmdRunner utils - устаревает формат
cmd_runner_fmt.as_default_type()(https://github.com/ansible-collections/community.general/pull/6601). - Модуль MH VarsMixin utils - устаревают
VarsMixinи поддерживающие классы в пользу простого модуля utilvardict(https://github.com/ansible-collections/community.general/pull/6649). - Следующий релиз, community.general 8.0.0, прекратит поддержку ansible-core 2.11 и 2.12, которые уже давно находятся в статусе End of Life. Это означает, что данная коллекция больше не поддерживает Python 2.6 на целевом устройстве. Отдельные компоненты могут по-прежнему работать с неподдерживаемыми версиями ansible-core, но это может измениться в любой момент. Также обратите внимание, что отныне для каждого нового основного релиза community.general мы будем прекращать поддержку всех версий ansible-core, которые находятся в статусе End of Life более нескольких недель на момент релиза (https://github.com/ansible-community/community-topics/discussions/271, https://github.com/ansible-collections/community.general/pull/7259).
- ansible_galaxy_install - параметры
ack_ansible29иack_min_ansiblecore211устарели и будут удалены в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/7358). - consul - параметр
ack_params_state_absentустарел и будет удален в community.general 10.0.0 (https://github.com/ansible-collections/community.general/pull/7358). - cpanm - значение
compatibilityустарело в качестве значения по умолчанию для параметраmode(https://github.com/ansible-collections/community.general/pull/6512). - ejabberd_user - устаревает параметр
loggingв пользу предоставления более подробной информации в выводе модуля (https://github.com/ansible-collections/community.general/pull/7043). - flowdock - модуль полностью зависит от устаревших API-точке доступа и будет удален в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/6930).
- proxmox - устаревший флаг
proxmox_default_behaviorбудет удален в community.general 10.0.0 (https://github.com/ansible-collections/community.general/pull/6836). - proxmox_kvm - устаревает параметр
proxmox_default_behavior(https://github.com/ansible-collections/community.general/pull/7377). - redfish_info, redfish_config, redfish_command - значение по умолчанию
10для параметраtimeoutустарело и изменится на60в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/7295). - redhat module utils - модуль
module_utils.redhatустарел, как фактически неиспользуемый: классыRhsm,RhsmPool, иRhsmPoolsбудут удалены в community.general 9.0.0; классRegistrationBaseбудет удален в community.general 10.0.0 вместе с модулемrhn_register, так как он является единственным пользователем этого класса; это означает, что весь модульmodule_utils.redhatбудет удален в community.general 10.0.0, поэтому импорт его без использования каких-либо его функций приведет к ошибке (https://github.com/ansible-collections/community.general/pull/6663). - redhat_subscription - алиас
autosubscribeдля параметраauto_attachустарел много лет, хотя только в документации. Официально отметить этот алиас как устаревший, и он будет удален в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/6646). - redhat_subscription - параметр
poolустарел в пользу более точного и гибкого параметраpool_ids(https://github.com/ansible-collections/community.general/pull/6650). - rhsm_repository -
state=presentне работает как ожидалось много лет, и, похоже, это до сих пор не замечено; также «присутствие» не является действительным понятием для репозиториев подписок, которые могут быть только включены или выключены. Следовательно, значенияpresentиabsentпараметраstateустаревают, и они будут удалены в community.general 10.0.0 (https://github.com/ansible-collections/community.general/pull/6673). - stackdriver - модуль полностью зависит от отсутствующих API-точек доступа и будет удален в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/6887).
- webfaction_app - модуль полностью зависит от отсутствующих API-точек доступа и будет удален в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/6909).
- webfaction_db - модуль полностью зависит от отсутствующих API-точек доступа и будет удален в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/6909).
- webfaction_domain - модуль полностью зависит от отсутствующих API-точек доступа и будет удален в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/6909).
- webfaction_mailbox - модуль полностью зависит от отсутствующих API-точек доступа и будет удален в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/6909).
- webfaction_site - модуль полностью зависит от отсутствующих API-точек доступа и будет удален в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/6909).
community.postgresql
- postgresql_lang - модуль устарел и будет удален в
community.postgresql 4.0.0. Используйте модульpostgresql_extвместо него (https://github.com/ansible-collections/community.postgresql/issues/559).
community.sap
- community.sap.hana_query - устарел в пользу community.sap_libs.sap_hdbsql
- community.sap.sap_company - устарел в пользу community.sap_libs.sap_company
- community.sap.sap_snote - устарел в пользу community.sap_libs.sap_snote
- community.sap.sap_task_list_execute - устарел в пользу community.sap_libs.sap_task_list_execute
- community.sap.sap_user - устарел в пользу community.sap_libs.sap_user
- community.sap.sapcar_extract - устарел в пользу community.sap_libs.sapcar_extract
community.windows
- win_domain_computer - Модуль устарел в пользу модуля
microsoft.ad.computer, модульcommunity.windows.win_domain_computerбудет удален в релизе3.0.0этой коллекции. - win_domain_group - Модуль устарел в пользу модуля
microsoft.ad.group, модульcommunity.windows.win_domain_groupбудет удален в релизе3.0.0этой коллекции. - win_domain_group_membership - Модуль устарел в пользу модуля
microsoft.ad.group, модульcommunity.windows.win_domain_group_membershipбудет удален в релизе3.0.0этой коллекции. - win_domain_object_info - Модуль устарел в пользу модуля
microsoft.ad.object_info, модульcommunity.windows.win_domain_object_infoбудет удален в релизе3.0.0этой коллекции. - win_domain_ou - Модуль устарел в пользу модуля
microsoft.ad.ou, модульcommunity.windows.win_domain_ouбудет удален в релизе3.0.0этой коллекции. - win_domain_user - Модуль устарел в пользу модуля
microsoft.ad.user, модульcommunity.windows.win_domain_userбудет удален в релизе3.0.0этой коллекции.
junipernetworks.junos
-
junos_ospfv2- добавить предупреждение об устаревании для area_range. - Добавить предупреждение об устаревании для ключа junos_acl_interfaces в результатах фактов junos.
microsoft.ad
- Устаревает поддержка Server 2012 и Server 2012 R2. Эти версии ОС достигают статуса End of Life от Microsoft, и поддержка их использования в Ansible подходит к концу.
purestorage.fusion
- fusion_api_client - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_array - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_az - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_hap - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_hap - параметры
nqn,wwns,host_password,host_user,target_password`and `target_userустарели - fusion_hw - переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_info - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_info - подмножество ‘hosts’ устарело в пользу ‘host_access_policies’ и будет удалено в версии 2.0.0
- fusion_info - подмножество ‘interfaces’ устарело в пользу ‘network_interfaces’ и будет удалено в версии 2.0.0
- fusion_info - подмножество ‘zones’ устарело в пользу ‘availability_zones’ и будет удалено в версии 2.0.0
- fusion_ni - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_nig - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_pg - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_pp - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_ra - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_region - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_sc - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_se - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_se - параметр
endpoint_typeтеперь устарел и будет удален в версии 2.0.0 - fusion_ss - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_tenant - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_tn - переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_ts - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
- fusion_volume - параметры ‘app_id’ и ‘key_file’ устарели в пользу параметров ‘issuer_id’ и ‘private_key_file’ и будут удалены в версии 2.0.0, переменные среды FUSION_APP_ID и FUSION_HOST устарели в пользу FUSION_ISSUER_ID и FUSION_HOST и будут удалены в версии 2.0.0
t_systems_mms.icinga_director
- Все модули и плагины перемещены в новый пространство имён telekom_mms. Пожалуйста, обновите свой код соответственно.
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/porting_guides/porting_guide_9.html