Руководство по переносу на Ansible 8
Ansible 8 основано на Ansible-core 2.15.
Мы рекомендуем прочитать эту страницу вместе с Журналом изменений Ansible 8, чтобы понять, какие обновления вам могут потребоваться.
Плейбук
-
Условные операторы — из-за устранения уязвимости CVE-2023-5764 в ansible-core 2.15.7, условные выражения со встроенными блоками шаблонов могут завершиться с сообщением «
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'
Командная строка
- Код возврата
ansible-galaxy searchтеперь равен 0, а не 1, и вывод stdout пуст, когда результаты пустые, чтобы соответствовать другим командамansible-galaxy.
Устаревшее
-
Предоставление списка словарей для
vars:устарело в пользу предоставления словаря.Вместо этого:
vars: - var1: foo - var2: bar
Используйте:
vars: var1: foo var2: bar
Модули
Нет заметных изменений
Удаленные модули
Следующие модули больше не существуют:
- Нет заметных изменений
Уведомления об устаревании
Нет заметных изменений
Заметные изменения в модулях
Нет заметных изменений
Плагины
Нет заметных изменений
Перенос пользовательских скриптов
Нет заметных изменений
Сети
Нет заметных изменений
Руководство по переносу для версии 8.7.0
Критические изменения
Ansible-core
- assert - Вложенные шаблоны могут привести к невозможности оценки условного оператора. См. руководство по переносу для получения дополнительной информации.
Руководство по переносу для версии 8.6.0
Добавленные коллекции
- ibm.storage_virtualize (версия 2.1.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).
fortinet.fortios
- Добавлен новый fortios версии 7.4.1.
- Отформатировано содержимое файла changelog.yml.
- Обновлена версия Ansible с 2.9 до 2.14.
- Обновлены вопросы и ответы с решением проблемы Ansible всегда отправляет запросы GET/PUT как POST.
- Обновлен файл requirement.txt для указания sphinx_rtd_theme==1.3.0
- В файле runtime.yml обновлена требуемая версия Ansible до 2.14.0.
Устаревшие функции
- Коллекция
ibm.spectrum_virtualizeбыла переименована вibm.storage_virtualize. Пока обе коллекции включены в Ansible. Содержаниеibm.spectrum_virtualizeбудет заменено устаревшими перенаправлениями на новую коллекцию в Ansible 10.0.0, а эти перенаправления будут в конечном итоге удалены из Ansible. Пожалуйста, обновите ваши FQCN дляibm.spectrum_virtualize.
Руководство по переносу для версии 8.5.0
Устаревшие функции
community.general
- В следующем крупном релизе community.general 8.0.0 будет прекращена поддержка ansible-core 2.11 и 2.12, которые уже давно достигли конца жизненного цикла. Это означает, что эта коллекция больше не поддерживает Python 2.6 на целевом компьютере. Отдельные элементы могут по-прежнему работать с неподдерживаемыми версиями ansible-core, но это может измениться в любое время. Также обратите внимание, что в дальнейшем, для каждого нового крупного выпуска community.general, мы будем прекращать поддержку всех версий ansible-core, которые достигли конца жизненного цикла за несколько недель до даты выпуска крупного релиза (https://github.com/ansible-community/community-topics/discussions/271, https://github.com/ansible-collections/community.general/pull/7259).
- redfish_info, redfish_config, redfish_command - значение по умолчанию
10для параметраtimeoutустарело и будет изменено на60в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/7295).
Руководство по портированию для v8.4.0
Основные изменения
fortinet.fortios
- Улучшена документация по добавлению заметок и примеров в разделах вопросов и ответов для модулей, использующих целые числа в качестве ключей mkey.
Устаревшие функции
- Коллекция
community.azureофициально не поддерживается и архивирована. Поэтому она будет удалена из Ansible 10. Уже существует коллекция-преемникazure.azcollectionв пакете community, которая должна обеспечивать ту же функциональность (https://github.com/ansible-community/community-topics/issues/263). - Коллекция
hpe.nimbleсчитается неподдерживаемой и будет удалена из Ansible 10, если никто не начнет ее поддерживать до Ansible 10. См. процесс удаления для получения подробной информации о работе данного механизма (https://github.com/ansible-community/community-topics/issues/254).
Ansible-core
- Фильтры vault и unfault - устаревшее параметр
vaultidи будет удален в ansible-core 2.20. Используйтеvault_idвместо него.
ansible.netcommon
- libssh - опции ssh_*_args теперь помечены как подлежащие удалению после 2026-01-01.
Руководство по портированию для v8.3.0
Добавленные коллекции
- telekom_mms.icinga_director (версия 1.34.1)
Основные изменения
fortinet.fortios
- Добавлен файл readthedocs.yaml.
- Обновлены ответы на вопросы по настройке многофакторной аутентификации FortiToken;
Устаревшие функции
- Коллекция
t_systems_mms.icinga_directorбыла переименована вtelekom_mms.icinga_director. Пока обе коллекции включены в Ansible. Содержимоеt_systems_mms.icinga_directorбудет заменено устаревшими перенаправлениями на новую коллекцию в Ansible 9.0.0, а эти перенаправления будут в конечном итоге удалены из Ansible. Пожалуйста, обновите ваши FQCN дляt_systems_mms.icinga_director. - Коллекция 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).
- Коллекция ngine_io.vultr официально не поддерживается и архивирована. Поэтому она будет удалена из Ansible 9. Уже существует коллекция-преемник
vultr.cloud(использующая новый API Vultr v2) в пакете community, которая покрывает функциональность, но может иметь несовместимый синтаксис (https://github.com/ansible-community/community-topics/issues/257).
community.crypto
- get_certificate - значение по умолчанию
falseдля параметраasn1_base64устарело и изменится наtrueв community.crypto 3.0.0 (https://github.com/ansible-collections/community.crypto/pull/600).
community.general
- ejabberd_user - параметр
loggingустарел в пользу предоставления более подробной информации в выводе модуля (https://github.com/ansible-collections/community.general/pull/7043).
community.postgresql
- postgresql_lang - модуль устарел и будет удален в
community.postgresql 4.0.0. Используйте модульpostgresql_extвместо него (https://github.com/ansible-collections/community.postgresql/issues/559).
Руководство по переносу для v8.2.0
Известные проблемы
Ansible-core
- ansible-test - Известно, что удалённый сервер Fedora 37 иногда зависает во время загрузки. В результате он больше не тестируется регулярно. Если возможно, используйте удалённый сервер Fedora 38 вместо него.
community.crypto
- Разметка Ansible будет отображаться в сыром виде в текстовом выводе ansible-doc для ansible-core версии ниже 2.15. Если у вас возникнут проблемы с интерпретацией разметки документации, пожалуйста, обновите ansible-core до версии 2.15 (или новее), или прочитайте документацию в формате HTML по адресу https://docs.ansible.com/ansible/devel/collections/community/crypto/.
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/.
Изменения, вносящие разрывы
hetzner.hcloud
- Для полной совместимости теперь требуется hcloud-python 1.20.0
Основные изменения
chocolatey.chocolatey
- win_chocolatey - добавлены параметры для указания контрольных сумм
- win_chocolatey_facts - добавлен параметр фильтра/подмножества gather_subset
community.vmware
- vmware_vasa - добавлен новый модуль для регистрации/удаления поставщика VASA
- vmware_vasa_info - добавлен новый модуль для сбора информации о существующем(их) поставщике(ях) VASA
grafana.grafana
- Добавлена роль Grafana Server автором @gardar
- Настраиваемые группы пользователей агента автором @NormanJS
- Поддержка плагинов Grafana для локальной установки Grafana автором @ishanjainn
- Обновлён сервис для режима потоков автором @bentonam
Устаревшие функции
- Коллекция
community.sapбыла переименована вcommunity.sap_libs. Пока обе коллекции включены в Ansible. Содержимоеcommunity.sapбудет заменено устаревшими перенаправлениями на новую коллекцию в Ansible 9.0.0, а коллекция будет полностью удалена из Ansible 10. Пожалуйста, обновите свои FQCN дляcommunity.sap. - Устаревшая коллекция servicenow.servicenow была удалена из Ansible 7, но случайно добавлена обратно в Ansible 8. Она будет снова удалена из Ansible 9 (https://github.com/ansible-community/community-topics/issues/246).
community.general
- 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). - 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).
junipernetworks.junos
-
junos_ospfv2- добавить предупреждение об устаревании для area_range. - Добавить предупреждение об устаревании для ключа junos_acl_interfaces в результатах фактов junos.
Руководство по переносу для v8.1.0
Известные проблемы
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).
dellemc.openmanage
- idrac_redfish_storage_contoller - Проблема(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_smart_fabric_uplink - Проблема(186024) - Несмотря на то, что модуль поддерживается OpenManage Enterprise Modular, он не позволяет создавать несколько каналов связи с одинаковым именем. Если канал связи создается с тем же именем, что и существующий, существующий канал связи изменяется.
Изменения, требующие переписывания кода
- Обратите внимание, что изменение, требующее переписывание кода, объявленное в журнале изменений dellemc.enterprise_sonic ниже, относится к dellemc.enterprise_sonic 2.1.0 и было отменено в dellemc.enterprise_sonic 2.2.0, поэтому оно не включено в Ansible 8. По техническим причинам эта запись по-прежнему отображается здесь.
dellemc.enterprise_sonic
- sonic_aaa - Добавить атрибут default_auth в argspec для замены удаленных атрибутов group и local. Это изменение позволяет упорядочить аутентификацию входа в систему. (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/195).
Основные изменения
cloudscale_ch.cloud
- Повысить минимально необходимую версию Ansible до 2.13.0
fortinet.fortimanager
- Поддержка всех версий FortiManager в 6.2, 6.4, 7.0, 7.2 и 7.4. 139 новых модулей.
- Поддержка аутентификации на основе токенов.
fortinet.fortios
- Улучшить функцию
no_logв некоторых модулях; - Улучшить документацию и примеры для
seq_numвfortios_router_static; - Улучшить документацию для
member_pathво всех модулях; - Поддержка новых версий FOS.
Удаленные функции
community.ciscosmb
- Удалить тестирование для Python 2.6 и 2.7
- Удалить тестирование для ansible 2.9
Устаревшие возможности
- Коллекция gluster.gluster считается не поддерживаемой и будет удалена из Ansible 10, если никто не начнёт её поддерживать до Ansible 10. См. процесс удаления для получения подробностей о том, как это работает (https://github.com/ansible-community/community-topics/issues/225).
amazon.aws
- s3_object — поддержка передачи ключей объектов с префиксом
/устарела и будет удалена в релизе после 2025-12-01 (https://github.com/ansible-collections/amazon.aws/pull/1549).
community.ciscosmb
- поддержка Python 2.6 и 2.7
- поддержка ansible 2.9
community.general
- Модульные утилиты CmdRunner — устаревает форматтер
cmd_runner_fmt.as_default_type()(https://github.com/ansible-collections/community.general/pull/6601). - Модульные утилиты MH VarsMixin — устаревают
VarsMixinи поддерживающие классы в пользу простой утилиты модуляvardict(https://github.com/ansible-collections/community.general/pull/6649). - cpanm — значение
compatibilityустарело в качестве значения по умолчанию для параметраmode(https://github.com/ansible-collections/community.general/pull/6512). - Модульные утилиты redhat — модуль
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).
microsoft.ad
- Поддержка Server 2012 и Server 2012 R2 устарела. Эти версии ОС достигли статуса окончания жизненного цикла от 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
Руководство по переносу для v8.0.0
Добавленные коллекции
- dellemc.powerflex (версия 1.6.0)
- dellemc.unity (версия 1.6.0)
- grafana.grafana (версия 2.0.0)
- microsoft.ad (версия 1.1.0)
- servicenow.servicenow (версия 1.0.6)
Известные проблемы
Ansible-core
- ansible-test - Для определенных комбинаций хоста контейнера и самого контейнера может потребоваться дополнительная конфигурация. Дополнительные сведения см. в документации по тестированию.
- ansible-test - Пользовательские контейнеры с инструкциями
VOLUMEмогут не запускаться, в то время как ранее они запускались корректно. Удалите инструкцииVOLUME, чтобы решить проблему. Контейнеры с этим условием могут вызвать предупреждениеansible-test - ansible-test - Системы с проблемами сетевого взаимодействия Podman могут не запускать контейнеры, в то время как ранее проблема не отображалась. Исправьте проблемы с сетевым взаимодействием, чтобы продолжить использование
ansible-testс Podman. - ansible-test - Тесты модулей коллекций не поддерживают переопределение утверждений
pytestв Python 2.7. - ansible-test - Использование Docker на системах с SELinux может потребовать установки SELinux в разрешительный режим. Поддержка Podman должна работать в режиме принудительного режима SELinux.
- dnf5 - Утилита управления пакетами DNF5 в настоящее время не предоставляет все возможности для обеспечения соответствия функциональности между существующим
dnfи новым модулемdnf5. В результате следующие параметрыdnf5фактически являются бесполезными:cacheonly,enable_plugin,disable_pluginиlock_timeout.
cisco.meraki
- meraki_network - Обновленная документация по
local_status_page_enabledиremote_status_page_enabled, так как они больше не работают.
community.docker
- Модули и плагины, использующие встроенный код из Docker SDK для Python, в настоящее время не работают с requests 2.29.0 и/или urllib3 2.0.0. То же самое в настоящее время относится и к последней версии Docker SDK для Python (https://github.com/ansible-collections/community.docker/issues/611, https://github.com/ansible-collections/community.docker/pull/612).
- Плагин подключения docker_api — не работает с TCP-сокет TLS! Это вызвано невозможностью отправки предупреждения TLS
close_notifyбез закрытия соединения с PythonSSLSocket(https://github.com/ansible-collections/community.docker/issues/605, https://github.com/ansible-collections/community.docker/pull/621). - docker_container_exec — не работает с TCP-сокет TLS, когда используется параметр
stdin! Это вызвано невозможностью отправки предупреждения TLSclose_notifyбез закрытия соединения с PythonSSLSocket(https://github.com/ansible-collections/community.docker/issues/605, https://github.com/ansible-collections/community.docker/pull/621).
community.routeros
- api_modify - когда лимиты для записей в
queue treeопределены как удобочитаемые, например25M, конфигурация будет правильно установлена в ROS, но модуль будет указывать, что элемент изменен на каждом запуске, даже если изменений не было. Это вызвано API ROS, который возвращает число в байтах, например25000000(что несовместимо с поведением командной строки). Для минимизации этого лимиты должны быть определены в байтах (они все равно будут отображаться как удобочитаемые в командной строке ROS) (https://github.com/ansible-collections/community.routeros/pull/131). - api_modify, api_info -
routing ospf area,routing ospf area range,routing ospf instance,routing ospf interface-templateпути не полностью реализованы для ROS6 из-за существенных изменений между ROS6 и ROS7 (https://github.com/ansible-collections/community.routeros/pull/131).
dellemc.openmanage
- idrac_firmware - Проблема (249879) - Обновление прошивки серверов на базе iDRAC9 завершается неудачно, если используется прокси-сервер SOCKS с аутентификацией.
- idrac_os_deployment- Проблема (260496) - Установка ОС будет поддерживать только совместное использование NFS и CIFS для хранения пользовательского ISO в пути destination_path, HTTP/HTTPS/FTP не поддерживаются
- idrac_redfish_storage_contoller - Проблема (256164) - Если для одного из атрибутов в предоставленном списке атрибутов для конфигурации контроллера указано неправильное значение, данный модуль не завершается с ошибкой.
- idrac_user - Проблема (192043) Модуль может завершиться с сообщением
Unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress. Дождитесь завершения задачи и выполните её снова. - idrac_user - Проблема (192043) Модуль может завершиться с сообщением
unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress. Дождитесь завершения задачи и выполните её снова. - ome_application_alerts_syslog - Проблема (215374) - Модуль не выводит правильное сообщение об ошибке, если адрес назначения превышает 255 символов.
- ome_device_network_services - Проблема (212681) - Модуль не выводит правильное сообщение об ошибке, если для следующих параметров указаны недопустимые значения - port_number, community_name, max_sessions, max_auth_retries и idle_timeout.
- 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_inventory - Проблема (256257) - Для группы
Modular Systemи соответствующих дочерних групп не извлекаются все хосты. - ome_inventory - Проблема (256589) - Для группы
Custom Groupsи соответствующих дочерних групп не извлекаются все хосты. - ome_inventory - Проблема (256593) - Для группы
PLUGIN GROUPSи соответствующих дочерних групп не извлекаются все хосты. - ome_smart_fabric_uplink - Проблема (186024) - Несмотря на поддержку модуля в OpenManage Enterprise Modular, он не позволяет создавать несколько каналов связи с одинаковым именем. Если канал связи создается с тем же именем, что и существующий канал, существующий канал изменяется.
- ome_smart_fabric_uplink - Проблема (186024) - Модуль не позволяет создавать несколько каналов связи с одинаковым именем, несмотря на поддержку в OpenManage Enterprise Modular. Если канал связи создается с тем же именем, что и существующий канал, существующий канал изменяется.
Изменения, требующие доработки
Ansible-core
- ansible-doc - больше не обрабатывает плагины в коллекциях, имена которых начинаются с
_, как устаревшие (https://github.com/ansible/ansible/pull/79362). - ansible-test - Тесты интеграции, которые зависят от конкретных разрешений файлов при запуске в управляемой ansible-test среде хоста, могут потребовать изменений. Тесты, требующие разрешений, отличных от
755или644, могут потребовать обновления для установки необходимых разрешений в ходе выполнения теста. - ansible-test - Плагин теста
vcenterтеперь по умолчанию использует статическое конфигурационное значение, предоставленное пользователем, вместо симулятораgovcsimдля коллекций. Установите переменную средыANSIBLE_VCSIM_CONTAINERв значениеgovcsim, чтобы использовать симулятор. Имейте в виду, что симулятор устарел и будет удален в будущей версии. - ansible-test sanity - ранее плагины и модули в коллекциях, имена которых начинались с
_, обрабатывались как устаревшие, даже если они не были помечены как устаревшие вmeta/runtime.yml. Теперь это не так (https://github.com/ansible/ansible/pull/79362). - ansible-test validate-modules - Удален код ошибки
missing-python-docв модулях валидации,missing-documentationиспользуется вместо этого для отсутствующей документации модуля PowerShell.
amazon.aws
- Коллекция 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был удален. Вместо него можно использовать поиск по файлам (policy) (https://github.com/ansible-collections/amazon.aws/issues/1178). - ec2_vpc_net - значение возврата
classic_link_enabledбыло удалено. Поддержка EC2 Classic networking была прекращена AWS (https://github.com/ansible-collections/amazon.aws/pull/1374). - ec2_vpc_net_info - значение возврата
classic_link_dns_statusбыло удалено. Поддержка EC2 Classic networking была прекращена AWS (https://github.com/ansible-collections/amazon.aws/pull/1374). - ec2_vpc_net_info - значение возврата
classic_link_enabledбыло удалено. Поддержка EC2 Classic networking была прекращена AWS (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).
ansible.netcommon
- NetworkConnectionBase теперь наследуется от PersistentConnectionBase в ansible.utils. В результате минимальная версия ansible.utils увеличилась до 2.7.0.
- NetworkTemplate больше не импортируется из ansible_collections.ansible.netcommon.plugins.module_utils.network.common и теперь должен находиться по правильному пути ansible_collections.ansible.netcommon.plugins.module_utils.network.common.rm_base.network_template
- ResourceModule больше не импортируется из ansible_collections.ansible.netcommon.plugins.module_utils.network.common и теперь должен находиться по правильному пути ansible_collections.ansible.netcommon.plugins.module_utils.network.common.rm_base.resource_module
- VALID_MASKS, is_masklen, is_netmask, to_bits, to_ipv6_network, to_masklen, to_netmask и to_subnet больше не импортируются из ansible_collections.ansible.netcommon.plugins.module_utils.network.common.utils и теперь должны находиться по правильному пути ansible.module_utils.common.network
community.aws
- Коллекция community.aws прекратила поддержку
botocore<1.25.0иboto3<1.22.0. Большинство модулей по-прежнему будут работать со старыми версиями AWS SDK, однако совместимость со старыми версиями SDK не гарантируется и не будет тестироваться. При использовании более ранних версий SDK Ansible выведет предупреждение (https://github.com/ansible-collections/community.aws/pull/1743). - aws_ssm - плагин AWS SSM ошибочно добавлял
sudoк большинству команд. Это поведение было неверным и было удалено. Чтобы выполнять команды от имени определенного пользователя, включая пользователяroot, следует использовать директивыbecomeиbecome_user. См. документацию Ansible для получения дополнительной информации (https://github.com/ansible-collections/community.aws/issues/853). - codebuild_project - параметр
tagsтеперь принимает словарь, представляющий метки, а не формат boto3 (https://github.com/ansible-collections/community.aws/pull/1643).
community.general
- Если вы не используете эту коллекцию в рамках Ansible, но установили (и/или обновили) community.general вручную, убедитесь, что также установлена
community.sap_libs, если вы используете модулиsapcar_extract,sap_task_list_executeиhana_query. Без этой коллекции перенаправления для этих модулей не работают. - Модуль ModuleHelper module utils - когда модуль устанавливает переменные вывода с именами
msg,exception,output,varsилиchanged, фактический вывод будет добавлять префикс_(символ подчеркивания) только в случае конфликта с переменными вывода, генерируемыми самим ModuleHelper, что происходит только при обработке исключений. Обратите внимание, что это изменение, требующее доработки, не требует выпуска новой основной версии, так как до этого релиза добавить такие переменные в вывод было невозможно из-за ошибки (https://github.com/ansible-collections/community.general/pull/5765). - gconftool2 - исправлена обработка
gconftool-2при отсутствииkey, возвращаетсяnullвместо пустой строки для значений возвратаvalueиprevious_value(https://github.com/ansible-collections/community.general/issues/6028). - gitlab_runner - значение по умолчанию для
access_level_on_creationизменено сfalseнаtrue(https://github.com/ansible-collections/community.general/pull/6428). - ldap_search - все строковые значения преобразованы в UTF-8 (https://github.com/ansible-collections/community.general/issues/5704, https://github.com/ansible-collections/community.general/pull/6473).
- nmcli - значение по умолчанию для параметра
hairpinизменено сtrueнаfalse(https://github.com/ansible-collections/community.general/pull/6428). - proxmox - значение по умолчанию для параметра
unprivilegedизменено сfalseнаtrue(https://github.com/ansible-collections/community.general/pull/6428).
community.hashi_vault
- Поддержка
ansible-core2.11 и 2.12 была удалена (https://github.com/ansible-collections/community.hashi_vault/issues/340). - Минимальная версия
hvacдляcommunity.hashi_vaultтеперь1.1.0(https://github.com/ansible-collections/community.hashi_vault/issues/324). - Поиск hashi_vault - дублирующие записи опций в строке термина теперь вызывают исключение вместо предупреждения (https://github.com/ansible-collections/community.hashi_vault/issues/356).
community.zabbix
- Роль агента — удалена поддержка операционных систем Darwin, Amazon, Fedora, XCP-ng, Suse, Mint и Sangoma
- Роль агента — удалено zabbix_create_host и заменено на zabbix_agent_host_state
- Роль агента — удалено zabbix_create_hostgroup и заменено на zabbix_agent_hostgroups_state
- Роль агента — удалены zabbix_http_password, zabbix_api_http_password, zabbix_api_pass и zabbix_api_login_pass и заменены на zabbix_api_login_pass
- Роль агента — удалены zabbix_http_user, zabbix_api_http_user, zabbix_api_user и zabbix_api_login_user и заменены на zabbix_api_login_user
- Роль агента — удалено zabbix_inventory_mode и заменено на zabbix_agent_inventory_mode
- Роль агента — удалено zabbix_link_templates и заменено на zabbix_agent_link_templates
- Роль агента — удалено zabbix_macros и заменено на zabbix_agent_macros
- Роль агента — удалено zabbix_proxy и заменено на zabbix_agent_proxy
- Роль агента — удалено zabbix_update_host и заменено на zabbix_agent_host_update
- Все модули — прекращена поддержка версий Zabbix < 6.0
- Все роли — удалена переменная zabbix_version.
- Все роли — прекращена поддержка всех версий Zabbix < 6.0.
- Все роли — прекращена поддержка установки из epel и нестандартных репозиториев
- Прекращена поддержка zabbix-api для выполнения вызовов REST API к Zabbix
- Роль прокси-сервера — удалено zabbix_database_creation и заменено на zabbix_proxy_database_creation
- Роль прокси-сервера — удалено zabbix_database_sqlload и заменено на zabbix_proxy_database_sqlload
- Роль прокси-сервера — удалено zabbix_selinux и заменено на zabbix_proxy_selinux
- Роль сервера — удалено zabbix_server_mysql_login_password и заменено на zabbix_server_dbpassword
- Роль сервера — удалено zabbix_server_mysql_login_user и заменено на zabbix_server_dbuser
- Прекращена поддержка Ansible < 2.12
- Прекращена поддержка Python < 3.9
- zabbix_action — параметр сообщения переименован в op_message
- Модуль zabbix_group_facts — удален в пользу zabbix_group_info
- Модуль zabbix_host_facts — удален в пользу zabbix_host_info
hetzner.hcloud
- Плагин инвентаризации — теперь требуется Python v3.5+.
lowlydba.sqlserver
- Обновление минимальной версии DBATools до v2.0.0 для обеспечения совместимости с pwsh 7.3+. Возможны также изменения в поведении DBATools, см. https://blog.netnerds.net/2023/03/whats-new-dbatools-2.0/. (https://github.com/lowlydba/lowlydba.sqlserver/pull/181)
Основные изменения
Ansible-core
- ansible-test - Теперь поддерживается Docker Desktop в WSL2 (требуется дополнительная настройка).
- ansible-test - Теперь Docker и Podman поддерживаются на хостах с объединённой системой cgroup v2. Ранее поддерживались только cgroup v1 и cgroup v2 гибридные.
- ansible-test - Podman теперь работает на хостах контейнеров без systemd. Ранее работали только некоторые контейнеры, в то время как другие требовали rootfull или rootless Podman, но не работали с обоими. Некоторые контейнеры вообще не работали.
- ansible-test - Теперь поддерживается Podman в WSL2.
- ansible-test - При необходимости дополнительной настройки cgroup на хосте контейнера, это будет автоматически обнаружено. Инструкции по настройке хоста будут предоставлены в сообщении об ошибке.
ansible.windows
- Установлен минимальный поддерживаемый Ansible версия 2.12 для данного сборника.
chocolatey.chocolatey
- win_chocolatey - Пользователи могут выбрать версии TLS, используемые для начальной установки Chocolatey.
cisco.iosxr
- iosxr_l3_interfaces - исправлена ошибка в формате записи IP-адресов IPv4. (https://github.com/ansible-collections/cisco.iosxr/issues/311).
cisco.meraki
- meraki_mr_l7_firewall - Новый модуль
- meraki_webhook_payload_template - Новый модуль
community.hrobot
- firewall - Hetzner добавлена поддержка правил вывода в брандмауэр. К сожалению, это изменение означает, что использование старых версий модуля брандмауэра всегда будет устанавливать список правил вывода в пустой, тем самым не позволяя серверу отправлять пакеты (https://github.com/ansible-collections/community.hrobot/issues/75, https://github.com/ansible-collections/community.hrobot/pull/76).
community.postgresql
- postgresql_privs - аргумент
passwordустарел и будет удален в community.postgresql 4.0.0, используйте вместо него аргументlogin_password(https://github.com/ansible-collections/community.postgresql/issues/406).
community.vmware
- Используйте true/false (строчные буквы) для логических значений в документации и примерах (https://github.com/ansible-collections/community.vmware/issues/1660).
community.zabbix
- Все модули отказываются от zabbix-api и используют плагин httpapi ansible.netcommon. Мы будем поддерживать zabbix-api для обратной совместимости до следующего крупного релиза. Более подробную информацию о миграции см. в нашем файле README.md
- Роли zabbix_agent и zabbix_proxy отказываются от zabbix-api и используют плагин httpapi ansible.netcommon. Мы будем поддерживать zabbix-api для обратной совместимости до следующего крупного релиза. Более подробную информацию о миграции см. в нашем файле README.md
containers.podman
- Новый плагин become - podman_unshare
- Модуль Podman generate systemd
dellemc.openmanage
- Изменено название с Dell EMC на Dell.
- Поддержка адресов IPv6 для модулей iDRAC, зависящих от OMSDK.
- idrac_firmware - Этот модуль расширен для поддержки прокси-сервера.
- idrac_redfish_storage_controller - Этот модуль расширен для настройки атрибутов контроллера и онлайн расширения емкости.
- idrac_server_config_profile - Этот модуль расширен для поддержки настроек прокси, буфера импорта, включения в экспорт и игнорирования предупреждений о сертификатах.
- idrac_user_info - Этот модуль позволяет извлекать информацию об iDRAC локальном пользователе.
- ome_domian_user_groups - Этот модуль позволяет импортировать группы каталога LDAP.
- ome_inventory - Этот плагин позволяет создавать инвентаризацию из группы в OpenManage Enterprise.
- ome_inventory - Этот плагин расширен для поддержки извлечения инвентаризации групп System и Plugin OpenManage Enterprise.
- ome_profile_info - Этот модуль позволяет извлекать профили с атрибутами в OpenManage Enterprise или OpenManage Enterprise Modular.
- ome_smart_fabric_info - Этот модуль извлекает список интеллектуальных сетей в инвентаризации OpenManage Enterprise Modular.
- ome_smart_fabric_uplink_info - Этот модуль извлекает детали подключения интеллектуальной сети к OpenManage Enterprise Modular.
- ome_template_network_vlan_info - Этот модуль позволяет извлекать конфигурацию сети шаблона в OpenManage Enterprise или OpenManage Enterprise Modular.
fortinet.fortios
- Добавлены аннотации операций члена для каждого модуля.
- Поддержка FortiOS v7.0.6, v7.0.7, v7.0.8, v7.2.1, v7.2.2.
- Обновление
fortios.pyдля повышения производительности; - поддержка временного ключа сессии и баннеров до/после входа;
- обновлены примеры использования операций члена в разделе вопросов и ответов.
infoblox.nios_modules
- Добавлена функция Grid Master Candidate #152
- Добавление назначения членов в сети и диапазонах #152
- Добавлен модуль NIOS Range с функциями создания, обновления и удаления #152
- Исправлена ошибка невозможности обновления/удаления EAs с помощью плагина Ansible #180
- Исправлена статическая и динамическая настройка IP-адреса IPv4 записи A #182
- Исправления обновления имени хоста члена NIOS #176
- Обновление версии WAPI по умолчанию до 2.9 #176
junipernetworks.junos
- изменено собираемое значение с junos_acls на acls
kubernetes.core
- переработка K8sAnsibleMixin в module_utils/k8s/ (https://github.com/ansible-collections/kubernetes.core/pull/481).
purestorage.fusion
- Сопоставление полей ресурсов с подлежащим Python SDK было доведено до соответствия
- fusion_volume - исправлен и переработан, изменены аргументы
Удаленные коллекции
- dellemc.os10 (предыдущая включенная версия: 1.1.1)
- dellemc.os6 (предыдущая включенная версия: 1.0.7)
- dellemc.os9 (предыдущая включенная версия: 1.0.4)
- mellanox.onyx (предыдущая включенная версия: 1.0.0)
Удаленные функции
-
dellemc.os10была признана не поддерживаемой и удалена из Ansible 8 в соответствии с процессом удаления из Ansible. Пользователи по-прежнему могут установить этот сборник с помощьюansible-galaxy collection install dellemc.os10. -
dellemc.os6была признана не поддерживаемой и удалена из Ansible 8 в соответствии с процессом удаления из Ansible. Пользователи по-прежнему могут установить этот сборник с помощьюansible-galaxy collection install dellemc.os6. -
dellemc.os9была признана не поддерживаемой и удалена из Ansible 8 в соответствии с процессом удаления из Ansible. Пользователи по-прежнему могут установить этот сборник с помощьюansible-galaxy collection install dellemc.os9. -
mellanox.onyxбыла признана не поддерживаемой и удалена из Ansible 8 в соответствии с процессом удаления из Ansible. Пользователи по-прежнему могут установить этот сборник с помощьюansible-galaxy collection install mellanox.onyx.
Ansible-core
- Удалена устаревшая переменная среды конфигурации
ANSIBLE_CALLBACK_WHITELIST, используйте вместо неёANSIBLE_CALLBACKS_ENABLED. (https://github.com/ansible/ansible/issues/78821) - Удалена устаревшая переменная среды конфигурации
ANSIBLE_COW_WHITELIST, используйте вместо неёANSIBLE_COW_ACCEPTLIST. (https://github.com/ansible/ansible/issues/78819) - Удален устаревший параметр конфигурации
callback_whitelist, используйте вместо негоcallbacks_enabled. (https://github.com/ansible/ansible/issues/78822) - Удален устаревший параметр конфигурации
cow_whitelist, используйте вместо негоcowsay_enabled_stencils. (https://github.com/ansible/ansible/issues/78820)
amazon.aws
- 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).
ansible.netcommon
- cli_parse - Этот плагин был перемещен в ansible.utils в версии 1.0.0, и переадресация в этот сборник теперь удалена.
community.general
- Все модули
sapбыли удалены из этого сборника. Они были перенесены в сборник community.sap_libs. Были предоставлены переадресации. Затронуты следующие модули: - sapcar_extract - sap_task_list_execute - hana_query - Модуль утилиты cmd_runner - псевдоним
fmtдляcmd_runner_fmtбыл удален. Используйте вместо негоcmd_runner_fmt(https://github.com/ansible-collections/community.general/pull/6428). - newrelic_deployment - параметры
appnameиenvironmentбыли удалены. Они ничего не делали (https://github.com/ansible-collections/community.general/pull/6428). - puppet - псевдоним
show-diffпараметраshow_diffбыл удален. Используйте вместо негоshow_diff(https://github.com/ansible-collections/community.general/pull/6428). - xfconf - генерация фактов была устаревшей в community.general 3.0.0, однако три фактоида,
property,channelиvalue, по ошибке продолжали генерироваться. Это поведение было удалено, иxfconfбольше не генерирует фактов (https://github.com/ansible-collections/community.general/pull/5502). - xfconf - генерация фактов была устаревшей в community.general 3.0.0, однако два фактоида,
previous_valueиtype, по ошибке продолжали генерироваться. Это поведение было удалено, иxfconfбольше не генерирует фактов (https://github.com/ansible-collections/community.general/pull/5502).
community.zabbix
- Роль агента - удалена поддержка настройки брандмауэра
- Роль веб-сервера - удалена установка Apache, Debian и PHP
Устаревшие возможности
- Коллекция cisco.nso считается не поддерживаемой и будет удалена из Ansible 9, если никто не начнёт её поддерживать до Ansible 9. См. процесс удаления для получения подробной информации (https://github.com/ansible-community/community-topics/issues/155).
- Коллекция community.fortios считается не поддерживаемой и будет удалена из Ansible 9, если никто не начнёт её поддерживать до Ansible 9. См. процесс удаления для получения подробной информации (https://github.com/ansible-community/community-topics/issues/162).
- Коллекция community.google считается не поддерживаемой и будет удалена из Ansible 9, если никто не начнёт её поддерживать до Ansible 9. См. процесс удаления для получения подробной информации (https://github.com/ansible-community/community-topics/issues/160).
- Коллекция community.skydive считается не поддерживаемой и будет удалена из Ansible 9, если никто не начнёт её поддерживать до Ansible 9. См. процесс удаления для получения подробной информации (https://github.com/ansible-community/community-topics/issues/171).
- Коллекция netapp.aws считается не поддерживаемой и будет удалена из Ansible 10, если никто не начнёт её поддерживать до Ansible 10. См. процесс удаления для получения подробной информации (https://github.com/ansible-community/community-topics/issues/223).
Ansible-core
- Атрибут
ConnectionBase()._new_stdinустарел, используйтеdisplay.prompt_until(msg)вместо него. - ansible-test - Плагин теста
foremanтеперь устарел. Он будет удалён в будущей версии. - ansible-test - Симулятор
govcsimв плагине тестаvcenterтеперь устарел. Он будет удалён в будущей версии. Пользователи должны перейти к предоставлению собственной тестовой среды через файл статической конфигурации. - password_hash - устарело использование passlib.hash.hashtype, если hashtype не входит в список задокументированных вариантов.
- vars - Указание списка словарей для
vars:устарело в пользу указания словаря.
amazon.aws
- Коллекция 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). - Поддержка передачи как профиля, так и токенов безопасности через комбинацию переменных окружения и параметров устарела и будет удалена в релизе 6.0.0. После релиза 6.0.0 будет возможно передать либо профиль, либо токены безопасности независимо от используемого механизма передачи. Для явного запрета параметра, полученного из переменной окружения, передайте пустую строку в качестве значения параметра. Поддержка одновременной передачи профиля и токенов безопасности была первоначально устарела в релизе 1.2.0, однако частично реализована в релизе 5.0.0 (https://github.com/ansible-collections/amazon.aws/pull/1355).
check_point.mgmt
- Модули add/set/delete nat-rule будут заменены единственным модулем cp_mgmt_nat_rule.
- Модули cp_mgmt_show_task/s будут заменены единственным модулем cp_mgmt_task_facts.
chocolatey.chocolatey
- win_chocolatey - Устаревают установки side-by-side.
cisco.ios
- ios_bgp_address_family - устарели neighbors.address/tag/ipv6_adddress в пользу neighbor_address, который обеспечивает общие атрибуты для рендеринга фактов
- ios_bgp_address_family - устарел neighbors.password в пользу password_options, который позволяет шифрование и пароль
- ios_bgp_address_family - устарел redistribute.ospf.match.external в пользу redistribute.ospf.match.externals, который обеспечивает атрибуты для маршрутов типа E1 и E2 OSPF
- ios_bgp_address_family - устарел redistribute.ospf.match.nssa_external в пользу redistribute.ospf.match.nssa_externals, который обеспечивает атрибуты для маршрутов типа N1 и N2 OSPF
- ios_bgp_address_family - устарел redistribute.ospf.match.type_1 в пользу redistribute.ospf.match.nssa_externals.type_1
- ios_bgp_address_family - устарел redistribute.ospf.match.type_2 в пользу redistribute.ospf.match.nssa_externals.type_2
- ios_bgp_address_family - устарел slow_peer в пользу slow_peer_options, который поддерживает атрибут dict
community.aws
- Коллекция community.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/community.aws/pull/1743).
- Коллекция community.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/community.aws/pull/1743).
- ecs_service — В релизе после 2024-06-01 значение по умолчанию
purge_placement_constraintsбудет изменено сfalseнаtrue(https://github.com/ansible-collections/community.aws/pull/1716). - ecs_service — В релизе после 2024-06-01 значение по умолчанию
purge_placement_strategyбудет изменено сfalseнаtrue(https://github.com/ansible-collections/community.aws/pull/1716). - iam_role — Все значения возвращаемых данных верхнего уровня, кроме
iam_roleиchanged, устарели и будут удалены в релизе после 2023-12-01 (https://github.com/ansible-collections/community.aws/issues/551). - iam_role — В релизе после 2023-12-01 содержимое
assume_role_policy_documentбольше не будет преобразовываться из CamelCase в snake_case. Значение возвращаемого результатаassume_role_policy_document_rawуже возвращает документ политики в этом будущем формате (https://github.com/ansible-collections/community.aws/issues/551). - iam_role_info — В релизе после 2023-12-01 содержимое
assume_role_policy_documentбольше не будет преобразовываться из CamelCase в snake_case. Значение возвращаемого результатаassume_role_policy_document_rawуже возвращает документ политики в этом будущем формате (https://github.com/ansible-collections/community.aws/issues/551).
community.crypto
- x509_crl — параметр
modeустарел; используйтеcrl_modeвместо него. Параметрmodeизменит свое значение в community.crypto 3.0.0 и будет относиться к режиму файла CRL вместо его содержимого (https://github.com/ansible-collections/community.crypto/issues/596).
community.dns
- Значение по умолчанию для недавно добавленного параметра
txt_character_encodingбудет изменено сoctalнаdecimalв community.dns 3.0.0. Новое значение по умолчанию будет совместимо с RFC 1035 (https://github.com/ansible-collections/community.dns/pull/134).
community.general
- ModuleHelper module_utils -
depsмиксин для классов MH устарел в пользу использования модуляdepsmodule_utils (https://github.com/ansible-collections/community.general/pull/6465). - consul - устарело использование параметров, не используемых для
state=absent(https://github.com/ansible-collections/community.general/pull/5772). - gitlab_runner - значение по умолчанию нового параметра
access_level_on_creationизменится сfalseнаtrueв community.general 7.0.0. Это приведет к использованиюaccess_levelпри регистрации раннера, а не только при обновлениях (https://github.com/ansible-collections/community.general/pull/5908). - gitlab_runner - параметр
access_levelпотеряет своё значение по умолчанию в community.general 8.0.0. С этой версии вам необходимо явно установить этот параметр вref_protected, если вы хотите иметь защищённый раннер (https://github.com/ansible-collections/community.general/issues/5925). - manageiq_policies - устарел
state=listв пользу использованияcommunity.general.manageiq_policies_info(https://github.com/ansible-collections/community.general/pull/5721). - manageiq_tags - устарел
state=listв пользу использованияcommunity.general.manageiq_tags_info(https://github.com/ansible-collections/community.general/pull/5727). - rax - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax module utils - код модулей utils полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_cbs - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_cbs_attachments - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_cdb - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_cdb_database - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_cdb_user - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_clb - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_clb_nodes - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_clb_ssl - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_dns - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_dns_record - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_facts - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_files - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_files_objects - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_identity - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_keypair - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_meta - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_mon_alarm - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_mon_check - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_mon_entity - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_mon_notification - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_mon_notification_plan - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_network - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_queue - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_scaling_group - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rax_scaling_policy - модуль полагается на устаревший библиотеку
pyraxи будет удалён в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5752). - rhn_channel, rhn_register - RHN размещённый на redhat.com был прекращён несколько лет назад, а Spacewalk 5 (который использует RHN) находится в конце жизненного цикла с 31 мая 2020 года; хотя эти модули могут работать на Uyuni / SUSE Manager (вилка Spacewalk 5), мы не слышали о том, чтобы кто-то использовал их в таких установках. Поэтому эти модули устарели и будут удалены в community.general 10.0.0, если не будет сообщений о их полезности, и, возможно, не будет человека, который возьмёт на себя их поддержку (https://github.com/ansible-collections/community.general/pull/6493).
community.hashi_vault
- ansible-core - поддержка
ansible-coreверсий2.11и2.12будет удалена в версии коллекции5.0.0, сделав2.13минимально поддерживаемой версиейansible-core(https://github.com/ansible-collections/community.hashi_vault/issues/340). - hashi_vault lookup - в
v5.0.0дублирующие параметры строк приведут к исключению вместо предупреждения (https://github.com/ansible-collections/community.hashi_vault/issues/356). - hvac - минимальная версия
hvacдля поддержки в версии коллекции5.0.0будет не менее1.0.2; этот минимум может быть повышен до выхода5.0.0, поэтому, пожалуйста, подпишитесь на связанный вопрос и следите за новыми сообщениями в журнале изменений (https://github.com/ansible-collections/community.hashi_vault/issues/324).
purestorage.fusion
- fusion_hw - модуль оборудования удаляется, так как изменение типа оборудования никогда не поддерживалось Pure Storage Fusion
- fusion_info - подмножество nigs устарело в пользу network_interface_groups и будет удалено в версии 1.7.0
- fusion_info - подмножество размещений устарело в пользу placement_groups и будет удалено в версии 1.7.0
- fusion_pg - параметр placement_engine устарел, потому что API Fusion больше не поддерживает этот параметр. Он будет удален в версии 2.0.0
- fusion_se - параметры «addresses», «gateway» и «network_interface_groups» устарели в пользу «iscsi» и будут удалены в версии 2.0.0
- fusion_tn - тенантные сети заменяются конечными точками хранения
`fusion_se`и группами сетевых интерфейсов`fusion_nig`
© 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_8.html