Руководство по переносу на Ansible 4
Рекомендуется прочитать эту страницу вместе с Журналом изменений Ansible 4, чтобы понять, какие обновления вам могут потребоваться.
Плейбук
- Настройка
jinja2_nativeбольше не влияет на модуль шаблонов, который неявно возвращает строки. Для поиска шаблонов появился новый аргументjinja2_native(по умолчанию выключен), контролирующий эту функциональность. Остальные выражения Jinja2 по-прежнему работают на основе настройкиjinja2_native.
Командная строка
- Команда
ansible-galaxy loginбыла удалена, так как используемый ею API для аутентификации GitHub был закрыт. Публикация ролей или коллекций в Galaxy с использованиемansible-galaxyтеперь требует, чтобы токен API Galaxy был передан в командную строку с помощью файла токена (по умолчанию~/.ansible/galaxy_token) или (в режиме небезопасной работы) с аргументом--tokenк командеansible-galaxy.
Устаревшие элементы
Постоянная ansible.module_utils.basic._CHECK_ARGUMENT_TYPES_DISPATCHER устарела. Используйте ansible.module_utils.common.parameters.DEFAULT_TYPE_VALIDATORS вместо этого.
Изменения, требующие переписывания кода
Изменения в AnsibleModule
В связи с переходом на ArgumentSpecValidator для валидации спецификаций аргументов, следующие закрытые методы в AnsibleModule были удалены:
_check_argument_types()_check_argument_values()_check_arguments()-
_check_mutually_exclusive()–>ansible.module_utils.common.validation.check_mutually_exclusive() -
_check_required_arguments()–>ansible.module_utils.common.validation.check_required_arguments() -
_check_required_by()–>ansible.module_utils.common.validation.check_required_by() -
_check_required_if()–>ansible.module_utils.common.validation.check_required_if() -
_check_required_one_of()–>ansible.module_utils.common.validation.check_required_one_of() -
_check_required_together()–>ansible.module_utils.common.validation.check_required_together() -
_check_type_bits()–>ansible.module_utils.common.validation.check_type_bits() -
_check_type_bool()–>ansible.module_utils.common.validation.check_type_bool() -
_check_type_bytes()–>ansible.module_utils.common.validation.check_type_bytes() -
_check_type_dict()–>ansible.module_utils.common.validation.check_type_dict() -
_check_type_float()–>ansible.module_utils.common.validation.check_type_float() -
_check_type_int()–>ansible.module_utils.common.validation.check_type_int() -
_check_type_jsonarg()–>ansible.module_utils.common.validation.check_type_jsonarg() -
_check_type_list()–>ansible.module_utils.common.validation.check_type_list() -
_check_type_path()–>ansible.module_utils.common.validation.check_type_path() -
_check_type_raw()–>ansible.module_utils.common.validation.check_type_raw() -
_check_type_str()–>ansible.module_utils.common.validation.check_type_str() -
_count_terms()–>ansible.module_utils.common.validation.count_terms() _get_wanted_type()_handle_aliases()_handle_no_log_values()_handle_options()_set_defaults()_set_fallbacks()
Модули или плагины, использующие эти закрытые методы, должны использовать публичные функции в ansible.module_utils.common.validation или ArgumentSpecValidator.validate(), если выше не указана публичная функция.
Изменения в ansible.module_utils.common.parameters
Следующие функции в ansible.module_utils.common.parameters теперь являются закрытыми и не должны использоваться напрямую. Используйте ArgumentSpecValidator.validate() вместо этого.
list_no_log_valueslist_deprecationshandle_aliases
Другое
-
Обновление: Если вы обновляетесь с
ansible < 2.10или сansible-baseи используете pip, вам необходимоpip uninstall ansibleилиpip uninstall ansible-baseперед установкойansible-core, чтобы избежать конфликтов. - Python 3.8 на контроллере является мягким требованием для этого выпуска.
ansible-core2.11 по-прежнему работает с теми же версиями Python, что иansible-base2.10, однако 2.11 выводит предупреждение при запуске на контроллере с версией Python меньше 3.8. Это предупреждение можно отключить, установивANSIBLE_CONTROLLER_PYTHON_WARNING=Falseв вашей среде.ansible-core2.12 потребует Python 3.8 или выше. - Система конфигурации теперь проверяет поле
choices, поэтому любые настройки, нарушающие его, и которые игнорировались в 2.10, приводят к ошибке в 2.11. Например,ANSIBLE_COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH=0теперь вызывает ошибку (допустимые значенияignore,warnилиerror). - Команда
ansible-galaxyтеперь используетresolvelibдля разрешения зависимостей. В большинстве случаев это не должно повлиять на пользователя, кроме как улучшить производительность, но мы отмечаем это для полноты и исторической справки. - Если вы импортируете Python
module_utilsв свои модули, вы можете теперь отметить импорт как необязательный во время построения модульного пакета, обернув операторimportвtryилиifблок. Это позволяет модулям использоватьmodule_utilsкоторые могут отсутствовать во всех версиях Ansible или коллекции, и выполнять произвольные действия по восстановлению или отступлению во время выполнения модуля.
Модули
- Модуль
apt_keyявно определяетfileкак взаимоисключающие сdata,keyserverиurl. Их больше нельзя использовать вместе. - Модуль
metaтеперь поддерживает теги для пользовательских задач. Установите теги задачи на ‘always’, чтобы сохранить предыдущее поведение. Внутренниеmetaзадачи по-прежнему всегда выполняются.
Удаленные модули
Следующие модули больше не существуют:
- Без существенных изменений
Замечания о устаревших элементах
Без существенных изменений
Примечательные изменения в модулях
- facts - На NetBSD,
ansible_virtualization_typeтеперь пытается сообщить более точный результат, чемxenпри виртуализации и не работает на Xen. - facts - Факты виртуализации теперь включают
virtualization_tech_guestиvirtualization_tech_hostключи. Это списки технологий виртуализации, частью которых является гость, или которые предоставляет хост, соответственно. Например, если вы настроили хост для предоставления как KVM, так и VirtualBox, оба значения включены вvirtualization_tech_host. Аналогично, контейнер podman, запущенный в виртуальной машине, управляемой KVM, имеетvirtualization_tech_guestзначения["kvm", "podman", "container"]. - Тип параметра
filterизменен сstringнаlistв модуле setup, чтобы использовать более одного фильтра. Предыдущее поведение (использованиеstring) сохраняется и работает как единственный фильтр.
Плагины
- плагины инвентаризации -
CachePluginAdjudicator.flush()теперь вызывает базовый плагин кэшированияflush()вместо удаления только тех ключей, о которых он знает. Плагины инвентаризации должны использоватьdelete()для удаления конкретных ключей. Для пользователя это означает, что при вызове плагином инвентаризации его методаclear_cache(), данные фактов также могут быть удалены из кэша. Чтобы обойти это, пользователи могут настроить плагины инвентаризации для использования кэша, независимого от кэша фактов. - плагины обратной связи -
metaвыполнение задачи теперь отправляется вv2_playbook_on_task_startкак любая другая задача. По умолчанию туда отправляются только явные метазадачи. Плагины обратной связи могут выбрать получение внутренних, неявно созданных задач, чтобы также действовать на них, как указано в документации по разработке плагинов. - Теперь
choicesвалидируются, поэтому плагины, использующие неверный или неполный выбор, выдают ошибку в версии 2.11, если предоставленное значение не соответствует. Это легко исправить: обновите записи вchoicesдля соответствия реальности.
Перенос пользовательских скриптов
Нет заметных изменений
Руководство по переносу для v4.10.0
Основные изменения
containers.podman
- Добавление модуля podman_tag
- Добавление поддержки драйвера и параметров драйвера для секретов
Устаревшие функции
cisco.nxos
- Модуль nxos_snmp_community устарел.
- Модуль nxos_snmp_contact устарел.
- Модуль nxos_snmp_host устарел.
- Модуль nxos_snmp_location устарел.
- Модуль nxos_snmp_traps устарел.
- Модуль nxos_snmp_user устарел.
junipernetworks.junos
- Параметр ‘router_id’ устарел в модулях ресурсов junos_ospf_interfaces, junos_ospfv2 и junos_ospfv3.
Руководство по переносу для v4.9.0
Известные проблемы
purestorage.flashblade
- purefb_lag - Поле mac_address в ответе не заполняется. Эта проблема будет исправлена в будущей версии FlashBlade.
Основные изменения
fortinet.fortios
- Добавление реальных кейсов в раздел примеров для некоторых конфигурационных модулей.
- Сбор текущих конфигураций модулей и преобразование их в плейбуки.
- Поддержка FortiOS 7.0.1.
- Поддержка операций с членами (удаление/добавление дополнительных членов) для объекта, содержащего список членов.
- Поддержка функции селекторов в
fortios_monitor_factиfortios_log_fact.
Руководство по переносу для v4.8.0
Изменения, требующие переноса
community.zabbix
- Все роли теперь ссылаются на другие роли и модули через полные имена коллекций, что делает Ansible 2.10 минимально поддерживаемой версией для ролей (см. issue 477).
Устаревшие функции
community.azure
- Все модули community.azure.azure_rm_<resource>_facts устарели. Используйте модули azure.azcollection.azure_rm_<resource>_info вместо них (https://github.com/ansible-collections/community.azure/pull/24).
- Все модули community.azure.azure_rm_<resource>_info устарели. Используйте модули azure.azcollection.azure_rm_<resource>_info вместо них (https://github.com/ansible-collections/community.azure/pull/24).
- community.azure.azure_rm_managed_disk и community.azure.azure_rm_manageddisk устарели. Используйте azure.azcollection.azure_rm_manageddisk вместо них (https://github.com/ansible-collections/community.azure/pull/24).
- community.azure.azure_rm_virtualmachine_extension и community.azure.azure_rm_virtualmachineextension устарели. Используйте azure.azcollection.azure_rm_virtualmachineextension вместо них (https://github.com/ansible-collections/community.azure/pull/24).
- community.azure.azure_rm_virtualmachine_scaleset и community.azure.azure_rm_virtualmachinescaleset устарели. Используйте azure.azcollection.azure_rm_virtualmachinescaleset вместо них (https://github.com/ansible-collections/community.azure/pull/24).
community.hashi_vault
- lookup hashi_vault - Раздел
[lookup_hashi_vault]в файлеansible.cfgустарел и будет удален в версии коллекции3.0.0. Вместо него можно использовать раздел[hashi_vault_collection], который будет применяться ко всем плагинам в коллекции в дальнейшем (https://github.com/ansible-collections/community.hashi_vault/pull/144).
Руководство по переносу для v4.7.0
Основные изменения
openvswitch.openvswitch
- По ошибке мы пометили репозиторий как 2.0.0, и поскольку это не было задумано и не может быть отменено, мы выпускаем 2.0.1, чтобы проинформировать сообщество об обновлении основной версии.
Устаревшие функции
cisco.ios
- Модули ios_ntp устарели.
cisco.nxos
- Модули
nxos_ntp,nxos_ntp_options,nxos_ntp_authустарели.
community.vmware
- vmware_guest_vnc - В Sphere 7.0 был удалён встроенный сервер VNC (https://docs.vmware.com/en/VMware-vSphere/7.0/rn/vsphere-esxi-vcenter-server-70-release-notes.html#productsupport).
junipernetworks.junos
- Параметр router_id в модуле ospfv2 устарел.
Руководство по переносу для v4.6.0
Основные изменения
containers.podman
- Добавление генерации systemd для контейнеров
- Генерация файлов службы systemd для контейнеров
gluster.gluster
- Включите client.ssl, server.ssl перед запуском gluster volume (https://github.com/gluster/gluster-ansible-collection/pull/19)
Устаревшие функции
community.grafana
- lookup grafana_dashboard - Предоставление искажённой версии API-ключа больше не предпочтительно.
Руководство по переносу для v4.5.0
Основные изменения
hetzner.hcloud
- Введение групп размещения
ovirt.ovirt
- remove_stale_lun - Добавление роли для удаления устаревших LUN (https://bugzilla.redhat.com/1966873).
Устаревшие функции
ansible.netcommon
- network_cli - Параметр paramiko_ssh
look_for_keysбыл автоматически задан на основе значений параметровpasswordиprivate_key_file, переданных в network_cli. Этот параметр теперь можно задать явно, а автоматическое заданиеlook_for_keysбудет удалено после 2024-01-01 (https://github.com/ansible-collections/ansible.netcommon/pull/271).
cisco.ios
- Модуль ios_bgp устарел в пользу ios_bgp_global и ios_bgp_address_family.
- Удаление тестирования с поставщиком для задач интеграции ansible-test. Это помогает подготовиться к переходу на интеграционные тесты network-ee.
junipernetworks.junos
- Параметр router_id в модуле ospfv3 устарел.
Руководство по портированию для v4.4.0
Известные проблемы
dellemc.openmanage
- idrac_user - Проблема (192043) Модуль может завершиться с сообщением
unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress. Подождите завершения задачи и повторите выполнение.
Устаревшие функции
cisco.iosxr
- Модуль iosxr_logging устарел и заменён новым модулем ресурса iosxr_logging_global. Он будет удалён в выпуске после ‘2023-08-01’.
cisco.nxos
- Модуль nxos_logging устарел и заменён новым модулем ресурса nxos_logging_global. Он будет удалён в выпуске после ‘2023-08-01’.
community.docker
- docker_container - новое значение по умолчанию
command_handling’s,compatibility, устарело и будет изменено наcorrectв community.docker 3.0.0. Модуль выводит предупреждение об устаревании в случаях, когда поведение изменится. Обратите внимание, что ansible-core выводит предупреждение об устаревании только один раз, поэтому, если оно показано для более ранней задачи, могут быть и другие задачи с этим предупреждением, где оно не отображается (https://github.com/ansible-collections/community.docker/pull/186).
junipernetworks.junos
- Модуль junos_logging устарел и заменён новым модулем ресурса junos_logging_global. Он будет удалён в выпуске после ‘2023-08-01’.
vyos.vyos
- Модуль vyos_logging устарел и заменён новым модулем ресурса vyos_logging_global. Он будет удалён в выпуске после “2023-08-01”.
Руководство по портированию для v4.3.0
Основные изменения
netapp.cloudmanager
- Добавление стадии среды во все модули в cloudmanager
Устаревшие функции
community.hashi_vault
- Сборник hashi_vault - поддержка Python 3.5 будет удалена в версии
2.0.0community.hashi_vault(https://github.com/ansible-collections/community.hashi_vault/issues/81).
Руководство по портированию для v4.2.0
Известные проблемы
dellemc.openmanage
- 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_smart_fabric_uplink - Проблема (186024) Модуль ome_smart_fabric_uplink не позволяет создавать несколько каналов связи с одинаковым именем, хотя это поддерживается OpenManage Enterprise Modular. Если канал связи создаётся с тем же именем, что и существующий канал, существующий канал изменяется.
Основные изменения
community.vmware
- vmware_object_custom_attributes_info - добавлен новый модуль для сбора пользовательских атрибутов объекта (https://github.com/ansible-collections/community.vmware/pull/851).
dellemc.openmanage
- idrac_server_config_profile - Добавлена поддержка экспорта и импорта профиля конфигурации сервера через HTTP/HTTPS общий доступ.
- ome_device_group - Добавлена поддержка добавления устройств в группу с помощью IP-адресов устройств и идентификатора группы.
fortinet.fortios
- Новый модуль fortios_monitor_fact.
- Поддержка Fortios 7.0.
- Поддержка API-интерфейсов протокола логирования.
Устаревшие функции
- Сборник community.kubernetes переименован в kubernetes.core. В Ansible 5 community.kubernetes будет заменён пустым сборником, который имеет устаревшие перенаправления для всего текущего контента в kubernetes.core. Если вы используете FQCN, начинающиеся с
community.kubernetes., пожалуйста, обновите их доkubernetes.core.сейчас. Обратите внимание, что kubernetes.core включен в Ansible с Ansible 3.0.0 (https://github.com/ansible-community/community-topics/issues/22).
ansible.windows
- win_updates - Устарело возвращаемое значение
filtered_reasonдля каждого отфильтрованного обновления в пользуfiltered_reasons. Это было сделано для отображения всех причин, по которым обновление было отфильтровано, а не только первой причины. - win_updates - Устарело опцию
use_scheduled_task, так как она больше не используется. - win_updates - Устарели опции
whitelistиblacklistв пользуaccept_listиreject_listсоответственно, чтобы соответствовать новым стандартам, используемым в Ansible для этих типов опций.
community.general
- ali_instance_info - пометка об удалении устаревших параметров
availability_zoneиinstance_names(https://github.com/ansible-collections/community.general/issues/2429). - serverless - устаревание параметра
functionsиз-за его отсутствия в коде (https://github.com/ansible-collections/community.general/pull/2845).
community.hashi_vault
- Сборник hashi_vault - поддержка Python 2 будет удалена в версии
2.0.0community.hashi_vault(https://github.com/ansible-collections/community.hashi_vault/issues/81).
Руководство по переносу для версии v4.1.0
Известные проблемы
dellemc.openmanage
- 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_smart_fabric_uplink - Проблема (186024) Модуль ome_smart_fabric_uplink не позволяет создавать несколько аплинков с одинаковым именем, хотя это поддерживается OpenManage Enterprise Modular. Если аплинк создается с тем же именем, что и существующий аплинк, существующий аплинк изменяется.
Основные изменения
cloudscale_ch.cloud
- Добавление модуля custom_image
community.postgresql
- postgresql_query - Значение по умолчанию параметра
as_single_queryбудет изменено наyesв community.postgresql 2.0.0 (https://github.com/ansible-collections/community.postgresql/issues/85).
dellemc.openmanage
- ome_firmware_baseline - Модуль поддерживает режим проверки и позволяет изменять и удалять базовые образцы прошивки.
- ome_firmware_catalog - Модуль поддерживает режим проверки и позволяет изменять и удалять каталоги прошивки.
fortinet.fortios
- Улучшение
fortios_configuration_factдля одновременного использования нескольких селекторов. - Поддержка
check_modeво всех модулях, основанных на cofigurationAPI. - Поддержка фильтрации для модулей сбора фактов
fortios_configuration_factиfortios_monitor_fact. - Поддержка перемещения политики в
firewall_central_snat_map. - Унификация схем для мониторинга API.
netbox.netbox
- пакеты теперь являются обязательным пакетом Python и устанавливаются через Ansible 2.10+.
Удаленные возможности
ansible.windows
- win_reboot - Удалены
shutdown_timeoutиshutdown_timeout_sec, которые не выполняли никаких действий с Ansible 2.5.
Устаревшие возможности
ansible.windows
- win_reboot - Недоступные хосты могут быть проигнорированы с помощью
ignore_errors: True, эта возможность будет удалена в будущей версии. Используйтеignore_unreachable: Trueдля игнорирования недоступных хостов вместо этого. - https://github.com/ansible-collections/ansible.windows/issues/62
community.docker
- docker_* модули и плагины, за исключением плагина подключения
docker_swarmиdocker_composeиdocker_stack*` modules - the current default ``localhostдляtls_hostnameустарели. В community.docker 2.0.0 он будет вычисляться изdocker_hostвместо этого (https://github.com/ansible-collections/community.docker/pull/134).
community.general
- Все скрипты инвентаризации и vault будут удалены из community.general в версии 4.0.0. Если вы ссылаетесь на них, обновите свои ссылки на новый репозиторий GitHub contrib-scripts, чтобы ваш рабочий процесс не прервался после выпуска community.general 4.0.0 (https://github.com/ansible-collections/community.general/pull/2697).
- Плагины поиска nios, nios_next_ip, nios_next_network, фрагмент документации nios, а также модули nios_host_record, nios_ptr_record, nios_mx_record, nios_fixed_address, nios_zone, nios_member, nios_a_record, nios_aaaa_record, nios_network, nios_dns_view, nios_txt_record, nios_naptr_record, nios_srv_record, nios_cname_record, nios_nsgroup и nios_network_view устарели и будут удалены из community.general 5.0.0. Вместо этого установите коллекцию infoblox.nios_modules и используйте её плагины и модули (https://github.com/ansible-collections/community.general/pull/2458).
- Вендированный экземпляр
ipaddressбудет удален в community.general 4.0.0. Переключитесь наipaddressиз стандартной библиотеки Python 3 или с pypi, если ваш код зависит от вендированной версииipaddress(https://github.com/ansible-collections/community.general/pull/2459). - linode - параметр
backupsenabledустарел и будет удалён в community.general 5.0.0 (https://github.com/ansible-collections/community.general/pull/2410). - lxd плагин инвентаризации - плагин будет требовать
ipaddressпри использовании с Python 2 начиная с community.general 4.0.0.ipaddressвходит в стандартную библиотеку Python 3, но может быть установлен для Python 2 с pypi (https://github.com/ansible-collections/community.general/pull/2459). - scaleway_security_group_rule - модуль будет требовать
ipaddressпри использовании с Python 2 начиная с community.general 4.0.0.ipaddressвходит в стандартную библиотеку Python 3, но может быть установлен для Python 2 с pypi (https://github.com/ansible-collections/community.general/pull/2459).
inspur.sm
- add_ad_group - Эта функция будет удалена в inspur.sm.add_ad_group 3.0.0. Заменено на inspur.sm.ad_group.
- add_ldap_group - Эта функция будет удалена в inspur.sm.add_ldap_group 3.0.0. Заменено на inspur.sm.ldap_group.
- add_user - Эта функция будет удалена в inspur.sm.add_user 3.0.0. Заменено на inspur.sm.user.
- add_user_group - Эта функция будет удалена в inspur.sm.add_user_group 3.0.0. Заменено на inspur.sm.user_group.
- del_ad_group - Эта функция будет удалена в inspur.sm.del_ad_group 3.0.0. Заменено на inspur.sm.ad_group.
- del_ldap_group - Эта функция будет удалена в inspur.sm.del_ldap_group 3.0.0. Заменено на inspur.sm.ldap_group.
- del_user - Эта функция будет удалена в inspur.sm.del_user 3.0.0. Заменено на inspur.sm.user.
- del_user_group - Эта функция будет удалена в inspur.sm.del_user_group 3.0.0. Заменено на inspur.sm.user_group.
- edit_ad_group - Эта функция будет удалена в inspur.sm.edit_ad_group 3.0.0. Заменено на inspur.sm.ad_group.
- edit_ldap_group - Эта функция будет удалена в inspur.sm.edit_ldap_group 3.0.0. Заменено на inspur.sm.ldap_group.
- edit_user - Эта функция будет удалена в inspur.sm.edit_user 3.0.0. Заменено на inspur.sm.user.
- edit_user_group - Эта функция будет удалена в inspur.sm.edit_user_group 3.0.0. Заменено на inspur.sm.user_group.
Руководство по переносу для v4.0.0
Известные проблемы
Ansible-core
- ansible-test - Тест
pylintцелостности больше не правильно обнаруживает «плохие» имена переменных для не-констант. См. проблему 3701 для получения дополнительной информации.
dellemc.openmanage
- 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_configuration_compliance_info - Проблема (195592) Модуль может выдавать ошибку с сообщением
unable to process the request because an error occurred. Если проблема сохраняется, сообщите об этом системному администратору. - ome_smart_fabric - Проблема (185322) Модуль OpenManage Enterprise Modular поддерживает только три типа конструкций, но модуль успешно создает структуру, когда тип конструкции не поддерживается.
- ome_smart_fabric_uplink - Проблема (186024) Модуль ome_smart_fabric_uplink не позволяет создавать несколько каналов связи с одинаковым именем, хотя это поддерживается OpenManage Enterprise Modular. Если канал связи создается с тем же именем, что и существующий, существующий канал связи изменяется.
fortinet.fortios
- Модули для API мониторинга пока не имеют версий.
Изменения, требующие переработки
Ansible-core
- Сделаны коллекции SCM, которые будут переустанавливаться независимо от наличия
--force. - Факты виртуализации NetBSD (в частности,
ansible_virtualization_type) теперь возвращают более точное значение, проверяя значение ключаmachdep.hypervisorsysctl. Это изменение требует переработки, поскольку в некоторых случаях ранее мы ошибочно сообщали оxen, даже если целевой сервер не работает на Xen. Это предотвращает это поведение в большинстве случаев. (https://github.com/ansible/ansible/issues/69352) - Замена решателя зависимостей в дереве на внешнюю реализацию, которую pip >= 20.3 использует теперь по умолчанию —
resolvelib. (https://github.com/ansible/ansible/issues/71784) - Модуль
metaтеперь поддерживает теги для задач, определенных пользователем. Внутренние задачиmetaпродолжают выполняться всегда. (https://github.com/ansible/ansible/issues/64558) - Команда ansible-galaxy login была удалена (см. проблему 71560)
ansible.netcommon
- Удален пакет ipaddress из коллекции. Если вы используете ansible_collections.ansible.netcommon.plugins.module_utils.compat.ipaddress в своей коллекции, вам необходимо изменить это на импорт ipaddress вместо него. Если ваш контент, использующий ipaddress, поддерживает Python 2.7, вам также необходимо убедиться, что у пользователя установлен пакет ipaddress. Обратитесь к https://docs.ansible.com/ansible/latest/dev_guide/developing_modules_best_practices.html#importing-and-using-shared-code, чтобы узнать, как безопасно импортировать внешние пакеты, которые могут отсутствовать на системе пользователя. Бэкпорт ipaddress для Python 2.7 доступен по адресу https://pypi.org/project/ipaddress/
community.docker
- docker_swarm - если
join_tokenуказан, возвращённый токен подключения со значением будет заменён наVALUE_SPECIFIED_IN_NO_LOG_PARAMETER. Убедитесь, что вы не используете токены подключения из возвращаемого значения этого модуля без проверки, когда модуль вызван с параметромjoin_token! Это изменение, требующее переработки, появилось в незначительной версии, поскольку необходимо исправить уязвимость безопасности (https://github.com/ansible-collections/community.docker/pull/103).
community.general
-
Если вы используете Ansible 2.9 и эти плагины или модули из этой коллекции, community.general 3.0.0 приводит к ошибкам при попытке использовать контент DellEMC по FQCN, например,
community.general.idrac_firmware. Поскольку Ansible 2.9 не может использовать перенаправления, вам нужно вручную изменить свои playbook и роли, чтобы использовать новые FQCN (dellemc.openmanage.idrac_firmwareв предыдущем примере) и убедиться, что у вас установленdellemc.openmanage.Если вы используете ansible-base 2.10 или новее и не устанавливали Ansible 4.0.0, но установили (и/или обновили) community.general вручную, вам необходимо убедиться, что также установлен
dellemc.openmanageколлекция, если вы используете какие-либо из этих плагинов или модулей. Хотя ansible-base 2.10 или новее может использовать перенаправления, добавленные community.general 3.0.0, коллекция, на которую они указывают (например, dellemc.openmanage), должна быть установлена для их работы. - gitlab_deploy_key - если для уже существующего ключа заголовок был задан другой открытый ключ в качестве параметра, ничего не происходило, теперь это изменено, так что открытый ключ обновляется до нового значения (https://github.com/ansible-collections/community.general/pull/1661).
- java_keystore - вместо того, чтобы вызывать ошибку, теперь перезаписывает keystore, если alias (имя) изменён. Это изначально было предполагаемым поведением, но не работало из-за логической ошибки. Убедитесь, что ваши playbook и роли не зависят от старого поведения, вызывающего ошибку вместо перезаписи (https://github.com/ansible-collections/community.general/issues/1671).
- java_keystore - вместо того, чтобы вызывать ошибку, теперь перезаписывает keystore, если пароль изменен. Убедитесь, что ваши playbook и роли не зависят от старого поведения, вызывающего ошибку вместо перезаписи (https://github.com/ansible-collections/community.general/issues/1671).
- one_image - используйте pyone вместо python-oca (https://github.com/ansible-collections/community.general/pull/2032).
- utm_proxy_auth_profile - значение
frontend_cookie_secretвозврата теперь содержит строку-заполнитель вместо параметраfrontend_cookie_secretмодуля (https://github.com/ansible-collections/community.general/pull/1736).
fortinet.fortios
- Модуль общего назначения FortiOS - Модуль FOS для выдачи запросов общего назначения с Ansible.
- Поддержка API мониторинга FOS - несколько новых модулей для API мониторинга.
- Объединённая коллекция - Сама коллекция fortios будет адаптировать любые платформы FOS.
servicenow.servicenow
- Поле auth теперь обязательно для всех, кроме аутентификации по протоколу Basic.
theforeman.foreman
- Все переменные ролей теперь имеют префикс
foreman_, чтобы избежать конфликтов с переменными, имеющими аналогичные имена, из ролей за пределами этой коллекции.
Основные изменения
Ansible-core
- Коллекцию можно переустановить с новыми требованиями к версии без использования флага
--force. Зависимости коллекции также будут обновлены при необходимости в соответствии с новыми требованиями. Используйте--upgrade, чтобы принудительно обновить транзитивные зависимости. - AnsibleModule - используйте класс
ArgumentSpecValidatorдля проверки спецификации аргументов и удалите закрытые методы, связанные с проверкой спецификации аргументов. Любые модули, использующие закрытые методы, теперь должны использовать классArgumentSpecValidatorили соответствующую функцию проверки. - Объявлен
resolvelib >= 0.5.3, < 0.6.0прямой зависимостью от ansible-core. Ссылки: - https://github.com/sarugaku/resolvelib - https://pypi.org/p/resolvelib - https://pradyunsg.me/blog/2020/03/27/pip-resolver-testing - Стало возможным устанавливать коллекции Ansible из локальных папок и папок пространств имен, подобно структуре SCM с несколькими коллекциями.
- Стало возможным обновлять коллекции Ansible с серверов Galaxy, используя опцию
--upgradeсansible-galaxy collection install. - Поддержка проверки спецификации аргументов роли во время выполнения роли. Когда роль содержит спецификацию аргументов, в начале выполнения роли вставляется неявная задача проверки.
- Добавлен класс
ArgumentSpecValidatorдля проверки параметров по спецификации аргументов внеAnsibleModule(https://github.com/ansible/ansible/pull/73335) - ansible-test - Тесты, выполняемые с помощью
centos6иdefaultконтейнеров тестирования, теперь используют контейнер-прокси PyPI для доступа к PyPI, когда используется Python 2.6. Это позволяет тестам, выполняемым под Python 2.6, продолжать функционировать, даже если PyPI прекращает поддержку клиентов, не поддерживающих SNI.
ansible.netcommon
- Удалены устаревшие аргументы подключения из netconf_config
arista.eos
- Требуется ansible.netcommon v2.0.0+ для поддержки
ansible_network_single_user_modeиansible_network_import_modules- Подробности см. в журнале изменений ansible.netcommon changelog.
cisco.asa
- Подробности см. в журнале изменений ansible.netcommon
changelog <https://github.com/ansible-collections/ansible.netcommon/blob/main/changelogs/CHANGELOG.rst#ansible-netcommon-collection-release-notes>. - Требуется ansible.netcommon v2.0.0+ для поддержки
ansible_network_single_user_modeиansible_network_import_modules.
cisco.ios
- Подробности см. в журнале изменений ansible.netcommon changelog.
- Требуется ansible.netcommon v2.0.0+ для поддержки
ansible_network_single_user_modeиansible_network_import_modules.
cisco.iosxr
- Подробности см. в журнале изменений ansible.netcommon changelog.
- Требуется ansible.netcommon v2.0.0+ для поддержки
ansible_network_single_user_modeиansible_network_import_modules. - ipaddress больше не входит в ansible.netcommon. Для версий Python без ipaddress (< 3.0) теперь требуется пакет ipaddress.
cisco.nxos
- Подробности см. в журнале изменений ansible.netcommon changelog.
- Требуется ansible.netcommon v2.0.0+ для поддержки
ansible_network_single_user_modeиansible_network_import_modules.
community.grafana
- Введен параметр “skip_version_check” в модулях grafana_teams и grafana_folder (#147)
community.mysql
- mysql_replication - добавлено предупреждение о устаревании, что значения возврата
Is_SlaveиIs_Masterбудут заменены наIs_PrimaryиIs_Replicaвcommunity.mysql3.0.0 (https://github.com/ansible-collections/community.mysql/pull/147). - mysql_replication - значения выбора опции
state, содержащиеmasterбудут окончательно заменены альтернативными значениямиprimaryвcommunity.mysql3.0.0, добавлены предупреждения об устаревании (https://github.com/ansible-collections/community.mysql/pull/150). - mysql_replication - значения параметров режима
getslave,startslave,stopslave,resetslave,resetslaveall` and the master_use_gtid option ``slave_posустарели (см. альтернативные значения) и будут удалены вcommunity.mysql3.0.0 (https://github.com/ansible-collections/community.mysql/pull/97). - mysql_replication - значения возврата
Is_SlaveиIs_Masterбудут заменены наIs_ReplicaиIs_Primaryвcommunity.mysql3.0.0 (https://github.com/ansible-collections/community.mysql/issues/145). - mysql_replication - слово
SLAVEв сообщениях, возвращаемых модулем, будет изменено наREPLICAвcommunity.mysql2.0.0 (https://github.com/ansible-collections/community.mysql/issues/98). - mysql_replication - слово
masterв сообщениях, возвращаемых модулем, будет заменено наprimaryвcommunity.mysql3.0.0 (https://github.com/ansible-collections/community.mysql/issues/145). - mysql_replication - слово
slaveв сообщениях, возвращаемых модулем, заменено наreplica(https://github.com/ansible-collections/community.mysql/issues/98). - mysql_user -
REQUIRESSLявляется псевдонимом для ключаsslв опцииtls_requiresвcommunity.mysql2.0.0, а поддержка будет полностью прекращена вcommunity.mysql3.0.0 (https://github.com/ansible-collections/community.mysql/issues/121).
fortinet.fortios
- Новый модуль fortios_configuration_fact
- Новый модуль fortios_json_generic
- Новый модуль fortios_monitor
- Новый модуль fortios_monitor_fact
junipernetworks.junos
- Подробности см. в журнале изменений ansible.netcommon changelog.
- Требуется ansible.netcommon v2.0.0+ для поддержки
ansible_network_single_user_modeиansible_network_import_modules.
netapp.ontap
- na_ontap_autosupport - Добавлена поддержка REST в модуль.
openvswitch.openvswitch
- Для данного выпуска нет существенных изменений, и он был помечен ошибочно и не может быть отменён.
servicenow.servicenow
- Переработан клиент для наследования от AnsibleModule
- поддерживает протокол аутентификации OpenID Connect
- поддерживает токен bearer для аутентификации
vyos.vyos
- Подробности см. в журнале изменений ansible.netcommon changelog.
- Требуется ansible.netcommon v2.0.0+ для поддержки
ansible_network_single_user_modeиansible_network_import_modules - ipaddress больше не входит в ansible.netcommon. Для версий Python без ipaddress (< 3.0) теперь требуется пакет ipaddress.
Удаленные возможности
Ansible-core
- Удален класс
SharedPluginLoaderObjиз ansible.plugins.strategy. Он был устарел в пользу использования стандартного загрузчика плагинов. - Удален псевдоним
_get_item()из базового класса плагина обратной связи, который был устарел в пользу_get_item_label(). - Параметр «user» ранее был устарел и теперь удален в пользу «scope»
- Удален устаревший
ansible.constants.BECOME_METHODS. - Удален устаревший
ansible.constants.get_config(). - Удален устаревший
ansible.constants.mk_boolean(). -
Петли
with_*больше не оптимизированы для модулей, чьи параметрыnameмогут принимать списки (в основном менеджеры пакетов). Используйтеnameвместо цикла по отдельным именам сwith_itemsи аналогичными.
community.general
-
Модули
ome_device_info,idrac_firmwareиidrac_server_config_profileтеперь перенесены из пакета community.general в коллекцию Ansible dellemc.openmanage. Если вы используете ansible-base 2.10 или более позднюю версию, перенаправления уже предоставлены.Если вы используете Ansible 2.9 и установили эту коллекцию, вам нужно скорректировать полные имена классов (
community.general.idrac_firmware→dellemc.openmanage.idrac_firmware) и убедиться, что установлена коллекция dellemc.openmanage. - Модуль ali_instance_facts, который устарел, удален. Используйте вместо него ali_instance_info (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль gluster_heal_info. Используйте gluster.gluster.gluster_heal_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль gluster_peer. Используйте gluster.gluster.gluster_peer вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль gluster_volume. Используйте gluster.gluster.gluster_volume вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль helm. Используйте community.kubernetes.helm вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль hpilo_facts. Используйте hpilo_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль idrac_redfish_facts. Используйте idrac_redfish_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль jenkins_job_facts. Используйте jenkins_job_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ldap_attr. Используйте ldap_attrs вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль memset_memstore_facts. Используйте memset_memstore_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль memset_server_facts. Используйте memset_server_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль na_ontap_gather_facts. Используйте netapp.ontap.na_ontap_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль nginx_status_facts. Используйте nginx_status_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль one_image_facts. Используйте one_image_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль onepassword_facts. Используйте onepassword_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль oneview_datacenter_facts. Используйте oneview_datacenter_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль oneview_enclosure_facts. Используйте oneview_enclosure_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль oneview_ethernet_network_facts. Используйте oneview_ethernet_network_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль oneview_fc_network_facts. Используйте oneview_fc_network_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль oneview_fcoe_network_facts. Используйте oneview_fcoe_network_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль oneview_logical_interconnect_group_facts. Используйте oneview_logical_interconnect_group_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль oneview_network_set_facts. Используйте oneview_network_set_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль oneview_san_manager_facts. Используйте oneview_san_manager_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль online_server_facts. Используйте online_server_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль online_user_facts. Используйте online_user_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt. Используйте ovirt.ovirt.ovirt_vm вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt_affinity_label_facts. Используйте ovirt.ovirt.ovirt_affinity_label_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt_api_facts. Используйте ovirt.ovirt.ovirt_api_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt_cluster_facts. Используйте ovirt.ovirt.ovirt_cluster_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt_datacenter_facts. Используйте ovirt.ovirt.ovirt_datacenter_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt_disk_facts. Используйте ovirt.ovirt.ovirt_disk_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt_event_facts. Используйте ovirt.ovirt.ovirt_event_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt_external_provider_facts. Используйте ovirt.ovirt.ovirt_external_provider_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt_group_facts. Используйте ovirt.ovirt.ovirt_group_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt_host_facts. Используйте ovirt.ovirt.ovirt_host_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt_host_storage_facts. Используйте ovirt.ovirt.ovirt_host_storage_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt_network_facts. Используйте ovirt.ovirt.ovirt_network_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt_nic_facts. Используйте ovirt.ovirt.ovirt_nic_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Удалён устаревший модуль ovirt_permission_facts. Используйте ovirt.ovirt.ovirt_permission_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль ovirt_quota_facts, который был устаревшим, удален. Используйте ovirt.ovirt.ovirt_quota_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль ovirt_scheduling_policy_facts, который был устаревшим, удален. Используйте ovirt.ovirt.ovirt_scheduling_policy_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль ovirt_snapshot_facts, который был устаревшим, удален. Используйте ovirt.ovirt.ovirt_snapshot_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль ovirt_storage_domain_facts, который был устаревшим, удален. Используйте ovirt.ovirt.ovirt_storage_domain_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль ovirt_storage_template_facts, который был устаревшим, удален. Используйте ovirt.ovirt.ovirt_storage_template_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль ovirt_storage_vm_facts, который был устаревшим, удален. Используйте ovirt.ovirt.ovirt_storage_vm_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль ovirt_tag_facts, который был устаревшим, удален. Используйте ovirt.ovirt.ovirt_tag_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль ovirt_template_facts, который был устаревшим, удален. Используйте ovirt.ovirt.ovirt_template_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль ovirt_user_facts, который был устаревшим, удален. Используйте ovirt.ovirt.ovirt_user_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль ovirt_vm_facts, который был устаревшим, удален. Используйте ovirt.ovirt.ovirt_vm_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль ovirt_vmpool_facts, который был устаревшим, удален. Используйте ovirt.ovirt.ovirt_vmpool_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль purefa_facts, который был устаревшим, удален. Используйте purestorage.flasharray.purefa_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль purefb_facts, который был устаревшим, удален. Используйте purestorage.flasharray.purefb_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль python_requirements_facts, который был устаревшим, удален. Используйте python_requirements_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль redfish_facts, который был устаревшим, удален. Используйте redfish_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль scaleway_image_facts, который был устаревшим, удален. Используйте scaleway_image_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль scaleway_ip_facts, который был устаревшим, удален. Используйте scaleway_ip_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль scaleway_organization_facts, который был устаревшим, удален. Используйте scaleway_organization_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль scaleway_security_group_facts, который был устаревшим, удален. Используйте scaleway_security_group_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль scaleway_server_facts, который был устаревшим, удален. Используйте scaleway_server_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль scaleway_snapshot_facts, который был устаревшим, удален. Используйте scaleway_snapshot_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль scaleway_volume_facts, который был устаревшим, удален. Используйте scaleway_volume_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль smartos_image_facts, который был устаревшим, удален. Используйте smartos_image_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль vertica_facts, который был устаревшим, удален. Используйте vertica_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Модуль xenserver_guest_facts, который был устаревшим, удален. Используйте xenserver_guest_info вместо него (https://github.com/ansible-collections/community.general/pull/1924).
- Документ ovirt_facts был удален (https://github.com/ansible-collections/community.general/pull/1924).
- airbrake_deployment - параметр
token, который был устаревшим, удален. Используйтеproject_idиproject_keyвместо него (https://github.com/ansible-collections/community.general/pull/1926). - bigpanda - псевдоним
messageудален. Используйтеdeployment_messageвместо него (https://github.com/ansible-collections/community.general/pull/1926). - cisco_spark, cisco_webex - псевдоним
messageудален. Используйтеmsgвместо него (https://github.com/ansible-collections/community.general/pull/1926). - clc_aa_policy - параметр
waitудален. Он не оказывал никакого влияния (https://github.com/ansible-collections/community.general/pull/1926). - datadog_monitor - псевдоним
messageудален. Используйтеnotification_messageвместо него (https://github.com/ansible-collections/community.general/pull/1926). - django_manage - параметр
liveserverудален (https://github.com/ansible-collections/community.general/pull/1926). - idrac_redfish_config - параметры
manager_attribute_nameиmanager_attribute_valueудалены. Используйтеmanager_attributesвместо них (https://github.com/ansible-collections/community.general/pull/1926). - iso_extract - псевдоним
thirstyудален. Используйтеforceвместо него (https://github.com/ansible-collections/community.general/pull/1926). - ldap_entry - параметр
paramsтеперь полностью удален. Его использование уже вызывало ошибку с версии community.general 0.1.2 (https://github.com/ansible-collections/community.general/pull/2257). - pulp_repo - параметр
feed_client_certбольше не имеет значения по умолчанию параметраclient_cert(https://github.com/ansible-collections/community.general/pull/1926). - pulp_repo - параметр
feed_client_keyбольше не имеет значения по умолчанию параметраclient_key(https://github.com/ansible-collections/community.general/pull/1926). - pulp_repo - псевдоним
ca_certудален. Используйтеfeed_ca_certвместо него (https://github.com/ansible-collections/community.general/pull/1926). - rax - неиспользуемый параметр
serviceудален (https://github.com/ansible-collections/community.general/pull/2020). - Модули redfish - команда изменения данных без указания идентификатора целевого ресурса системы, шасси или менеджера, когда их несколько, больше недоступна. Используйте опцию
resource_id, чтобы указать идентификатор цели (https://github.com/ansible-collections/community.general/pull/1926).
- redfish_config - параметры
bios_attribute_nameиbios_attribute_valueбыли удалены. Используйтеbios_attributesвместо них (https://github.com/ansible-collections/community.general/pull/1926). - syspatch - параметр
applyбыл удален. Это режим по умолчанию, поэтому простое удаление не изменит поведение (https://github.com/ansible-collections/community.general/pull/1926). - xbps - параметр
forceбыл удален. Он не оказывал никакого влияния (https://github.com/ansible-collections/community.general/pull/1926).
community.network
- Устаревшие параметры
community.network.ce_sflow:rate_limit,rate_limit_slot, иforward_enp_slotбыли удалены (https://github.com/ansible-collections/community.network/pull/255). - Устаревший плагин netconf
community.network.srosбыл удален. Используйтеnokia.sros.mdвместо него (https://github.com/ansible-collections/community.network/pull/255).
f5networks.f5_modules
- Поддержка TMOS v11 для модулей bigip_gtm_pool и bigip_gtm_wide_ip была удалена
- Параметры quorum и monitor_type в модуле bigip_node были удалены. См. раздел руководств по переносу на странице https://clouddocs.f5.com/products/orchestration/ansible/devel/usage/porting-guides.html
- Параметры syslog_settings и pool_settings в модуле bigip_log_destination были удалены. См. раздел руководств по переносу на странице https://clouddocs.f5.com/products/orchestration/ansible/devel/usage/porting-guides.html
fortinet.fortios
- Модуль fortios_facts был удален
- Модуль fortios_registration_forticare был удален
- Модуль fortios_registration_vdom был удален
- Модуль fortios_system_config_backup_restore был удален
- Модуль fortios_system_vmlicense был удален
Устаревшие возможности
Ansible-core
- Начиная с версии 2.14, модули shell и command больше не будут иметь опции предупреждения и предложения модулей вместо команд. Параметр
warnэтих модулей теперь устарел и по умолчанию равенFalse. Аналогично, параметр конфигурацииCOMMAND_WARNINGSтакже устарел и по умолчанию равенFalse. Они будут удалены, и их наличие станет ошибкой в версии 2.14. - apt_key - параметр
keyне оказывает никакого эффекта, устарел и будет удален в версии ansible-core 2.14 (https://github.com/ansible/ansible/pull/70319). - psrp - Установите минимальную версию
pypsrpна0.4.0.
ansible.netcommon
- Модуль cli_parse и плагины анализаторов textfsm, ttp, xml, json устарели, так как они переведены в коллекцию ansible.utils (https://github.com/ansible-collections/ansible.netcommon/pull/182 https://github.com/ansible-collections/ansible.utils/pull/28)
cisco.nxos
- Устарел nxos_bgp_af в пользу модуля ресурса nxos_bgp_address_family.
- Устарел nxos_bgp_neighbor_af в пользу модуля ресурса nxos_bgp_neighbor_address_family.
cloudscale_ch.cloud
- Алиасы
server_uuidsиserver_uuidпараметра servers в модуле volume будут удалены в версии 3.0.0.
community.aws
- ec2_eip - официально устарел алиас
instance_idдляdevice_id(https://github.com/ansible-collections/community.aws/pull/349). - ec2_vpc_endpoint - устарел параметр policy_file и рекомендуется использовать policy с поиском (https://github.com/ansible-collections/community.aws/pull/366).
- ec2_vpc_endpoint_info - параметр
queryустарел и будет удален после 2022-12-01 (https://github.com/ansible-collections/community.aws/pull/346). ec2_vpc_endpoint_info теперь по умолчанию отображает информацию об конечных точках. Возможность поиска информации о доступных службах перенесена в специализированный модульec2_vpc_endpoint_service_info.
community.crypto
- acme module_utils - модуль
acme(ansible_collections.community.crypto.plugins.module_utils.acme) устарел и будет удален в community.crypto 2.0.0. Используйте новые Python-модули в пакетеacmeвместо этого (ansible_collections.community.crypto.plugins.module_utils.acme.xxx) (https://github.com/ansible-collections/community.crypto/pull/184). - acme_account_info - при
retrieve_orders=url_list,ordersбольше не будут возвращаться в community.crypto 2.0.0. Используйтеorder_urisвместо этого (https://github.com/ansible-collections/community.crypto/pull/178).
community.general
- apt_rpm - устарел некорректный алиас параметра
update-cache, будет удален в 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927). - composer - устарели некорректные алиасы параметров
working-dir,global-command,prefer-source,prefer-dist,no-dev,no-scripts,no-plugins,optimize-autoloader,classmap-authoritative,apcu-autoloader,ignore-platform-reqs, будут удалены в 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927). - cpanm - параметр
system_libустарел в пользу использованияbecome(https://github.com/ansible-collections/community.general/pull/2218). - github_deploy_key - устарел некорректный алиас параметра
2fa_token, будет удален в 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927). - grove - опция
messageбудет удалена в community.general 4.0.0. Используйте новую опциюmessage_contentвместо нее (https://github.com/ansible-collections/community.general/pull/1929). - homebrew - устарел некорректный алиас параметра
update-brew, будет удален в 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927). - homebrew_cask - устарел некорректный алиас параметра
update-brew, будет удален в 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927). - opkg - устарел некорректный алиас параметра
update-cache, будет удален в 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927). - pacman - устарел некорректный алиас параметра
update-cache, будет удален в 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927). - puppet - устарел недокументированный параметр
show_diff, будет удален в 7.0.0 (https://github.com/ansible-collections/community.general/pull/1927). - runit - неиспользуемый параметр
distпомечен для устаревания (https://github.com/ansible-collections/community.general/pull/1830). - slackpkg - устарел некорректный алиас параметра
update-cache, будет удален в 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927). - urpmi - устарели некорректные алиасы параметров
update-cacheиno-recommends, будут удалены в 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927). - xbps - устарел некорректный алиас параметра
update-cache, будет удален в 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927). - xfconf - возврат выходных данных в виде фактов устарел, это будет удалено в community.general 4.0.0. Пожалуйста, зарегистрируйте выходные данные задачи в переменной и используйте ее вместо этого. Вы уже можете переключиться на новое поведение, используя новую опцию
disable_facts(https://github.com/ansible-collections/community.general/pull/1747).
community.vmware
- vmware_vmkernel_ip_config - устарел в пользу vmware_vmkernel (https://github.com/ansible-collections/community.vmware/pull/667).
f5networks.f5_modules
- Поддержка версий Python, предшествующих 3.5, устарела.
© 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_4.html