Spec-Zone.ru › Ansible

Руководство по переносу на Ansible 10

  • Плейбук
  • Командная строка
  • Устаревшие возможности
  • Модули
  • Плагины
  • Перенос пользовательских скриптов
  • Работа с сетями
  • Руководство по переносу на v10.7.0
  • Руководство по переносу на v10.6.0
  • Руководство по переносу на v10.5.0
  • Руководство по переносу на v10.4.0
  • Руководство по переносу на v10.3.0
  • Руководство по переносу на v10.2.0
  • Руководство по переносу на v10.1.0
  • Руководство по переносу на v10.0.0

Ansible 10 основан на Ansible-core 2.17.

Рекомендуем прочитать эту страницу вместе с списком изменений Ansible 10, чтобы понять, какие обновления могут потребоваться.

Плейбук

  • Условные выражения — из-за устранения уязвимости безопасности 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'
  • any_errors_fatal — если задача в блоке с разделом rescue завершается ошибкой на узле, раздел rescue выполняется на всех узлах. Это происходит потому, что any_errors_fatal автоматически помечает как сбой все узлы.

Командная строка

  • Python 2.7 и Python 3.6 больше не поддерживаются на удалённых узлах. Теперь для выполнения на целевых узлах требуется Python 3.7 или новее.

Устаревшие возможности

Существенных изменений нет

Модули

Существенных изменений нет

Удалённые модули

Следующие модули больше не существуют:

  • Существенных изменений нет

Уведомления об устаревании

Существенных изменений нет

Важные изменения модулей

Существенных изменений нет

Плагины

Существенных изменений нет

Перенос пользовательских скриптов

Существенных изменений нет

Работа с сетями

Существенных изменений нет

Руководство по переносу на v10.7.0

Известные проблемы

dellemc.openmanage

  • idrac_diagnostics — Issue(285322) — этот модуль не поддерживает экспорт файла диагностики в общую папку HTTP и HTTPS через SOCKS-прокси.
  • idrac_firmware — Issue(279282) — этот модуль не поддерживает обновление микропрограммы с использованием общих папок HTTP, HTTPS и FTP с аутентификацией на iDRAC8.
  • ome_smart_fabric_uplink — Issue(186024) — модуль поддерживается OpenManage Enterprise Modular, однако не позволяет создавать несколько восходящих каналов с одинаковым именем. Если восходящий канал создаётся с именем уже существующего, существующий канал изменяется.

Основные изменения

  • Отмена удаления netapp.storagegrid. Коллекция не будет удалена из Ansible 11 (https://forum.ansible.com/t/2811). Сопровождение коллекции взяла на себя другая команда NetApp.

dellemc.openmanage

  • omevv_baseline_profile — этот модуль позволяет управлять профилем базовой линии.
  • omevv_baseline_profile_info — этот модуль позволяет получать сведения о профиле базовой линии.
  • omevv_compliance_info — этот модуль позволяет получать отчёты о соответствии микропрограмм.

Устаревшие возможности

  • Коллекция ibm.spectrum_virtualize переименована в ibm.storage_virtualize. Пока обе коллекции включены в Ansible. Коллекция будет полностью удалена из Ansible 12. Обновите полные имена коллекций (FQCN): замените ibm.spectrum_virtualize на ibm.storage_virtualize.

Руководство по переносу на v10.6.0

Известные проблемы

dellemc.openmanage

  • idrac_diagnostics — Issue(285322) — этот модуль не поддерживает экспорт файла диагностики в общую папку HTTP и HTTPS через SOCKS-прокси.
  • idrac_firmware — Issue(279282) — этот модуль не поддерживает обновление микропрограммы с использованием общих папок HTTP, HTTPS и FTP с аутентификацией на iDRAC8.
  • ome_smart_fabric_uplink — Issue(186024) — модуль поддерживается OpenManage Enterprise Modular, однако не позволяет создавать несколько восходящих каналов с одинаковым именем. Если восходящий канал создаётся с именем уже существующего, существующий канал изменяется.

Основные изменения

ansible.posix

  • Прекращается поддержка Ansible 2.9; минимальной требуемой версией для этого выпуска будет ansible-core 2.15.

dellemc.openmanage

  • omevv_firmware_repository_profile — этот модуль позволяет управлять профилем репозитория микропрограмм.
  • omevv_firmware_repository_profile_info — этот модуль позволяет получать сведения о профиле репозитория микропрограмм.
  • omevv_vcenter_info — этот модуль позволяет получать сведения о vCenter.

fortinet.fortios

  • Улучшена логика функции SET: сначала отправляется запрос GET, затем PUT или POST.
  • Mantis
  • Добавлена поддержка новых версий FOS 7.6.0.

grafana.grafana

  • Добавлена поддержка раздела «distributor» в файле конфигурации mimir; автор — @HamzaKhait: https://github.com/grafana/grafana-ansible-collection/pull/247
  • Снова разрешена переменная alloy_user_groups; автор — @pjezek: https://github.com/grafana/grafana-ansible-collection/pull/276
  • Улучшения роли Alloy; автор — @voidquark: https://github.com/grafana/grafana-ansible-collection/pull/281
  • Обновление ansible-lint с версии 24.6.0 до 24.9.2; автор — @dependabot: https://github.com/grafana/grafana-ansible-collection/pull/270
  • Обновление pylint с версии 3.2.5 до 3.3.1; автор — @dependabot: https://github.com/grafana/grafana-ansible-collection/pull/273
  • Обеспечена работа режима check для сборщика otel; автор — @pieterlexis-tomtom: https://github.com/grafana/grafana-ansible-collection/pull/264
  • Исправлен аргумент message задачи dashboard; автор — @Nemental: https://github.com/grafana/grafana-ansible-collection/pull/256
  • Переменные Alloy обновлены для использования пространства имён grafana_alloy_, чтобы обеспечить их уникальность; автор — @Aethylred: https://github.com/grafana/grafana-ansible-collection/pull/209
  • Обновлён README.md; автор — @aioue: https://github.com/grafana/grafana-ansible-collection/pull/272
  • Обновлён README.md; автор — @aioue: https://github.com/grafana/grafana-ansible-collection/pull/275
  • Обновлён main.yml; автор — @aioue: https://github.com/grafana/grafana-ansible-collection/pull/274
  • Добавлен grafana_plugins_ops в defaults и документацию; автор — @weakcamel: https://github.com/grafana/grafana-ansible-collection/pull/251
  • Добавлена возможность задавать значение google_analytics_4_id; автор — @copolycube: https://github.com/grafana/grafana-ansible-collection/pull/249
  • Исправлены предупреждения ansible-lint о запрещённом неявном восьмеричном значении «0640»; автор — @copolycube: https://github.com/grafana/grafana-ansible-collection/pull/279

Устаревшие возможности

  • Коллекция community.network признана устаревшей. Она будет удалена из Ansible 12, если до выхода Ansible 12 никто не возьмёт на себя её сопровождение. Подробнее см. в разделе Процесс удаления коллекций, за которыми не ведётся сопровождение (https://forum.ansible.com/t/8030).
  • Коллекция google.cloud будет удалена из Ansible 12 из-за несоответствия требованиям включения в Ansible. У коллекции есть неустранённые ошибки проверок sanity. Подробнее см. в разделе Процесс удаления коллекций, не соответствующих требованиям к коллекциям, в том числе сведения о том, как отменить удаление (https://forum.ansible.com/t/8609).

community.network

  • Эта коллекция и весь содержащийся в ней контент не сопровождаются и признаны устаревшими (https://forum.ansible.com/t/8030). Если вы хотите сопровождать часть коллекции, скопируйте её в собственный репозиторий и сообщите об этом другим участникам обсуждения на форуме. Подробности см. в руководстве по созданию коллекций.

community.vmware

  • vmware_cluster_dpm — модуль признан устаревшим и будет удалён в community.vmware 6.0.0 (https://github.com/ansible-collections/community.vmware/pull/2217).
  • vmware_cluster_drs_recommendations — модуль признан устаревшим и будет удалён в community.vmware 6.0.0 (https://github.com/ansible-collections/community.vmware/pull/2218).

Руководство по переносу на v10.5.0

Известные проблемы

dellemc.openmanage

  • idrac_diagnostics — Issue(285322) — этот модуль не поддерживает экспорт файла диагностики в общую папку HTTP и HTTPS через SOCKS-прокси.
  • idrac_firmware — Issue(279282) — этот модуль не поддерживает обновление микропрограммы с использованием общих папок HTTP, HTTPS и FTP с аутентификацией на iDRAC8.
  • idrac_storage_volume — Issue(290766) — если на контроллере BOSS-N1 уже имеется виртуальный диск, при создании нового виртуального диска модуль сообщит об успехе вместо ошибки.
  • idrac_support_assist — Issue(308550) — модуль завершается с ошибкой, если путь к общей папке NFS содержит подкаталог.
  • ome_diagnostics — Issue(279193) — экспорт журналов сбора SupportAssist в общую папку завершается ошибкой в версии OME 4.0.0.
  • ome_smart_fabric_uplink — Issue(186024) — модуль поддерживается OpenManage Enterprise Modular, однако не позволяет создавать несколько восходящих каналов с одинаковым именем. Если восходящий канал создаётся с именем уже существующего, существующий канал изменяется.

Основные изменения

dellemc.openmanage

  • idrac_secure_boot — этот модуль позволяет настраивать атрибуты, импортировать и экспортировать сертификат безопасной загрузки, а также сбрасывать ключи.
  • idrac_system_erase — этот модуль позволяет стирать системные компоненты и компоненты хранилища сервера на iDRAC.

Устаревшие возможности

  • Коллекция ngine_io.exoscale признана устаревшей. Она будет удалена из Ansible 11, если до выхода Ansible 11 никто не возьмёт на себя её сопровождение. Подробнее см. в разделе Процесс удаления коллекций, за которыми не ведётся сопровождение (https://forum.ansible.com/t/2572).
  • Коллекция 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.
  • Коллекция sensu.sensu_go будет удалена из Ansible 12 из-за несоответствия требованиям включения в Ansible. У коллекции есть неустранённые ошибки проверок sanity. Подробнее см. в разделе Процесс удаления коллекций, не соответствующих требованиям к коллекциям, в том числе сведения о том, как отменить удаление (https://forum.ansible.com/t/8380).

community.general

  • hipchat — служба hipchat прекращена, а размещаемая самостоятельно версия выведена из эксплуатации в 2020 году. Поэтому модуль признан устаревшим и будет удалён из community.general 11.0.0, если никто не приведёт веских причин для его сохранения (https://github.com/ansible-collections/community.general/pull/8919).

Руководство по переносу на v10.4.0

Известные проблемы

dellemc.openmanage

  • idrac_diagnostics — Issue(285322) — этот модуль не поддерживает экспорт файла диагностики в общую папку HTTP и HTTPS через SOCKS-прокси.
  • idrac_firmware — Issue(279282) — этот модуль не поддерживает обновление микропрограммы с использованием общих папок HTTP, HTTPS и FTP с аутентификацией на iDRAC8.
  • idrac_storage_volume — Issue(290766) — если на контроллере BOSS-N1 уже имеется виртуальный диск, при создании нового виртуального диска модуль сообщит об успехе вместо ошибки.
  • idrac_support_assist — Issue(308550) — модуль завершается с ошибкой, если путь к общей папке NFS содержит подкаталог.
  • ome_diagnostics — Issue(279193) — экспорт журналов сбора SupportAssist в общую папку завершается ошибкой в версии OME 4.0.0.
  • ome_smart_fabric_uplink — Issue(186024) — модуль поддерживается OpenManage Enterprise Modular, однако не позволяет создавать несколько восходящих каналов с одинаковым именем. Если восходящий канал создаётся с именем уже существующего, существующий канал изменяется.

Основные изменения

dellemc.openmanage

  • idrac_secure_boot — этот модуль позволяет импортировать сертификат безопасной загрузки.
  • idrac_support_assist — этот модуль позволяет запускать сбор журналов SupportAssist на iDRAC и экспортировать их.

grafana.grafana

  • исправление: molecule для mimir должна использовать ansible core 2.16; автор — @GVengelen: https://github.com/grafana/grafana-ansible-collection/pull/254

Устаревшие возможности

amazon.aws

  • iam_role — поддержка создания и удаления профилей экземпляров IAM с помощью параметров create_instance_profile и delete_instance_profile признана устаревшей и будет удалена в одном из выпусков после 2026-05-01. Для управления профилями экземпляров IAM вместо этого можно использовать модуль amazon.aws.iam_instance_profile (https://github.com/ansible-collections/amazon.aws/pull/2221).

community.general

  • Утилиты модуля-декоратора MH cause_changes — параметры on_success и on_failure признаны устаревшими (https://github.com/ansible-collections/community.general/pull/8791).
  • pipx — поддержка версий инструмента командной строки pipx ниже 1.7.0 признана устаревшей и будет удалена из community.general 11.0.0 (https://github.com/ansible-collections/community.general/pull/8793).
  • pipx_info — поддержка версий инструмента командной строки pipx ниже 1.7.0 признана устаревшей и будет удалена из community.general 11.0.0 (https://github.com/ansible-collections/community.general/pull/8793).

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).

Руководство по переносу на v10.3.0

Известные проблемы

community.docker

  • docker_container — при указании MAC-адреса для сети контейнера, если сеть подключается после создания контейнера (например, из-за проверок идемпотентности), в некоторых случаях демон Docker игнорирует MAC-адрес (https://github.com/ansible-collections/community.docker/pull/933).

dellemc.openmanage

  • idrac_diagnostics — Issue(285322) — этот модуль не поддерживает экспорт файла диагностики в общую папку HTTP и HTTPS через SOCKS-прокси.
  • idrac_firmware — Issue(279282) — этот модуль не поддерживает обновление микропрограммы с использованием общих папок HTTP, HTTPS и FTP с аутентификацией на iDRAC8.
  • idrac_storage_volume — Issue(290766) — если на контроллере BOSS-N1 уже имеется виртуальный диск, при создании нового виртуального диска модуль сообщит об успехе вместо ошибки.
  • ome_diagnostics — Issue(279193) — экспорт журналов сбора SupportAssist в общую папку завершается ошибкой в версии OME 4.0.0.
  • ome_smart_fabric_uplink — Issue(186024) — модуль поддерживается OpenManage Enterprise Modular, однако не позволяет создавать несколько восходящих каналов с одинаковым именем. Если восходящий канал создаётся с именем уже существующего, существующий канал изменяется.

Устаревшие возможности

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.

Руководство по переносу для v10.2.0

Добавленные коллекции

  • kubevirt.core (версия 1.5.0)
  • vmware.vmware (версия 1.3.0)

Известные проблемы

dellemc.openmanage

  • idrac_diagnostics — проблема (285322): этот модуль не поддерживает экспорт файла диагностики в общую папку HTTP и HTTPS через SOCKS-прокси.
  • idrac_firmware — проблема (279282): этот модуль не поддерживает обновление прошивки с использованием общих папок HTTP, HTTPS и FTP с аутентификацией на iDRAC8.
  • idrac_storage_volume — проблема (290766): если на контроллере BOSS-N1 уже имеется виртуальный диск, при создании нового виртуального диска модуль сообщит об успешном выполнении вместо сообщения об ошибке.
  • ome_diagnostics — проблема (279193): экспорт журналов коллекции SupportAssist в расположение общей папки завершается с ошибкой в OME версии 4.0.0.
  • ome_smart_fabric_uplink — проблема (186024): модуль поддерживается OpenManage Enterprise Modular, однако не позволяет создавать несколько восходящих каналов с одинаковым именем. Если создать восходящий канал с именем уже существующего, существующий восходящий канал будет изменён.

Основные изменения

dellemc.openmanage

  • idrac_server_config_profile — модуль дополнен возможностью экспорта и импорта пользовательских значений по умолчанию на iDRAC.
  • ome_configuration_compliance_baseline — модуль дополнен возможностью планировать задание по устранению несоответствий и отложить перезагрузку.

fortinet.fortios

  • Добавлен файл sanity_test.yaml для запуска тестов CI в GitHub.
  • Добавлена поддержка Ansible-core 2.17.
  • Добавлена поддержка новых версий FOS 7.4.4.

grafana.grafana

  • Добавлена проверка конфигурации перед перезапуском mimir, автор — @panfantastic: https://github.com/grafana/grafana-ansible-collection/pull/198
  • Добавлена поддержка настройки feature_toggles в роли grafana, автор — @LexVar: https://github.com/grafana/grafana-ansible-collection/pull/173
  • Перенесена проверка работоспособности после настройки из agent в alloy, автор — @v-zhuravlev: https://github.com/grafana/grafana-ansible-collection/pull/213
  • Обновлён ansible-lint с версии 24.2.3 до 24.5.0, автор — @dependabot: https://github.com/grafana/grafana-ansible-collection/pull/207
  • Обновлён ansible-lint с версии 24.5.0 до 24.6.0, автор — @dependabot: https://github.com/grafana/grafana-ansible-collection/pull/216
  • Обновлён braces с версии 3.0.2 до 3.0.3 в группе npm_and_yarn в одном каталоге, автор — @dependabot: https://github.com/grafana/grafana-ansible-collection/pull/218
  • Обновлён pylint с версии 3.1.0 до 3.1.1, автор — @dependabot: https://github.com/grafana/grafana-ansible-collection/pull/200
  • Обновлён pylint с версии 3.1.1 до 3.2.2, автор — @dependabot: https://github.com/grafana/grafana-ansible-collection/pull/208
  • Обновлён pylint с версии 3.2.2 до 3.2.3, автор — @dependabot: https://github.com/grafana/grafana-ansible-collection/pull/217
  • Обновлён pylint с версии 3.2.3 до 3.2.5, автор — @dependabot: https://github.com/grafana/grafana-ansible-collection/pull/234
  • Выполнен переход с config.river на config.alloy, автор — @cardasac: https://github.com/grafana/grafana-ansible-collection/pull/225
  • Исправлена конфигурация Grafana для унифицированной и устаревшей систем оповещений с учётом версии, автор — @voidquark: https://github.com/grafana/grafana-ansible-collection/pull/215
  • Добавлена поддержка добавления пользователя alloy в дополнительные группы, автор — @v-zhuravlev: https://github.com/grafana/grafana-ansible-collection/pull/212
  • Выполнено обновление result.json[‘message’] до result.json()[‘message’], автор — @CPreun: https://github.com/grafana/grafana-ansible-collection/pull/223

Устаревшие функции

  • Коллекция frr.frr объявлена устаревшей. Она будет удалена из Ansible 11, если до выхода Ansible 11 никто не возобновит её сопровождение. Подробнее см. в разделе Процесс удаления неподдерживаемых коллекций (https://forum.ansible.com/t/6243).
  • Коллекция openvswitch.openvswitch объявлена устаревшей. Она будет удалена из Ansible 11, если до выхода Ansible 11 никто не возобновит её сопровождение. Подробнее см. в разделе Процесс удаления неподдерживаемых коллекций (https://forum.ansible.com/t/6245).

Руководство по переносу для v10.1.0

Добавленные коллекции

  • ieisystem.inmanage (версия 2.0.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).

dellemc.openmanage

  • idrac_diagnostics — проблема (285322): этот модуль не поддерживает экспорт файла диагностики в общую папку HTTP и HTTPS через SOCKS-прокси.
  • idrac_firmware — проблема (279282): этот модуль не поддерживает обновление прошивки с использованием общих папок HTTP, HTTPS и FTP с аутентификацией на iDRAC8.
  • idrac_storage_volume — проблема (290766): если на контроллере BOSS-N1 уже имеется виртуальный диск, при создании нового виртуального диска модуль сообщит об успешном выполнении вместо сообщения об ошибке.
  • ome_diagnostics — проблема (279193): экспорт журналов коллекции SupportAssist в расположение общей папки завершается с ошибкой в OME версии 4.0.0.
  • ome_smart_fabric_uplink — проблема (186024): модуль поддерживается OpenManage Enterprise Modular, однако не позволяет создавать несколько восходящих каналов с одинаковым именем. Если создать восходящий канал с именем уже существующего, существующий восходящий канал будет изменён.

Основные изменения

containers.podman

  • Добавлены подключение и отключение томов
  • Добавлена поддержка нескольких подсетей для сетей
  • Добавлены новые параметры для podman_container
  • Добавлены новые параметры для модуля pod
  • Добавлен поиск podman
  • Улучшена идемпотентность сетевых операций в podman_container
  • Переработана идемпотентность модуля Podman Pod

dellemc.openmanage

  • Добавлена поддержка использования идентификатора сеанса для аутентификации в iDRAC, OpenManage Enterprise и OpenManage Enterprise Modular.
  • ome_session — этот модуль позволяет создавать и удалять сеансы в OpenManage Enterprise и OpenManage Enterprise Modular.

Устаревшие функции

community.general

  • Утилита модуля CmdRunner — задание значения параметра ignore_none в контексте CmdRunner объявлено устаревшим; эту функцию следует удалить в community.general 12.0.0 (https://github.com/ansible-collections/community.general/pull/8479).
  • git_config — параметр list_all объявлен устаревшим и будет удалён в community.general 11.0.0. Вместо него используйте модуль community.general.git_config_info (https://github.com/ansible-collections/community.general/pull/8453).
  • git_config — использование state=present без указания value объявлено устаревшим и будет запрещено в community.general 11.0.0. Для чтения значения вместо этого используйте модуль community.general.git_config_info (https://github.com/ansible-collections/community.general/pull/8453).

Руководство по переносу для версии 10.0.0

Добавленные коллекции

  • community.library_inventory_filtering_v1 (версия 1.0.1)
  • kaytus.ksmanage (версия 1.2.1)

Известные проблемы

community.docker

  • Обратите внимание: исправление для requests 2.32.0, включённое в community.docker 3.10.1, устраняет проблемы только с включённым в поставку кодом Docker SDK for Python. Модули и плагины, использующие Docker SDK for Python, всё ещё могут завершаться с ошибкой, поскольку SDK в настоящее время несовместим с requests 2.32.0.

    Если у вас всё ещё возникают проблемы с requests 2.32.0, например сообщения об ошибках вида Not supported URL scheme http+docker, ограничьте версию requests значением <2.32.0.

dellemc.openmanage

  • idrac_diagnostics — Issue(285322) — этот модуль не поддерживает экспорт файла диагностики в общую папку HTTP и HTTPS через SOCKS-прокси.
  • idrac_firmware — Issue(279282) — этот модуль не поддерживает обновление прошивки с использованием общих папок HTTP, HTTPS и FTP с аутентификацией на iDRAC8.
  • idrac_network_attributes — Issue(279049) — если для параметра ome_network_attributes указаны неподдерживаемые значения, модуль не выводит корректное сообщение об ошибке.
  • idrac_storage_volume — Issue(290766) — модуль сообщит об успешном выполнении вместо сообщения об ошибке при создании нового виртуального диска на контроллере BOSS-N1, если на том же контроллере уже имеется виртуальный диск.
  • ome_device_network_services — Issue(212681) — модуль не выводит корректное сообщение об ошибке, если для следующих параметров указаны неподдерживаемые значения: port_number, community_name, max_sessions, max_auth_retries и idle_timeout.
  • ome_device_power_settings — Issue(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 — Issue(275231) — этот модуль не развёртывает новую конфигурацию в слотах с отключённым IPv6.
  • ome_diagnostics — Issue(279193) — экспорт журналов сбора SupportAssist в общую папку завершается ошибкой в OME версии 4.0.0.
  • ome_smart_fabric_uplink — Issue(186024) — модуль поддерживается OpenManage Enterprise Modular, однако не позволяет создавать несколько восходящих каналов с одинаковым именем. Если восходящий канал создан с именем существующего канала, существующий канал изменяется.

Несовместимые изменения

Ansible-core

  • assert — вложенная шаблонизация может привести к невозможности вычисления условия. Дополнительную информацию см. в руководстве по переносу.

amazon.aws

  • Коллекция amazon.aws — прекращена поддержка ansible-core < 2.15 (https://github.com/ansible-collections/amazon.aws/pull/2093).
  • iam_role — iam_role.assume_role_policy_document больше не преобразуется из CamelCase в snake_case (https://github.com/ansible-collections/amazon.aws/pull/2040).
  • iam_role_info — iam_role.assume_role_policy_document больше не преобразуется из CamelCase в snake_case (https://github.com/ansible-collections/amazon.aws/pull/2040).
  • kms_key — возвращаемое значение policies переименовано в key_policies; его содержимое не изменилось (https://github.com/ansible-collections/amazon.aws/pull/2040).
  • kms_key_info — возвращаемое значение policies переименовано в key_policies; его содержимое не изменилось (https://github.com/ansible-collections/amazon.aws/pull/2040).
  • lambda_event — | batch_size больше не принимает значение 100 по умолчанию. Согласно API boto3 (https://boto3.amazonaws.com/v1/documentation/api/1.26.78/reference/services/lambda.html#Lambda.Client.create_event_source_mapping), для batch_size по умолчанию устанавливается значение 10 для источников sqs и 100 для потоковых источников (https://github.com/ansible-collections/amazon.aws/pull/2025).

cloud.common

  • Минимальная поддерживаемая версия Python повышена до 3.9.
  • Прекращена поддержка ansible-core < 2.14.

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. В плейбуках, где для этого модуля используется полное имя коллекции, его следует заменить на amazon.aws.aws_region_info.
  • aws_s3_bucket_info — модуль перенесён из коллекции community.aws. В плейбуках, где для этого модуля используется полное имя коллекции, его следует заменить на amazon.aws.aws_s3_bucket_info.
  • Коллекция community.aws — прекращена поддержка ansible-core < 2.15 (https://github.com/ansible-collections/community.aws/pull/2074).
  • Коллекция 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 в этой коллекции была объявлена устаревшей в выпуске 6.0.0 и удалена в выпуске 7.0.0. (https://github.com/ansible-collections/amazon.aws/pull/1763).
  • 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/community.aws/pull/1945).
  • iam_managed_policy — модуль перенесён из коллекции community.aws. В плейбуках, где для этого модуля используется полное имя коллекции, его следует заменить на amazon.aws.iam_managed_policy (https://github.com/ansible-collections/community.aws/pull/1954).
  • iam_mfa_device_info — модуль перенесён из коллекции community.aws. В плейбуках, где для этого модуля используется полное имя коллекции, его следует заменить на amazon.aws.iam_mfa_device_info (https://github.com/ansible-collections/community.aws/pull/1953).
  • iam_password_policy — модуль перенесён из коллекции community.aws. В плейбуках, где для этого модуля используется полное имя коллекции, его следует заменить на amazon.aws.iam_password_policy.
  • iam_role — модуль перенесён из коллекции community.aws. В плейбуках, где для этого модуля используется полное имя коллекции, его следует заменить на amazon.aws.iam_role (https://github.com/ansible-collections/community.aws/pull/1948).
  • iam_role_info — модуль перенесён из коллекции community.aws. В плейбуках, где для этого модуля используется полное имя коллекции, его следует заменить на amazon.aws.iam_role_info (https://github.com/ansible-collections/community.aws/pull/1948).
  • s3_bucket_info — модуль перенесён из коллекции community.aws. В плейбуках, где для этого модуля используется полное имя коллекции, его следует заменить на amazon.aws.s3_bucket_info.
  • sts_assume_role — модуль перенесён из коллекции community.aws. В плейбуках, где для этого модуля используется полное имя коллекции, его следует заменить на amazon.aws.sts_assume_role.

community.ciscosmb

  • В фактах интерфейса «bandwith» исправлено на «bandwidth».

community.dns

  • Значение по умолчанию для параметров txt_character_encoding в различных модулях и плагинах изменено с octal на decimal (https://github.com/ansible-collections/community.dns/pull/196).
  • Плагины инвентаризации — filters больше не является псевдонимом simple_filters, а представляет собой новый, отдельный параметр (https://github.com/ansible-collections/community.dns/pull/196).
  • Плагины инвентаризации — параметр plugin теперь является обязательным (https://github.com/ansible-collections/community.dns/pull/196).
  • lookup, lookup_as_dict — значение по умолчанию для search изменено с false (неявное значение по умолчанию для community.dns 2.x.y) на true (https://github.com/ansible-collections/community.dns/issues/200, https://github.com/ansible-collections/community.dns/pull/201).

community.general

  • cpanm — значение по умолчанию параметра mode изменено с compatibility на new (https://github.com/ansible-collections/community.general/pull/8198).
  • django_manage — теперь для модуля требуется Django >= 4.1 (https://github.com/ansible-collections/community.general/pull/8198).
  • django_manage — теперь модуль завершится с ошибкой, если указан virtualenv, но в этом расположении нет виртуальной среды (https://github.com/ansible-collections/community.general/pull/8198).
  • redfish_command, redfish_config, redfish_info — значение по умолчанию для timeout изменено с 10 на 60 (https://github.com/ansible-collections/community.general/pull/8198).

community.hrobot

  • Плагин инвентаризации robot — filters больше не является псевдонимом simple_filters, а представляет собой новый, отдельный параметр (https://github.com/ansible-collections/community.hrobot/pull/101).

community.okd

  • Минимальная поддерживаемая версия Python повышена до 3.9 (https://github.com/openshift/community.okd/pull/202).
  • Прекращена поддержка ansible-core < 2.14 (https://github.com/openshift/community.okd/pull/202).

hetzner.hcloud

  • Прекращена поддержка ansible-core 2.13.
  • certificate — значения not_valid_before и not_valid_after теперь возвращаются в виде строк в формате ISO-8601.
  • certificate_info — значения not_valid_before и not_valid_after теперь возвращаются в виде строк в формате ISO-8601.
  • inventory — удалён устаревший параметр api_token_env; в качестве альтернативы можно использовать lookup ansible.builtin.env.
  • iso_info — значение deprecated теперь возвращается в виде строки в формате ISO-8601.

kubernetes.core

  • Прекращена поддержка ansible-core < 2.14.
  • Обновлена библиотека python kubernetes до версии 24.2.0, helm/kind-action — до 1.8.0, kubernetes — до версии >= 1.24.

theforeman.foreman

  • content_view_filter — этот модуль больше не управляет правилами; для этого следует использовать content_view_filter_rule.
  • Плагин инвентаризации — URL Foreman больше не задаётся по умолчанию как http://localhost:3000; теперь URL необходимо указывать обязательно.

vmware.vmware_rest

  • Прекращена поддержка ansible-core < 2.14.

Основные изменения

Ansible-core

  • urls.py — удалена поддержка Python 2.

ansible.netcommon

  • Минимальная версия requires_ansible повышена до >=2.14.0, поскольку поддержка предыдущих версий ansible-core прекращена.

ansible.utils

  • Минимальная версия netaddr повышена до >=0.10.1; начиная с этого выпуска минимальная версия netaddr, требуемая этой коллекцией, — >=0.10.1.
  • Минимальная версия requires_ansible повышена до >=2.14.0, поскольку поддержка предыдущих версий ansible-core прекращена.
  • Этот выпуск в основном устраняет несовместимые изменения в библиотеке netaddr.
  • В новой версии netaddr 1.0.0 метод IPAddress.is_private() удалён, а метод IPAddress.is_global() расширен и теперь поддерживает те же возможности. Это изменение отражено в плагине фильтра ipaddr.

arista.eos

  • Минимальная версия requires_ansible повышена до >=2.14.0, поскольку поддержка предыдущих версий ansible-core прекращена.
  • В этом выпуске из коллекции удалены модули и атрибуты, ранее объявленные устаревшими. Подробности см. в разделе Удалённые функции.
  • Обновлена базовая версия netcommon с 6.1.0 для поддержки плагина cli_restore.

cisco.asa

  • Минимальная версия requires_ansible повышена до >=2.14.0, поскольку поддержка предыдущих версий ansible-core прекращена.

cisco.ios

  • Минимальная версия requires_ansible повышена до >=2.14.0, поскольку поддержка предыдущих версий ansible-core прекращена.
  • Обновлена базовая версия netcommon с 6.1.0 для поддержки плагина cli_restore.
  • ios_ntp — удалён устаревший модуль ntp legacy.

cisco.iosxr

  • Минимальная версия requires_ansible повышена до >=2.14.0, поскольку поддержка предыдущих версий ansible-core прекращена.
  • В этом выпуске из коллекции удалены модуль и атрибуты, ранее объявленные устаревшими. Подробности см. в разделе Удалённые функции.
  • Обновлена базовая версия netcommon для поддержки плагина cli_restore.

cisco.nxos

  • Минимальная версия requires_ansible повышена до >=2.14.0, поскольку поддержка предыдущих версий ansible-core прекращена.
  • В этом выпуске из коллекции удалены четыре модуля, ранее объявленные устаревшими. Подробности см. в разделе Удалённые функции.
  • Минимальная требуемая версия ansible.netcommon обновлена до 6.1.0 для поддержки модуля cli_restore.

community.dns

  • Коллексия community.dns теперь зависит от коллекции community.library_inventory_filtering_v1. Эта служебная коллекция предоставляет функциональность фильтрации хостов для плагинов инвентаризации. Если вы используете пакет Ansible community, обе коллекции уже включены, и никаких дополнительных действий не требуется. Если вы устанавливаете коллекцию с помощью ansible-galaxy collection install, она будет установлена автоматически. Если вы устанавливаете коллекцию, копируя её файлы в расположение, где ansible-core может их найти, например клонируя репозиторий git, необходимо также установить зависимость, если вы используете плагины инвентаризации (https://github.com/ansible-collections/community.dns/pull/196).

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

  • Зависимости — для пакета requests, необходимого для hvac, в некоторых сценариях использования этой коллекции теперь задан более строгий диапазон версий из-за несовместимых изменений безопасности в ansible-core, перенесённых в предыдущие версии (https://github.com/ansible-collections/community.hashi_vault/pull/416).

community.hrobot

  • Коллекция community.hrobot теперь зависит от коллекции community.library_inventory_filtering_v1. Эта служебная коллекция предоставляет функциональность фильтрации хостов для плагинов инвентаризации. Если вы используете пакет Ansible community, обе коллекции уже включены, и никаких дополнительных действий не требуется. Если вы устанавливаете коллекцию с помощью ansible-galaxy collection install, она будет установлена автоматически. Если вы устанавливаете коллекцию, копируя её файлы в расположение, где ansible-core может их найти, например клонируя репозиторий git, необходимо также установить зависимость, если вы используете плагин инвентаризации (https://github.com/ansible-collections/community.hrobot/pull/101).

community.mysql

  • Поддержка версии коллекции 2.*.* прекращена; исправления ошибок больше не будут переноситься в неё. Рекомендуется перейти на последнюю версию.

containers.podman

  • Добавлена поддержка Quadlet для модулей Podman.

dellemc.openmanage

  • Все модули OME доработаны для поддержки переменных окружения OME_USERNAME и OME_PASSWORD в качестве резервных учётных данных.
  • Все модули iDRAC и Redfish доработаны для поддержки переменных окружения IDRAC_USERNAME и IDRAC_PASSWORD в качестве резервных учётных данных.
  • idrac_certificates — модуль доработан для поддержки импорта и экспорта CUSTOMCERTIFICATE.
  • idrac_diagnostics — добавлен модуль для запуска и экспорта диагностики на iDRAC.
  • idrac_gather_facts — эта роль доработана для поддержки безопасной загрузки.
  • idrac_license — добавлен модуль для настройки лицензий iDRAC.
  • idrac_session — этот модуль позволяет создавать и удалять сеансы на iDRAC.
  • idrac_user — добавлена роль для управления локальными пользователями iDRAC.

dellemc.unity

  • Добавлена поддержка Unity Puffin v5.4.

fortinet.fortios

  • В документацию добавлены примечания о модулях резервного копирования — как для monitor, так и для monitor_fact.
  • Добавлена поддержка новых версий FOS 7.4.2 и 7.4.3, а также типа данных mac_address в коллекции.
  • Все логические значения в документации и примерах обновлены до true/false.
  • Обновлена документация для log_fact.
  • В документации сведения о поддерживаемых версиях заменены с latest на конкретный номер версии с исправлениями.
  • Сообщение о несовпадении версий обновлено и теперь содержит диапазоны версий.
  • Минимальная требуемая версия Ansible обновлена до 2.14.
  • Минимальная требуемая версия Ansible обновлена до 2.15.
  • Для уменьшения размера коллекции конкретные номера версий заменены диапазонами поддерживаемых версий.

grafana.grafana

  • Добавлена роль Grafana Loki, автор — @voidquark: https://github.com/grafana/grafana-ansible-collection/pull/188
  • Добавлена роль Grafana Mimir, автор — @GVengelen: https://github.com/grafana/grafana-ansible-collection/pull/183
  • Добавлена новая часть конфигурации для настройки аутентификации на основе KeyCloak, автор — @he0s: https://github.com/grafana/grafana-ansible-collection/pull/191
  • Добавлена роль Ansible для Grafana Alloy, автор — @ishanjainn: https://github.com/grafana/grafana-ansible-collection/pull/169
  • Добавлена роль Ansible для OpenTelemetry Collector, автор — @ishanjainn: https://github.com/grafana/grafana-ansible-collection/pull/138
  • Добавлена роль promtail, автор — @voidquark: https://github.com/grafana/grafana-ansible-collection/pull/197
  • Обновлён ansible-lint с версии 24.2.2 до 24.2.3, автор — @dependabot: https://github.com/grafana/grafana-ansible-collection/pull/195

ibm.qradar

  • Минимальная версия requires_ansible повышена до >=2.14.0, поскольку поддержка предыдущих версий ansible-core прекращена.

infoblox.nios_modules

  • Диапазон поддерживаемых версий Ansible расширен с 2.13 до 2.16.
  • Диапазон поддерживаемых версий Python расширен с 3.8 до 3.10.

junipernetworks.junos

  • Минимальная версия requires_ansible повышена до >=2.14.0, поскольку поддержка предыдущих версий ansible-core прекращена.
  • В этом выпуске из коллекции удалены модули, ранее объявленные устаревшими. Подробности см. в разделе Удалённые функции.
  • Обновлена базовая версия netcommon с 6.1.0 для поддержки плагина cli_restore.

splunk.es

  • Минимальная версия requires_ansible повышена до >=2.14.0, поскольку поддержка предыдущих версий ansible-core прекращена.

Удалённые коллекции

  • community.azure (ранее включённая версия: 2.0.0)
  • community.sap (ранее включённая версия: 2.0.0)
  • gluster.gluster (ранее включённая версия: 1.0.2)
  • hpe.nimble (ранее включённая версия: 1.1.4)
  • netapp.aws (ранее включённая версия: 21.7.1)
  • netapp.azure (ранее включённая версия: 21.10.1)
  • netapp.elementsw (ранее включённая версия: 21.7.0)
  • netapp.um_info (ранее включённая версия: 21.8.1)
  • purestorage.fusion (ранее включённая версия: 1.6.0)

Удалённые функции

  • Коллекция community.azure считалась неподдерживаемой и была удалена из Ansible 10 (https://github.com/ansible-community/community-topics/issues/263). Пользователи по-прежнему могут установить эту коллекцию с помощью ansible-galaxy collection install community.azure.
  • Коллекция gluster.gluster считалась неподдерживаемой и была удалена из Ansible 10 (https://github.com/ansible-community/community-topics/issues/225). Пользователи по-прежнему могут установить эту коллекцию с помощью ansible-galaxy collection install gluster.gluster.
  • Коллекция hpe.nimble считалась неподдерживаемой и была удалена из Ansible 10 (https://github.com/ansible-community/community-topics/issues/254). Пользователи по-прежнему могут установить эту коллекцию с помощью ansible-galaxy collection install hpe.nimble.
  • Коллекция netapp.aws считалась неподдерживаемой и была удалена из Ansible 10 (https://github.com/ansible-community/community-topics/issues/223). Пользователи по-прежнему могут установить эту коллекцию с помощью ansible-galaxy collection install netapp.aws.
  • Коллекция netapp.azure считалась неподдерживаемой и была удалена из Ansible 10 (https://github.com/ansible-community/community-topics/issues/234). Пользователи по-прежнему могут установить эту коллекцию с помощью ansible-galaxy collection install netapp.azure.
  • Коллекция netapp.elementsw считалась неподдерживаемой и была удалена из Ansible 10 (https://github.com/ansible-community/community-topics/issues/235). Пользователи по-прежнему могут установить эту коллекцию с помощью ansible-galaxy collection install netapp.elementsw.
  • Коллекция netapp.um_info считалась неподдерживаемой и была удалена из Ansible 10 (https://github.com/ansible-community/community-topics/issues/244). Пользователи по-прежнему могут установить эту коллекцию с помощью ansible-galaxy collection install netapp.um_info.
  • Коллекция community.sap полностью удалена из Ansible. Она переименована в community.sap_libs. В конечном итоге коллекция будет полностью удалена из Ansible. Обновите свои FQCN с community.sap на community.sap_libs.
  • Устаревшая коллекция purestorage.fusion удалена (https://forum.ansible.com/t/3712).

Ansible-core

  • Удалены устаревшие API из ansible-docs (https://github.com/ansible/ansible/issues/81716).
  • Удалена устаревшая переменная среды JINJA2_NATIVE_WARNING (https://github.com/ansible/ansible/issues/81714)
  • Удалён устаревший scp_if_ssh из плагина подключения ssh (https://github.com/ansible/ansible/issues/81715).
  • Удалена устаревшая поддержка crypt из ansible.utils.encrypt (https://github.com/ansible/ansible/issues/81717)
  • Python 2.7 и Python 3.6 больше не поддерживаются в качестве удалённых версий. Для выполнения задач на целевых узлах теперь требуется Python 3.7 или новее.
  • В связи с прекращением поддержки Python 2 модуль yum и плагин действий yum удалены и перенаправлены на dnf.

amazon.aws

  • iam_role — возвращаемое значение iam_role.assume_role_policy_document_raw объявлено устаревшим. Теперь iam_role.assume_role_policy_document возвращает данные в том же формате, что и iam_role.assume_role_policy_document_raw (https://github.com/ansible-collections/amazon.aws/pull/2040).
  • iam_role_info — возвращаемое значение iam_role.assume_role_policy_document_raw объявлено устаревшим. Теперь iam_role.assume_role_policy_document возвращает данные в том же формате, что и iam_role.assume_role_policy_document_raw (https://github.com/ansible-collections/amazon.aws/pull/2040).
  • module_utils.policy — ранее объявленная устаревшей функция sort_json_policy_dict() удалена; вместо неё рекомендуется использовать compare_policies() (https://github.com/ansible-collections/amazon.aws/pull/2052).

arista.eos

  • Удалён устаревший модуль eos_bgp, заменённый на eos_bgp_global и eos_bgp_address_family.
  • Удалён устаревший модуль eos_logging, заменённый модулем ресурсов eos_logging_global.
  • Удалён устаревший атрибут timers.throttle.

cisco.ios

  • Модуль ios_ntp объявлен устаревшим; вместо него следует использовать ios_ntp_global.
  • Ранее объявленный устаревшим модуль ios_bgp удалён; вместо него следует использовать ios_bgp_global и ios_bgp_address_family.

cisco.iosxr

  • Удалён устаревший модуль iosxr_logging, заменённый модулем ресурсов iosxr_logging_global.

cisco.nxos

  • В этом выпуске удалён модуль nxos_logging.
  • В этом выпуске удалён модуль nxos_ntp.
  • В этом выпуске удалён модуль nxos_ntp_auth.
  • В этом выпуске удалён модуль nxos_ntp_options.

community.dns

  • Коллекция больше не поддерживает выпуски Ansible, ansible-base и ansible-core, срок поддержки которых истёк на момент выпуска версии 3.0.0. Это означает, что больше не поддерживаются Ansible 2.9, ansible-base 2.10, ansible-core 2.11, ansible-core 2.12 и ansible-core 2.13. Коллекция всё ещё может работать с этими версиями, однако может перестать работать в любой момент без предварительного уведомления, и это не будет считаться ошибкой (https://github.com/ansible-collections/community.dns/pull/196).
  • hetzner_dns_record_set, hetzner_dns_record — удалён устаревший псевдоним name параметра prefix (https://github.com/ansible-collections/community.dns/pull/196).
  • hosttech_dns_records — удалено перенаправление на модуль hosttech_dns_record_sets (https://github.com/ansible-collections/community.dns/pull/196).

community.general

  • Удалены устаревшие перенаправления для внутренних имён модулей. Эти внутренние перенаправления использовали чрезмерно длинные FQCN, например community.general.packaging.os.apt_rpm, и перенаправляли на короткие FQCN community.general.apt_rpm. Первоначально они требовались для реализации сопоставления плоских имён (flatmapping); когда различные инструменты начали рекомендовать пользователям длинные имена, flatmapping был удалён из коллекции, а для пользователей, уже последовавших этим неверным рекомендациям, были добавлены перенаправления (https://github.com/ansible-collections/community.general/pull/7835).
  • ansible_galaxy_install — параметры ack_ansible29 и ack_min_ansiblecore211 удалены. Они больше не оказывали никакого действия (https://github.com/ansible-collections/community.general/pull/8198).
  • cloudflare_dns — прекращена поддержка записей SPF. CloudFlare больше не поддерживает их (https://github.com/ansible-collections/community.general/pull/7782).
  • django_manage — удалена поддержка значений command cleanup, syncdb и validate. Вместо них используйте соответственно clearsessions, migrate и check (https://github.com/ansible-collections/community.general/pull/8198).
  • flowdock — этот модуль использовал HTTPS API, которые больше не существуют, поэтому он был удалён (https://github.com/ansible-collections/community.general/pull/8198).
  • Утилиты модулей mh.mixins.deps — DependencyMixin удалён. Вместо него используйте утилиты модуля deps (https://github.com/ansible-collections/community.general/pull/8198).
  • proxmox — параметр proxmox_default_behavior удалён (https://github.com/ansible-collections/community.general/pull/8198).
  • Модули rax*, утилиты модулей rax, фрагмент документации rax — модули Rackspace использовали устаревший пакет pyrax, поэтому были удалены (https://github.com/ansible-collections/community.general/pull/8198).
  • Утилиты модулей redhat — удалены классы Rhsm, RhsmPool и RhsmPools (https://github.com/ansible-collections/community.general/pull/8198).
  • redhat_subscription — удалён псевдоним autosubscribe параметра auto_attach (https://github.com/ansible-collections/community.general/pull/8198).
  • stackdriver — этот модуль использовал HTTPS API, которые больше не существуют, поэтому он был удалён (https://github.com/ansible-collections/community.general/pull/8198).
  • Модули webfaction_* — эти модули использовали HTTPS API, которые больше не существуют, поэтому они были удалены (https://github.com/ansible-collections/community.general/pull/8198).

community.grafana

  • Удалён устаревший аргумент message в grafana_dashboard

community.hrobot

  • Коллекция больше не поддерживает выпуски Ansible, ansible-base и ansible-core, срок поддержки которых истёк на момент выпуска версии 2.0.0. Это означает, что больше не поддерживаются Ansible 2.9, ansible-base 2.10, ansible-core 2.11, ansible-core 2.12 и ansible-core 2.13. Коллекция всё ещё может работать с этими версиями, однако может перестать работать в любой момент без предварительного уведомления, и это не будет считаться ошибкой (https://github.com/ansible-collections/community.hrobot/pull/101).

junipernetworks.junos

  • Удалён устаревший модуль junos_logging, заменённый модулем ресурсов junos_logging_global.

Устаревшие функции

  • Коллекция inspur.sm считается неподдерживаемой и будет удалена из Ansible 11, если до выхода Ansible 11 никто не возобновит её поддержку. Подробнее см. в разделе Процесс удаления коллекций для неподдерживаемых коллекций, в том числе о том, как это решение можно отменить (https://forum.ansible.com/t/2854).
  • Коллекция netapp.storagegrid считается неподдерживаемой и будет удалена из Ansible 11, если до выхода Ansible 11 никто не возобновит её поддержку. Подробнее см. в разделе Процесс удаления коллекций для неподдерживаемых коллекций, в том числе о том, как это решение можно отменить (https://forum.ansible.com/t/2811).

Ansible-core

  • Плагины vars старого типа, использующие точки входа get_host_vars или get_group_vars, объявлены устаревшими. Плагин следует обновить, унаследовав его от BaseVarsPlugin и определив метод get_vars в качестве точки входа.
  • Параметр ‘required’ в API ‘ansible.module_utils.common.process.get_bin_path’ объявлен устаревшим (https://github.com/ansible/ansible/issues/82464).
  • module_utils — импорт следующих вспомогательных функций из ansible.module_utils.basic объявлен устаревшим: get_exception, literal_eval, _literal_eval, datetime, signal, types, chain, repeat, PY2, PY3, b, binary_type, integer_types, iteritems, string_types, test_type, map и shlex_quote.
  • ansible-doc — атрибуты точки входа роли объявлены устаревшими и со временем перестанут отображаться в ansible-doc начиная с ansible-core 2.20 (https://github.com/ansible/ansible/issues/82639, https://github.com/ansible/ansible/pull/82678).
  • Плагин подключения paramiko: параметры конфигурации в глобальной области объявлены устаревшими и будут удалены в пользу тех же параметров, уже имеющихся в самом плагине. Пользователям не потребуется ничего менять (способ их настройки останется прежним), однако авторам плагинов, использующим глобальные константы, следует перейти на get_option() плагина.

amazon.aws

  • Модуль инвентаризации aws_ec2 — удаление ранее объявленного устаревшим параметра include_extra_api_calls запланировано на выпуск 9.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2040).
  • cloudformation — параметр template объявлен устаревшим и будет удалён в одном из выпусков после 2026-05-01. Вместе с модулем поиска можно использовать параметр template_body (https://github.com/ansible-collections/amazon.aws/pull/2048).
  • iam_policy — удаление ранее объявленного устаревшим возвращаемого ключа policies запланировано на выпуск 9.0.0. Вместо него используйте возвращаемый ключ policy_names (https://github.com/ansible-collections/amazon.aws/pull/2040).
  • iam_role_info — в одном из выпусков после 2026-05-01 пути должны будут начинаться и заканчиваться на / (https://github.com/ansible-collections/amazon.aws/pull/1998).
  • module_utils.botocore — параметр boto3 для get_aws_connection_info() будет удалён в одном из выпусков после 2025-05-01. Параметр boto3 игнорируется начиная с выпуска 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047).
  • module_utils.botocore — параметр boto3 для get_aws_region() будет удалён в одном из выпусков после 2025-05-01. Параметр boto3 игнорируется начиная с выпуска 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047).
  • module_utils.ec2 — параметр boto3 для get_ec2_security_group_ids_from_names() будет удалён в одном из выпусков после 2025-05-01. Параметр boto3 игнорируется начиная с выпуска 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047).
  • rds_param_group — модуль rds_param_group переименован в rds_instance_param_group. Способ использования модуля не изменился. Псевдоним rds_param_group будет удалён в версии 10.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2058).

community.aws

  • aws_glue_connection — срок удаления возвращаемого ключа connection_parameters из after 2024-06-01 изменён на выпуск 9.0.0; его заменит ключ raw_connection_parameters (https://github.com/ansible-collections/community.aws/pull/518).
  • ecs_cluster — обновлена информация об изменении значения по умолчанию для purge_capacity_providers: текущее значение по умолчанию False будет изменено на True в выпуске 9.0.0. Чтобы сохранить текущее поведение, явно укажите purge_capacity_providers=False (https://github.com/ansible-collections/community.aws/pull/1640).
  • ecs_service — обновлена информация об изменении значения по умолчанию для purge_placement_constraints: текущее значение по умолчанию False будет изменено на True в выпуске 9.0.0. Чтобы сохранить текущее поведение, явно укажите purge_placement_constraints=False (https://github.com/ansible-collections/community.aws/pull/1716).
  • ecs_service — обновлена информация об изменении значения по умолчанию для purge_placement_strategy: текущее значение по умолчанию False будет изменено на True в выпуске 9.0.0. Чтобы сохранить текущее поведение, явно укажите purge_placement_strategy=False (https://github.com/ansible-collections/community.aws/pull/1716).

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 — начиная с community.crypto все реализации CryptoBackend должны переопределять get_ordered_csr_identifiers(). После этого текущая реализация по умолчанию, которая просто сортирует результат get_csr_identifiers(), будет удалена (https://github.com/ansible-collections/community.crypto/pull/725).
  • Утилиты модуля acme.backends — начиная с community.crypto 3.0.0 необходимо реализовать метод get_cert_information() для криптографического бэкенда ACME (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).
  • openssl_csr_pipe, openssl_privatekey_pipe, x509_certificate_pipe — текущее поведение в режиме проверки объявлено устаревшим и изменится в community.crypto 3.0.0. Сейчас оно аналогично поведению модулей без _pipe: если объект необходимо создать или создать заново, устанавливается только статус changed, но сам объект не обновляется. Начиная с community.crypto 3.0.0 модули будут игнорировать режим проверки и всегда действовать так, как если бы он не был включён. Уже сейчас этого поведения можно добиться, добавив к задаче check_mode: false. Если вы считаете, что это нарушит ваш сценарий использования модуля, создайте issue в репозитории community.crypto (https://github.com/ansible-collections/community.crypto/issues/712, https://github.com/ansible-collections/community.crypto/pull/714).

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_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).
  • docker_container — значение по умолчанию ignore для параметра image_name_mismatch объявлено устаревшим и будет заменено на recreate в community.docker 4.0.0. Предупреждение об устаревании будет выводиться в случаях, когда используется значение по умолчанию и при его изменении поведение изменится (https://github.com/ansible-collections/community.docker/pull/703).
  • Различные модули и плагины — параметр ssl_version объявлен устаревшим и будет удалён из community.docker 4.0.0. Он уже удалён из Docker SDK for Python 7.0.0 и ранее был необходим только для обхода проблем SSL/TLS (https://github.com/ansible-collections/community.docker/pull/853).

community.general

  • Module_utils MH DependencyCtxMgr — объявить module_utils.mh.mixin.deps.DependencyCtxMgr устаревшим в пользу module_utils.deps (https://github.com/ansible-collections/community.general/pull/8280).
  • Module_utils ModuleHelper — объявить plugins.module_utils.module_helper.AnsibleModule устаревшим (https://github.com/ansible-collections/community.general/pull/8280).
  • Module_utils ModuleHelper — объявить plugins.module_utils.module_helper.DependencyCtxMgr устаревшим (https://github.com/ansible-collections/community.general/pull/8280).
  • Module_utils ModuleHelper — объявить plugins.module_utils.module_helper.StateMixin устаревшим (https://github.com/ansible-collections/community.general/pull/8280).
  • Module_utils ModuleHelper — объявить plugins.module_utils.module_helper.VarDict, устаревшим (https://github.com/ansible-collections/community.general/pull/8280).
  • Module_utils ModuleHelper — объявить plugins.module_utils.module_helper.VarMeta устаревшим (https://github.com/ansible-collections/community.general/pull/8280).
  • Module_utils ModuleHelper — объявить plugins.module_utils.module_helper.VarsMixin устаревшим (https://github.com/ansible-collections/community.general/pull/8280).
  • Module_utils ModuleHelper — объявить использование VarsMixin устаревшим в пользу использования module_utils VardDict (https://github.com/ansible-collections/community.general/pull/8226).
  • Module_utils vars ModuleHelper — срок устаревания VarMeta, VarDict и VarsMixin перенесён на версию 11.0.0 (https://github.com/ansible-collections/community.general/pull/8226).
  • apt_rpm — поведение state=present и state=installed объявлено устаревшим и изменится в community.general 11.0.0. Сейчас модуль обновляет пакет до последней версии, если используется одно из этих двух состояний. Если вы хотите сохранить такое поведение, явно укажите state=latest; если же пакет не следует обновлять, когда он уже установлен, переключитесь на state=present_not_latest. В community.general 11.0.0 поведение state=present и state=installed изменится и станет таким же, как у state=present_not_latest (https://github.com/ansible-collections/community.general/issues/8217, https://github.com/ansible-collections/community.general/pull/8285).
  • consul_acl — модуль объявлен устаревшим и будет удалён в community.general 10.0.0. Вместо него можно использовать consul_token и consul_policy (https://github.com/ansible-collections/community.general/pull/7901).
  • django_manage — параметр ack_venv_creation_deprecation больше не влияет на работу и будет удалён из community.general 11.0.0 (https://github.com/ansible-collections/community.general/pull/8198).
  • Модули gitlab — метод базовой аутентификации в API GitLab объявлен устаревшим и будет удалён в community.general 10.0.0 (https://github.com/ansible-collections/community.general/pull/8383).
  • Плагин обратного вызова 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).
  • irc — значения по умолчанию false для use_tls и validate_certs объявлены устаревшими и будут заменены на true в community.general 10.0.0 для повышения безопасности. Уже сейчас можно повысить безопасность, явно задав им значение true. Указание значений отключает предупреждение об устаревании (https://github.com/ansible-collections/community.general/pull/7578).

community.hrobot

  • Плагин инвентаризации robot — параметр filters переименован в simple_filters. Старое имя перестанет работать в community.hrobot 2.0.0 (https://github.com/ansible-collections/community.hrobot/pull/94).

community.okd

  • openshift — плагин инвентаризации openshift объявлен устаревшим и будет удалён в выпуске 4.0.0 (https://github.com/ansible-collections/kubernetes.core/issues/31).

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).

dellemc.openmanage

  • Модуль dellemc_idrac_storage_volume объявлен устаревшим и заменён на idrac_storage_volume.

kubernetes.core

  • k8s — плагин инвентаризации k8s объявлен устаревшим и будет удалён в выпуске 4.0.0 (https://github.com/ansible-collections/kubernetes.core/issues/31).

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/porting_guides/porting_guide_10.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API