Руководство по переносу на Ansible 6
Ansible 6 основан на Ansible-core 2.13.
Рекомендуем прочитать эту страницу вместе с списком изменений Ansible 6, чтобы понять, какие обновления может потребоваться выполнить.
Плейбук
- Шаблонизация — выполнять арифметические операции и операции конкатенации вне шаблона jinja больше нельзя. Следующее выражение потребуется переписать, чтобы получить
[1, 2]:
- name: Prior to 2.13
debug:
msg: '[1] + {{ [2] }}'
- name: 2.13 and forward
debug:
msg: '{{ [1] + [2] }}'
- Возвращаемое значение метода
__repr__неопределённой переменной, представленной объектомAnsibleUndefined, изменилось. В версии 2.13{{ '%r'|format(undefined_variable) }}возвращаетAnsibleUndefined(hint=None, obj=missing, name='undefined_variable'), а в версиях 2.12 и более ранних возвращалось толькоAnsibleUndefined. - Метод
finalizeбольше не доступен в глобальной области для использования при шаблонизации. Чтобы преобразоватьNoneв пустую строку, можно использовать следующее выражение:{{ value if value is not none }}.
Командная строка
Примечательных изменений нет
Устаревшее
Примечательных изменений нет
Модули
- Для выполнения модулей с помощью ansible-core 2.13 необходимо использовать Python 2 версии 2.7 или Python 3 версии 3.5 или новее. Любой код, использующий
ansible.module_utils.basic, не будет работать с более ранними версиями Python.
Удалённые модули
Следующие модули больше не существуют:
- Примечательных изменений нет
Уведомления об устаревании
Примечательных изменений нет
Важные изменения модулей
Примечательных изменений нет
Несовместимые изменения
-
ansible.module_utils.urls.fetch_urlтеперь будет возвращать перехваченное исключениеHTTPErrorв видеr.HTTPError— это объект, похожий на ответ, который может предоставить авторам модулей дополнительную информацию. Модулям следует использоватьinfo['status'] >= 400для определения наличия сбоя, а не использоватьr is Noneили перехватыватьAttributeErrorпри попытке выполнитьr.read().
Плагины
Примечательных изменений нет
Перенос пользовательских скриптов
Примечательных изменений нет
Работа с сетями
Примечательных изменений нет
Руководство по переносу для v6.7.0
Известные проблемы
community.routeros
- api_modify — если лимиты для записей в
queue treeзаданы в удобочитаемом виде, например25M, конфигурация будет корректно установлена в ROS, но при каждом запуске модуль будет сообщать об изменении элемента, даже если изменений не было. Это связано с тем, что API ROS возвращает число в байтах, например25000000(что не соответствует поведению CLI). Чтобы избежать этого, лимиты необходимо задавать в байтах (в CLI ROS они по-прежнему будут отображаться в удобочитаемом виде) (https://github.com/ansible-collections/community.routeros/pull/131). - api_modify, api_info — пути
routing ospf area,routing ospf area range,routing ospf instance,routing ospf interface-templateреализованы для ROS6 не полностью из-за значительных различий между ROS6 и ROS7 (https://github.com/ansible-collections/community.routeros/pull/131).
Основные изменения
cisco.meraki
- meraki_mr_l7_firewall — новый модуль
- meraki_webhook_payload_template — новый модуль
community.zabbix
- Все модули переходят с zabbix-api на плагин httpapi ansible.netcommon. Для обратной совместимости zabbix-api будет поддерживаться до следующего основного выпуска. Подробнее о переходе см. в README.md.
- Роли zabbix_agent и zabbix_proxy переходят с zabbix-api на плагин httpapi ansible.netcommon. Для обратной совместимости zabbix-api будет поддерживаться до следующего основного выпуска. Подробнее о переходе см. в README.md.
containers.podman
- Добавлен новый плагин become — podman_unshare
- Модуль генерации systemd для Podman
fortinet.fortimanager
- Исправлена проблема совместимости с ansible 2.9.x и ansible-base 2.10.x.
- Добавлена поддержка списков изменений Ansible.
fortinet.fortios
- Добавлена поддержка FortiOS v7.0.6, v7.0.7, v7.0.8, v7.2.1, v7.2.2.
Устаревшие возможности
community.general
- Обратите внимание: некоторые инструменты, например плагин для VScode (https://github.com/ansible/vscode-ansible/issues/573) или
ansible-doc --list --type module, предлагают заменять корректные FQCN модулей и действий в community.general на внутренние имена, состоящие более чем из трёх компонентов. Например, вместоcommunity.general.ufwпредлагается использоватьcommunity.general.system.ufw. Хотя эти более длинные имена работают, коллекция считает их внутренними именами, которые могут измениться или быть удалены в любое время. Они будут удалены в community.general 6.0.0, после чего будут выводиться сообщения об устаревании. Не используйте эти внутренние имена; вместо них указывайте FQCN общего вида из трёх компонентов (community.general.<name_of_module>) (https://github.com/ansible-collections/community.general/pull/5373).
Руководство по переносу для v6.6.0
Добавленные коллекции
- lowlydba.sqlserver (версия 1.0.4)
Известные проблемы
community.routeros
- Модуль
community.routeros.commandзаявляет о поддержке режима проверки. Поскольку он не может определить, изменяют ли выполняемые команды состояние, такое поведение некорректно. Так как это может нарушить работу существующих плейбуков, мы не будем менять его до выхода community.routeros 3.0.0.
Несовместимые изменения
community.general
- newrelic_deployment — для API v2 требуется
revision(https://github.com/ansible-collections/community.general/pull/5341).
Основные изменения
community.general
- newrelic_deployment — удалён API New Relic v1 и добавлена поддержка API v2 (https://github.com/ansible-collections/community.general/pull/5341).
fortinet.fortimanager
- Внесено множество исправлений предупреждений и ошибок тестов Ansible sanity.
- Добавлена поддержка схемы FortiManager 7.2.0, 98 новых модулей
Устаревшие возможности
- Коллекция mellanox.onyx считается неподдерживаемой и будет удалена из Ansible 8, если до выхода Ansible 8 никто не возобновит её поддержку. Подробнее о процедуре удаления и её отмене см. в описании процесса удаления (https://github.com/ansible-community/community-topics/issues/136).
cisco.mso
- Атрибут mso_schema_template_contract_filter contract_filter_type устарел. Теперь его значение определяется по filter_type.
community.general
- Утилиты модуля ArgFormat — устарели вместе с
CmdMixin; вместо них следует использовать утилиту модуляcmd_runner_fmt(https://github.com/ansible-collections/community.general/pull/5370). - Утилиты модуля CmdMixin — устарели; вместо них следует использовать утилиту модуля
CmdRunner(https://github.com/ansible-collections/community.general/pull/5370). - Утилиты модуля CmdModuleHelper — устарели; вместо них следует использовать утилиту модуля
CmdRunner(https://github.com/ansible-collections/community.general/pull/5370). - Утилиты модуля CmdStateModuleHelper — устарели; вместо них следует использовать утилиту модуля
CmdRunner(https://github.com/ansible-collections/community.general/pull/5370). - django_manage — поддержка выпусков Django старше 4.1 объявлена устаревшей и будет удалена в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5400).
- django_manage — поддержка команд
cleanup,syncdbиvalidate, давно объявленных устаревшими в Django, будет удалена в community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/5400). - django_manage — поведение «создавать виртуальное окружение, если оно отсутствует» объявлено устаревшим и будет удалено в community.general версии 9.0.0 (https://github.com/ansible-collections/community.general/pull/5405).
- newrelic_deployment —
appnameиenvironmentбольше не являются допустимыми параметрами API v2. Они будут удалены в community.general 7.0.0 (https://github.com/ansible-collections/community.general/pull/5341).
Руководство по переносу для v6.5.0
Основные изменения
infoblox.nios_modules
Устаревшие возможности
- Коллекция dellemc.os10 считается неподдерживаемой и будет удалена из Ansible 8, если до выхода Ansible 8 никто не возобновит её поддержку. Подробнее о процедуре удаления и её отмене см. в описании процесса удаления (https://github.com/ansible-community/community-topics/issues/134).
- Коллекция dellemc.os6 считается неподдерживаемой и будет удалена из Ansible 8, если до выхода Ansible 8 никто не возобновит её поддержку. Подробнее о процедуре удаления и её отмене см. в описании процесса удаления (https://github.com/ansible-community/community-topics/issues/132).
- Коллекция dellemc.os9 считается неподдерживаемой и будет удалена из Ansible 8, если до выхода Ansible 8 никто не возобновит её поддержку. Подробнее о процедуре удаления и её отмене см. в описании процесса удаления (https://github.com/ansible-community/community-topics/issues/133).
community.general
- lxc_container — модуль больше не будет пытаться поддерживать Python 2 (https://github.com/ansible-collections/community.general/pull/5304).
Руководство по переносу для v6.4.0
Добавленные коллекции
- inspur.ispim (версия 1.0.1)
- vultr.cloud (версия 1.1.0)
Устаревшие возможности
community.general
- proxmox — текущее значение по умолчанию
unprivilegedобъявлено устаревшим; в community.general 7.0.0 оно будет изменено наtrue(https://github.com/pull/5224).
Руководство по переносу для v6.3.0
Основные изменения
community.mysql
- mysql_db — значение аргумента
pipefailпо умолчанию будет изменено наtrueв community.mysql 4.0.0. Если на целевых компьютерах в качестве интерпретатора по умолчанию используется неbash, явно задайте дляpipefailзначениеfalse. Однако мы настоятельно рекомендуем настроитьbashв качестве значения по умолчанию иpipefail=true, чтобы защититься от создания повреждённых дампов, о которых вы не будете знать (https://github.com/ansible-collections/community.mysql/issues/407).
fortinet.fortios
- Добавлена поддержка функции Diff в check_mode.
- Добавлена поддержка Fortios 7.2.0.
Устаревшие возможности
- Коллекция google.cloud считается неподдерживаемой и будет удалена из Ansible 8, если до выхода Ansible 8 никто не возобновит её поддержку. Подробнее о процедуре удаления и её отмене см. в описании процесса удаления (https://github.com/ansible-community/community-topics/issues/105).
- Сопровождающие коллекции servicenow.servicenow объявили её устаревшей (https://github.com/ServiceNowITOM/servicenow-ansible/pull/69), и она будет удалена из Ansible 7. Её по-прежнему можно установить вручную, однако рекомендуется перейти на servicenow.itsm (https://github.com/ansible-community/community-topics/issues/124).
Руководство по переносу для v6.2.0
Добавленные коллекции
- ibm.spectrum_virtualize (версия 1.9.0)
Известные проблемы
netapp.ontap
- na_ontap_snapshot — добавлена документация с рекомендацией использовать формат UTC для
expiry_time.
Основные изменения
community.postgresql
- postgresql_user — аргумент
groupsобъявлен устаревшим и будет удалён вcommunity.postgresql 3.0.0. Для указания членства в группах/ролях используйте модульpostgresql_membership(https://github.com/ansible-collections/community.postgresql/issues/277).
Устаревшие возможности
community.hashi_vault
- Поиск vault_kv2_get — значение по умолчанию
engine_mount_point optionтолько в поискеvault_kv2_getбудет изменено сkvнаsecretв community.hashi_vault версии 4.0.0 (https://github.com/ansible-collections/community.hashi_vault/issues/279).
Руководство по переносу для v6.1.0
Добавленные коллекции
- purestorage.fusion (версия 1.0.2)
Известные проблемы
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_application_alerts_smtp — проблема (212310): модуль не выводит корректное сообщение об ошибке, если длина destination_address превышает 255 символов.
- ome_application_alerts_syslog — проблема (215374): модуль не выводит корректное сообщение об ошибке, если длина destination_address превышает 255 символов.
- ome_device_local_access_configuration — проблема (215035): модуль сообщает
Successfully updated the local access setting, если для параметра timeout_limit указано неподдерживаемое значение. Однако это значение фактически не применяется в OpenManage Enterprise Modular. - ome_device_local_access_configuration — проблема (217865): модуль не выводит корректное сообщение об ошибке, если для параметров user_defined и lcd_language указаны неподдерживаемые значения.
- ome_device_network_services — проблема (212681): модуль не выводит корректное сообщение об ошибке, если для параметров port_number, community_name, max_sessions, max_auth_retries и idle_timeout указаны неподдерживаемые значения.
- ome_device_power_settings — проблема (212679): если значение параметра
power_capвыходит за поддерживаемый диапазон от 0 до 32767, модуль выводит следующее сообщение:Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI. - ome_device_quick_deploy — проблема (216352): модуль не выводит корректное сообщение об ошибке, если для параметров ipv6_prefix_length и vlan_id указаны неподдерживаемые значения.
- ome_smart_fabric_uplink — проблема (186024): модуль не позволяет создавать несколько каналов восходящей связи с одинаковым именем, хотя OpenManage Enterprise Modular это поддерживает. Если создать канал с именем уже существующего, существующий канал будет изменён.
Основные изменения
chocolatey.chocolatey
- win_chocolatey — добавлен параметр bootstrap_script, позволяющий указывать URL скрипта для установки Chocolatey на клиентские компьютеры.
- win_chocolatey_facts — в возвращаемые данные добавлен список устаревших пакетов.
infoblox.nios_modules
Устаревшие возможности
cisco.ios
- Модуль ios_linkagg_module объявлен устаревшим; вместо него используйте ios_lag_interfaces.
community.aws
- aws_codebuild — параметр
tagsсейчас использует нестандартный формат и объявлен устаревшим. В выпуске 6.0.0 этот параметр будет принимать словарь простых пар «ключ/значение» вместо текущего списка словарей. Рекомендуется перейти на параметр resource_tags, который уже принимает словарь простого формата (https://github.com/ansible-collections/community.aws/pull/1221). - route53_info — возвращаемые значения в CamelCase для
HostedZones,ResourceRecordSetsиHealthChecksобъявлены устаревшими. В следующих выпусках вместо них необходимо использовать соответствующие возвращаемые значения в snake_case:hosted_zones,resource_record_setsиhealth_checks».
community.crypto
- Поддержка Ansible 2.9 и ansible-base 2.10 объявлена устаревшей и будет удалена в следующем основном выпуске (community.crypto 3.0.0). Некоторые модули могут и после этого работать с этими версиями, однако мы больше не будем сохранять код совместимости, необходимый для их поддержки (https://github.com/ansible-collections/community.crypto/pull/460).
community.docker
- Поддержка версий API Docker с 1.20 по 1.24 объявлена устаревшей и будет удалена в community.docker 3.0.0. Первой версией Docker с поддержкой API версии 1.25 стала Docker 1.13, выпущенная в январе 2017 года. Это затрагивает модули
docker_container,docker_container_exec,docker_container_info,docker_compose,docker_login,docker_image,docker_image_info,docker_image_load,docker_host_info,docker_network,docker_network_info,docker_node_info,docker_swarm_info,docker_swarm_service,docker_swarm_service_info,docker_volume_infoиdocker_volume, минимально поддерживаемая версия API которых находится в диапазоне от 1.20 до 1.24 (https://github.com/ansible-collections/community.docker/pull/396). - Поддержка Python 2.6 объявлена устаревшей и будет удалена в следующем основном выпуске (community.docker 3.0.0). Некоторые модули могут продолжить работать с Python 2.6, но мы больше не будем обеспечивать совместимость (https://github.com/ansible-collections/community.docker/pull/388).
community.general
- Утилиты модуля cmd_runner —
fmtобъявлен устаревшим; вместо него следует использоватьcmd_runner_fmtв качестве объекта формата параметров (https://github.com/ansible-collections/community.general/pull/4777).
Руководство по переносу на v6.0.0
Добавленные коллекции
- cisco.dnac (версия 6.4.0)
- community.sap (версия 1.0.0)
- community.sap_libs (версия 1.1.0)
- vmware.vmware_rest (версия 2.1.5)
Известные проблемы
Ansible-core
- get_url — корректно задокументировать
check_modeпри ненадёжном статусе changed (https://github.com/ansible/ansible/issues/65687).
ansible.netcommon
- eos — при использовании модулей eos в Ansible 2.9 задачи иногда завершаются с ошибкой, если включён
import_modules. Этого можно избежать, задавimport_modules: no
community.general
- pacman —
update_cacheне может отличить актуальные списки пакетов от устаревших и в обоих случаях сообщаетchanged(https://github.com/ansible-collections/community.general/pull/4318). - pacman — двоичные файлы, указанные в параметре
executable, должны поддерживать--print-format, чтобы этот модуль мог их использовать. В частности, известно, что помощник AURyayв настоящее время этого не поддерживает (https://github.com/ansible-collections/community.general/pull/4312).
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_application_alerts_smtp — проблема (212310). Модуль не выдаёт подходящее сообщение об ошибке, если длина destination_address превышает 255 символов.
- ome_application_alerts_syslog — проблема (215374). Модуль не выдаёт подходящее сообщение об ошибке, если длина destination_address превышает 255 символов.
- ome_application_console_preferences — проблема (224690). Модуль не выводит подходящее сообщение об ошибке, если для параметров report_row_limit, email_sender_settings и metric_collection_settings указано неподдерживаемое значение, и это значение применяется в OpenManage Enterprise.
- ome_device_local_access_configuration — проблема (215035). Модуль сообщает
Successfully updated the local access setting, если для параметра timeout_limit указано неподдерживаемое значение. Однако это значение фактически не применяется в OpenManage Enterprise Modular. - ome_device_local_access_configuration — проблема (217865). Модуль не выводит подходящее сообщение об ошибке, если для параметров user_defined и lcd_language указано неподдерживаемое значение.
- ome_device_network_services — проблема (212681). Модуль не выдаёт подходящее сообщение об ошибке, если для параметров port_number, community_name, max_sessions, max_auth_retries и idle_timeout указаны неподдерживаемые значения.
- ome_device_power_settings — проблема (212679). Модуль выводит следующее сообщение, если значение параметра
power_capвыходит за поддерживаемый диапазон от 0 до 32767:Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI. - ome_device_power_settings — проблема (212679). Модуль завершается с ошибкой и выводит следующее сообщение, если значение параметра
power_capвыходит за поддерживаемый диапазон от 0 до 32767:Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI. - ome_device_power_settings — проблема (212679). Модуль завершается с ошибкой и выводит следующее сообщение, если значение параметра
power_capвыходит за поддерживаемый диапазон от 0 до 32767:Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI. - ome_device_quick_deploy — проблема (216352). Модуль не выводит подходящее сообщение об ошибке, если для параметров ipv6_prefix_length и vlan_id указано неподдерживаемое значение.
- ome_smart_fabric_uplink — проблема (186024). Модуль не позволяет создавать несколько восходящих каналов с одинаковым именем, хотя OpenManage Enterprise Modular поддерживает такую возможность. Если восходящий канал создаётся с именем, совпадающим с именем уже существующего канала, существующий канал изменяется.
purestorage.flasharray
- purefa_admin — после установки
max_loginиlockoutв настоящее время сбросить их значения до нуля можно только через графический интерфейс FlashArray
Несовместимые изменения
Ansible-core
- Зависимости Python модулей — прекращена поддержка Python 2.6 при выполнении модулей.
- Шаблонизация — арифметические операции и конкатенацию больше нельзя выполнять за пределами шаблона Jinja (https://github.com/ansible/ansible/pull/75587)
- Метод
finalizeбольше не доступен в globals для использования при шаблонизации.
amazon.aws
- aws_caller_facts — удалён устаревший псевдоним
aws_caller_facts. Вместо него используйтеaws_caller_info. - cloudformation_facts — удалён устаревший псевдоним
cloudformation_facts. Вместо него используйтеcloudformation_info. - ec2_ami_facts — удалён устаревший псевдоним
ec2_ami_facts. Вместо него используйтеec2_ami_info. - ec2_eni_facts — удалён устаревший псевдоним
ec2_eni_facts. Вместо него используйтеec2_eni_info. - ec2_group_facts — удалён устаревший псевдоним
ec2_group_facts. Вместо него используйтеec2_group_info. - ec2_instance_facts — удалён устаревший псевдоним
ec2_instance_facts. Вместо него используйтеec2_instance_info. - ec2_snapshot_facts — удалён устаревший псевдоним
ec2_snapshot_facts. Вместо него используйтеec2_snapshot_info. - ec2_vol_facts — удалён устаревший псевдоним
ec2_vol_facts. Вместо него используйтеec2_vol_info. - ec2_vpc_dhcp_option_facts — удалён устаревший псевдоним
ec2_vpc_dhcp_option_facts. Вместо него используйтеec2_vpc_dhcp_option_info. - ec2_vpc_endpoint_facts — удалён устаревший псевдоним
ec2_vpc_endpoint_facts. Вместо него используйтеec2_vpc_endpoint_info. - ec2_vpc_igw_facts — удалён устаревший псевдоним
ec2_vpc_igw_facts. Вместо него используйтеec2_vpc_igw_info. - ec2_vpc_nat_gateway_facts — удалён устаревший псевдоним
ec2_vpc_nat_gateway_facts. Вместо него используйтеec2_vpc_nat_gateway_info. - ec2_vpc_net_facts — удалён устаревший псевдоним
ec2_vpc_net_facts. Вместо него используйтеec2_vpc_net_info. - ec2_vpc_route_table_facts — удалён устаревший псевдоним
ec2_vpc_route_table_facts. Вместо него используйтеec2_vpc_route_table_info. - ec2_vpc_subnet_facts — удалён устаревший псевдоним
ec2_vpc_subnet_facts. Вместо него используйтеec2_vpc_subnet_info.
ansible.netcommon
- httpapi — значение параметра
import_modulesпо умолчанию изменено сnoнаyes - netconf — значение параметра
import_modulesпо умолчанию изменено сnoнаyes - network_cli — значение параметра
import_modulesпо умолчанию изменено сnoнаyes
arista.eos
- eos_command — добавлен новый подопциональный параметр
versionдля параметраcommand, который управляет версией ответа JSON. Ранее для network_cli подразумевалось значение «latest», а для httpapi — «1», но теперь для обоих типов подключения значением по умолчанию будет «latest». Этот параметр также доступен в модулях, которые самостоятельно отправляют запросы к устройству с помощьюplugins.module_utils.network.eos.eos.run_commands(); для них действует то же новое значение по умолчанию (https://github.com/ansible-collections/arista.eos/pull/258). - httpapi — параметр
eos_use_sessionsтеперь имеет логический тип вместо целочисленного.
community.aws
- aws_acm_facts — удалён устаревший псевдоним
aws_acm_facts. Вместо него используйтеaws_acm_info. - aws_kms_facts — удалён устаревший псевдоним
aws_kms_facts. Вместо него используйтеaws_kms_info. - aws_kms_info — устаревшее поле
keys_attrтеперь игнорируется (https://github.com/ansible-collections/community.aws/pull/838). - aws_region_facts — удалён устаревший псевдоним
aws_region_facts. Вместо него используйтеaws_region_info. - aws_s3_bucket_facts — удалён устаревший псевдоним
aws_s3_bucket_facts. Вместо него используйтеaws_s3_bucket_info. - aws_sgw_facts — удалён устаревший псевдоним
aws_sgw_facts. Вместо него используйтеaws_sgw_info. - aws_waf_facts — удалён устаревший псевдоним
aws_waf_facts. Вместо него используйтеaws_waf_info. - cloudfront_facts — удалён устаревший псевдоним
cloudfront_facts. Вместо него используйтеcloudfront_info. - cloudwatchlogs_log_group_facts — удалён устаревший псевдоним
cloudwatchlogs_log_group_facts. Вместо него используйтеcloudwatchlogs_log_group_info. - dynamodb_table — ранее игнорируемые устаревшие обновления первичных ключей и индексов global_all теперь приводят к ошибке (https://github.com/ansible-collections/community.aws/pull/837).
- ec2_asg_facts — удалён устаревший псевдоним
ec2_asg_facts. Вместо него используйтеec2_asg_info. - ec2_customer_gateway_facts — удалён устаревший псевдоним
ec2_customer_gateway_facts. Вместо него используйтеec2_customer_gateway_info. - ec2_eip_facts — удалён устаревший псевдоним
ec2_eip_facts. Вместо него используйтеec2_eip_info. - ec2_elb_facts — удалён устаревший псевдоним
ec2_elb_facts. Вместо него используйтеec2_elb_info. - ec2_elb_info — модуль
ec2_elb_infoудалён. Используйте модульthe ``elb_classic_lb_info. - ec2_lc_facts — удалён устаревший псевдоним
ec2_lc_facts. Вместо него используйтеec2_lc_info. - ec2_placement_group_facts — удалён устаревший псевдоним
ec2_placement_group_facts. Вместо него используйтеec2_placement_group_info. - ec2_vpc_nacl_facts — удалён устаревший псевдоним
ec2_vpc_nacl_facts. Вместо него используйтеec2_vpc_nacl_info. - ec2_vpc_peering_facts — удалён устаревший псевдоним
ec2_vpc_peering_facts. Вместо него используйтеec2_vpc_peering_info. - ec2_vpc_route_table_facts — удалён устаревший псевдоним
ec2_vpc_route_table_facts. Вместо него используйтеec2_vpc_route_table_info. - ec2_vpc_vgw_facts — удалён устаревший псевдоним
ec2_vpc_vgw_facts. Вместо него используйтеec2_vpc_vgw_info. - ec2_vpc_vpn_facts — удалён устаревший псевдоним
ec2_vpc_vpn_facts. Вместо него используйтеec2_vpc_vpn_info. - ecs_service_facts — удалён устаревший псевдоним
ecs_service_facts. Вместо него используйтеecs_service_info. - ecs_taskdefinition_facts — удалён устаревший псевдоним
ecs_taskdefinition_facts. Вместо него используйтеecs_taskdefinition_info. - efs_facts — удалён устаревший псевдоним
efs_facts. Вместо него используйтеefs_info. - elasticache_facts — удалён устаревший псевдоним
elasticache_facts. Вместо него используйтеelasticache_info. - elb_application_lb_facts — удалён устаревший псевдоним
elb_application_lb_facts. Вместо него используйтеelb_application_lb_info. - elb_classic_lb_facts — удалён устаревший псевдоним
elb_classic_lb_facts. Вместо него используйтеelb_classic_lb_info. - elb_target_facts — удалён устаревший псевдоним
elb_target_facts. Вместо него используйтеelb_target_info. - elb_target_group_facts — удалён устаревший псевдоним
elb_target_group_facts. Вместо него используйтеelb_target_group_info. - iam — удалён устаревший модуль
community.aws.iam. Используйтеcommunity.aws.iam_user,community.aws.iam_access_keyилиcommunity.aws.iam_group(https://github.com/ansible-collections/community.aws/pull/839). - iam_cert_facts — удалён устаревший псевдоним
iam_cert_facts. Вместо него используйтеiam_cert_info. - iam_mfa_device_facts — удалён устаревший псевдоним
iam_mfa_device_facts. Вместо него используйтеiam_mfa_device_info. - iam_role_facts — удалён устаревший псевдоним
iam_role_facts. Вместо него используйтеiam_role_info. - iam_server_certificate_facts — удалён устаревший псевдоним
iam_server_certificate_facts. Вместо него используйтеiam_server_certificate_info. - lambda_facts — удалён устаревший модуль lambda_facts``. Вместо него используйте
lambda_info. - rds — удалён устаревший модуль
community.aws.rds. Используйтеcommunity.aws.rds_instance(https://github.com/ansible-collections/community.aws/pull/839). - rds_instance_facts — удалён устаревший псевдоним
rds_instance_facts. Вместо него используйтеrds_instance_info. - rds_snapshot_facts — удалён устаревший псевдоним
rds_snapshot_facts. Вместо него используйтеrds_snapshot_info. - redshift_facts — удалён устаревший псевдоним
redshift_facts. Вместо него используйтеredshift_info. - route53_facts — удалён устаревший псевдоним
route53_facts. Вместо него используйтеroute53_info.
community.general
- Некоторые компоненты этой коллекции не работают с ansible-core 2.11 в Python 3.12 и новее. Обновитесь до ansible-core 2.12 или новее либо используйте Python 3.11 или более раннюю версию (https://github.com/ansible-collections/community.general/pull/3988).
- Символические ссылки, используемые для реализации flatmapping во всех модулях, удалены и заменены перенаправлениями
meta/runtime.yml. Это нарушает совместимость всех модулей с Ansible 2.9 (если не использовать их «длинные» имена, что не рекомендуется; они могут измениться без предварительного уведомления, поскольку считаются деталью реализации) (https://github.com/ansible-collections/community.general/pull/4548). - Плагин тестирования a_module — удалён код совместимости с Ansible 2.9 (https://github.com/ansible-collections/community.general/pull/4548).
- archive — удалён код совместимости с Ansible 2.9 (https://github.com/ansible-collections/community.general/pull/4548).
- git_config — удалён код совместимости с Ansible 2.9 и ранними версиями ansible-base 2.10 (https://github.com/ansible-collections/community.general/pull/4548).
- java_keystore — удалён код совместимости с Ansible 2.9 (https://github.com/ansible-collections/community.general/pull/4548).
- Плагины фильтров lists_mergeby и groupby_as_dict — изменено имя файла плагина фильтра. Это изменение не заметно конечным пользователям и затрагивает только другие коллекции, которые импортируют пути Python (https://github.com/ansible-collections/community.general/pull/4625).
- Плагин фильтра lists_mergeby — удалён код совместимости с Ansible 2.9 (https://github.com/ansible-collections/community.general/pull/4548).
- maven_artifact — удалён код совместимости с Ansible 2.9 (https://github.com/ansible-collections/community.general/pull/4548).
- Плагин кэша memcached — удалён код совместимости с Ansible 2.9 (https://github.com/ansible-collections/community.general/pull/4548).
- Заглушка плагина фильтра path_join — удалён код совместимости с Ansible 2.9 (https://github.com/ansible-collections/community.general/pull/4548).
- Плагин кэша redis — удалён код совместимости с Ansible 2.9 (https://github.com/ansible-collections/community.general/pull/4548).
- yarn — удалён неподдерживаемый и ненужный флаг
--no-emoji(https://github.com/ansible-collections/community.general/pull/4662).
community.mysql
- mysql_replication — удалены возвращаемые значения
Is_SlaveиIs_Master(заменены наIs_PrimaryиIs_Replica(https://github.com/ansible-collections /community.mysql/issues/145). - mysql_replication — удалены значения параметров mode, содержащие
master/slave, а также значениеslave_posпараметра master_use_gtid (заменены соответствующими значениямиprimary/replica) (https://github.com/ansible-collections/community.mysql/issues/145). - mysql_user — прекращена поддержка специальной привилегии
REQUIRESSL, поскольку её заменила опцияtls_requires(https://github.com/ansible-collections/community.mysql/discussions/121). - mysql_user — проверка привилегий теперь выполняется непосредственно с помощью движка базы данных (https://github.com/ansible-collections/community.mysql/issues/234 https://github.com/ansible-collections/community.mysql/pull/243). Больше не проверяйте привилегии в этом модуле.
community.vmware
- Теперь для коллекции требуется как минимум ansible-core 2.11.0. Ansible 3 и более ранние версии, а также версии ansible-base больше не поддерживаются.
- vmware_cluster_drs — значение
enableпо умолчанию изменено сfalseнаtrue. - vmware_cluster_drs — псевдоним параметра
enable_drsудалён; вместо него используйтеenable. - vmware_cluster_ha — значение
enableпо умолчанию изменено сfalseнаtrue. - vmware_cluster_ha — псевдоним параметра
enable_haудалён; вместо него используйтеenable. - vmware_cluster_vsan — значение
enableпо умолчанию изменено сfalseнаtrue. - vmware_cluster_vsan — псевдоним параметра
enable_vsanудалён; вместо него используйтеenable. - vmware_guest — для безопасности на основе виртуализации предусмотрены требования (
nested_virt,secure_bootиiommu), которые модуль включал без уведомления. Теперь их необходимо включать явно.
dellemc.openmanage
- Проверка SSL-сертификата HTTPS — это несовместимое изменение, для применения которого потребуется изменить существующие плейбуки. Инструкции по изменению существующих плейбуков см. в разделе Проверка SSL-сертификата файла README.md.
theforeman.foreman
- Для плагина инвентаризации значение use_reports_api по умолчанию установлено в true
- Поддержка Ansible 2.8 удалена
Основные изменения
- Добавлен инструмент CLI
ansible-community, позволяющий выводить версию дистрибутива Ansible Community. Чтобы вывести эту версию, используйтеansible-community --version.
Ansible-core
- Требования к Jinja2 на управляющем узле — для управляющего узла (машины, на которой выполняется Ansible) требуется Jinja2 версии 3.0.0 или новее (https://github.com/ansible/ansible/pull/75881)
- Шаблоны — удалён
safe_evalв пользу использованияNativeEnvironment, при этомliteral_evalиспользуется только в случаях, когда использовалсяsafe_eval(https://github.com/ansible/ansible/pull/75587)
amazon.aws
- Коллекция amazon.aws — в коллекции amazon.aws прекращена поддержка
botocore<1.19.0иboto3<1.16.0. Большинство модулей продолжат работать с более старыми версиями AWS SDK, однако совместимость со старыми версиями SDK не гарантируется и не будет проверяться. При использовании старых версий SDK Ansible выдаст предупреждение (https://github.com/ansible-collections/amazon.aws/pull/574).
ansible.netcommon
- cli_parse — этот модуль перенесён в коллекцию ansible.utils.
ansible.netcommon.cli_parseпродолжит работать для обращения к модулю по новому пути, но это перенаправление будет удалено в одном из будущих выпусков. - network_cli — изменено значение параметра
ssh_typeпо умолчанию: вместоparamikoиспользуетсяauto. При установленном модуле ansible-pylibssh будет использоваться libssh, в противном случае — paramiko.
arista.eos
- Минимальная требуемая версия ansible.netcommon — 2.5.1.
- Обновлены ссылки на базовые плагины ansible.netcommon.
-
eos_facts— значение gather_subset по умолчанию изменено с!configнаmin(https://github.com/ansible-collections/arista.eos/issues/306).
chocolatey.chocolatey
- win_chocolatey — добавлен параметр choco_args для передачи дополнительных аргументов непосредственно в Chocolatey.
cisco.asa
- Минимальная требуемая версия ansible.netcommon — 2.5.1.
- Обновлены ссылки на базовые плагины ansible.netcommon.
cisco.ios
- Минимальная требуемая версия ansible.netcommon — 2.5.1.
- Обновлены ссылки на базовые плагины ansible.netcommon.
- facts — значение gather_subset по умолчанию изменено: теперь используется min вместо !config.
cisco.iosxr
- Минимальная требуемая версия ansible.netcommon — 2.5.1.
- Обновлены ссылки на базовые плагины ansible.netcommon.
-
facts— значениеgather_subsetпо умолчанию изменено: теперь используется min вместо !config.
cisco.ise
- Требование ciscoisesdk обновлено до версии 1.2.0.
- anc_endpoint_bulk_monitor_status_info — изменено возвращаемое значение: возвращается содержимое BulkStatus.
- anc_policy_bulk_monitor_status_info — изменено возвращаемое значение: возвращается содержимое BulkStatus.
- backup_last_status_info — изменено возвращаемое значение: возвращается содержимое ответа.
- device_administration_authentication_rules — удалён параметр identitySourceId.
- device_administration_authentication_rules_info — изменено возвращаемое значение: возвращается содержимое ответа.
- device_administration_authorization_rules_info — изменено возвращаемое значение: возвращается содержимое ответа.
- device_administration_conditions — удалён параметр attributeId.
- device_administration_conditions_for_authentication_rule_info — изменено возвращаемое значение: возвращается содержимое ответа.
- device_administration_conditions_for_authorization_rule_info — изменено возвращаемое значение: возвращается содержимое ответа.
- device_administration_conditions_for_policy_set_info — изменено возвращаемое значение: возвращается содержимое ответа.
- device_administration_conditions_info — изменено возвращаемое значение: возвращается содержимое ответа.
- device_administration_dictionary_attributes_authentication_info — изменено возвращаемое значение: возвращается содержимое ответа.
- device_administration_dictionary_attributes_authorization_info — изменено возвращаемое значение: возвращается содержимое ответа.
- device_administration_dictionary_attributes_policy_set_info — изменено возвращаемое значение: возвращается содержимое ответа.
- device_administration_global_exception_rules_info — изменено возвращаемое значение: возвращается содержимое ответа.
- device_administration_network_conditions_info — изменено возвращаемое значение: возвращается содержимое ответа.
- device_administration_time_date_conditions — удалён параметр attributeId.
- device_administration_time_date_conditions_info — изменено возвращаемое значение: возвращается содержимое ответа.
- egress_matrix_cell_bulk_monitor_status_info — изменено возвращаемое значение: возвращается содержимое BulkStatus.
- network_access_authentication_rules — удалён параметр identitySourceId.
- network_access_conditions — удалён параметр attributeId.
- network_access_time_date_conditions — удалён параметр attributeId.
- node_deployment — обновлены параметры.
- node_deployment_info — добавлены параметры filter и filterType.
- node_group — исправлено повторное получение ответа.
- node_group_info — исправлено повторное получение ответа.
- repository_files_info — изменено возвращаемое значение: возвращается содержимое ответа.
- repository_info — изменено возвращаемое значение: возвращается содержимое ответа.
- sg_acl_bulk_monitor_status_info — изменено возвращаемое значение: возвращается содержимое BulkStatus.
- sg_mapping_bulk_monitor_status_info — изменено возвращаемое значение: возвращается содержимое BulkStatus.
- sg_mapping_group_bulk_monitor_status_info — изменено возвращаемое значение: возвращается содержимое BulkStatus.
- sg_mapping_group_info — изменено возвращаемое значение: возвращается содержимое BulkStatus.
- sg_to_vn_to_vlan_bulk_monitor_status_info — изменено возвращаемое значение: возвращается содержимое BulkStatus.
- sgt — тип generationId изменён с int на str.
- sgt_bulk_monitor_status_info — изменено возвращаемое значение: возвращается содержимое BulkStatus.
- sxp_connections_bulk_monitor_status_info — изменено возвращаемое значение: возвращается содержимое BulkStatus.
- sxp_local_bindings_bulk_monitor_status_info — изменено возвращаемое значение: возвращается содержимое BulkStatus.
- sxp_vpns_bulk_monitor_status_info — изменено возвращаемое значение: возвращается содержимое BulkStatus.
- system_certificate — добавлены параметры portalTagTransferForSameSubject и roleTransferForSameSubject.
- system_certificate — параметр portalTagTransferForSameSubject переименован в allowPortalTagTransferForSameSubject.
- system_certificate — параметр roleTransferForSameSubject переименован в allowRoleTransferForSameSubject.
- system_certificate_import — добавлены параметры portalTagTransferForSameSubject и roleTransferForSameSubject.
- system_certificate_import — параметр portalTagTransferForSameSubject переименован в allowPortalTagTransferForSameSubject.
- system_certificate_import — параметр roleTransferForSameSubject переименован в allowRoleTransferForSameSubject.
- trustsec_nbar_app_info — тип изменён со str на list.
- trustsec_vn_info — тип изменён со str на list.
cisco.meraki
- meraki_mr_radio — новый модуль.
cisco.nxos
- Минимальная требуемая версия ansible.netcommon повышена до v2.6.1.
- Обновлены ссылки на базовые плагины ansible.netcommon.
-
nxos_facts— значение gather_subset по умолчанию изменено с!configнаmin(https://github.com/ansible-collections/cisco.nxos/issues/418). - nxos_file_copy переписан как модуль. Это изменение также устраняет зависимость от pexpect для операции file_pull. Поскольку теперь для проверки argspec используется класс AnsibleModule, сообщения проверки будут немного отличаться. В некоторых случаях ожидаются изменения в возвращаемых данных. Функциональность осталась без изменений.
community.aws
- Коллекция community.aws — в коллекции community.aws прекращена поддержка
botocore<1.19.0иboto3<1.16.0. Большинство модулей продолжат работать с более старыми версиями AWS SDK, однако совместимость со старыми версиями SDK не гарантируется и не будет проверяться. При использовании старых версий SDK Ansible выдаст предупреждение (https://github.com/ansible-collections/community.aws/pull/809). - s3_bucket_notifications — модуль переработан для поддержки целей SNS / SQS наряду с уже поддерживаемыми функциями Lambda (https://github.com/ansible-collections/community.aws/issues/140).
community.general
- Коллекция community.general больше не поддерживает Ansible 2.9 и ansible-base 2.10. Мы не предпринимаем активных мер, чтобы запретить их использование, однако удалим значительную часть кода и других средств обеспечения совместимости, что фактически сделает невозможным использование большей части содержимого этой коллекции с Ansible 2.9 и части содержимого — с ansible-base 2.10. Поддержка Ansible 2.9 и ansible-base 2.10 очень скоро завершится. Если вы всё ещё используете эти версии, как можно скорее рассмотрите возможность перехода на ansible-core 2.11 или новее (https://github.com/ansible-collections/community.general/pull/4548).
community.mysql
- Коллекция community.mysql больше не поддерживает
Ansible 2.9иansible-base 2.10. Мы не предпринимаем активных мер, чтобы запретить их использование, и не планируем добавлять в модули несовместимый код, однако прекратим тестирование сAnsible 2.9иansible-base 2.10. Поддержка обеих версий очень скоро завершится. Если вы всё ещё используете их, как можно скорее рассмотрите возможность перехода наlatest Ansible / ansible-core 2.11 or later(https://github.com/ansible-collections/community.mysql/pull/343).
community.network
- Коллекция community.network больше не поддерживает Ansible 2.9 и ansible-base 2.10. Мы не предпринимаем активных мер, чтобы запретить их использование, однако удалим код и другие средства обеспечения совместимости, что фактически сделает невозможным использование большей части содержимого этой коллекции с Ansible 2.9 и части содержимого — с ansible-base 2.10. Поддержка Ansible 2.9 и ansible-base 2.10 очень скоро завершится. Если вы всё ещё используете эти версии, как можно скорее рассмотрите возможность перехода на ansible-core 2.11 или новее (https://github.com/ansible-collections/community.network/pull/426).
community.postgresql
- Коллекция community.postgresql больше не поддерживает
Ansible 2.9иansible-base 2.10. Мы не предпринимаем активных мер, чтобы запретить их использование, и не планируем добавлять в модули несовместимый код, однако прекратим тестирование сAnsible 2.9иansible-base 2.10. Поддержка обеих версий очень скоро завершится. Если вы всё ещё используете их, как можно скорее рассмотрите возможность перехода наlatest Ansible / ansible-core 2.11 or later(https://github.com/ansible-collections/community.postgresql/pull/245). - postgresql_privs — использование функции
usage_on_typesобъявлено устаревшим; она будет удалена вcommunity.postgresql 3.0.0. Чтобы явно предоставлять или отзывать привилегии для типов, используйте параметрtypeсо значениемtype(https://github.com/ansible-collections/community.postgresql/issues/207). - postgresql_query — параметры
path_to_scriptиas_single_query, а также возвращаемые значенияquery_listиquery_all_resultsобъявлены устаревшими и будут удалены вcommunity.postgresql 3.0.0. Для выполнения операторов из скриптов используйте модульcommunity.postgresql.postgresql_script(https://github.com/ansible-collections/community.postgresql/issues/189). - postgresql_query — значение параметра
as_single_queryпо умолчанию изменится наyes. Если это изменит поведение связанных задач, в которых используется модуль, соответствующим образом скорректируйте значение параметра (https://github.com/ansible-collections/community.postgresql/issues/85). - postgresql_user — аргумент
privобъявлен устаревшим и будет удалён вcommunity.postgresql 3.0.0. Вместо него используйте модульpostgresql_privsдля предоставления или отзыва привилегий (https://github.com/ansible-collections/community.postgresql/issues/212).
community.vmware
- VCSIM исключён из списка тестовых целей (https://github.com/ansible-collections/community.vmware/pull/1294).
containers.podman
- Добавлен модуль podman_tag.
- Добавлена поддержка драйвера secrets и его параметров.
dellemc.openmanage
- Все модули могут считывать пользовательский или подписанный центром сертификации организации сертификат из переменных среды. Инструкции по изменению существующих сценариев или настройке переменной среды см. в разделе Проверка SSL-сертификата файла README.md.
- Теперь все модули поддерживают SSL через HTTPS и тайм-аут на уровне сокета.
- idrac_server_config_profile — модуль расширен поддержкой экспорта, импорта и предварительного просмотра конфигурации SCP с помощью Redfish; также добавлена поддержка режима проверки.
f5networks.f5_modules
- bigip_device_info — добавлена логика постраничной обработки для повышения стабильности API.
- bigip_device_info — модуль больше не собирает информацию из всех разделов устройства. Это изменение повысит стабильность модуля: ресурсы будут собираться только из указанного раздела, что предотвратит сбор чрезмерного объёма информации и возможный сбой.
fortinet.fortios
- Добавлена поддержка FortiOS 7.0.2, 7.0.3, 7.0.4 и 7.0.5.
frr.frr
- Минимальная требуемая версия ansible.netcommon — 2.5.1.
- Обновлены ссылки на базовые плагины ansible.netcommon.
ibm.qradar
- Минимальная требуемая версия ansible.netcommon — 2.5.1.
- Обновлены ссылки на базовые плагины ansible.netcommon.
junipernetworks.junos
- Минимальная требуемая версия ansible.netcommon — 2.5.1.
- Обновлены ссылки на базовые плагины ansible.netcommon.
-
junos_facts— значение gather_subset по умолчанию изменено с!configнаmin.
ovirt.ovirt
- manageiq — роль удалена (https://github.com/oVirt/ovirt-ansible-collection/pull/375).
splunk.es
- Минимальная требуемая версия ansible.netcommon — 2.5.1.
- Обновлены ссылки на базовые плагины ansible.netcommon.
vyos.vyos
- Добавлено значение ‘pool’ для ключа server в ntp_global.
- Минимальная требуемая версия ansible.netcommon — 2.5.1.
- Обновлены ссылки на базовые плагины ansible.netcommon.
-
vyos_facts— значение gather_subset по умолчанию изменено с!configнаmin(https://github.com/ansible-collections/vyos.vyos/issues/231).
Удалённые коллекции
- community.kubernetes (ранее включённая версия: 2.0.1)
- community.kubevirt (ранее включённая версия: 1.0.0)
Удалённые функции
- Коллекция community.kubernetes удалена из Ansible 6. Она объявлена устаревшей начиная с Ansible 4.2, а версия 2.0.0, включённая начиная с Ansible 5, содержит только устаревшие перенаправления с community.kubernetes на kubernetes.core. Если вам всё ещё нужны эти перенаправления, можно вручную установить community.kubernetes с помощью
ansible-galaxy collection install community.kubernetes(https://github.com/ansible-community/community-topics/issues/93). - Коллекция community.kubevirt удалена из Ansible 6. Она не работала с коллекцией community.kubernetes, включённой начиная с Ansible 5.0.0, и, к сожалению, никому не удалось адаптировать эту коллекцию для работы с kubernetes.core >= 2.0.0. Если вам нужна эта коллекция, необходимо вручную установить community.kubernetes < 2.0.0 вместе с community.kubevirt с помощью
ansible-galaxy collection install community.kubevirt 'community.kubernetes:<2.0.0'(https://github.com/ansible-community/community-topics/issues/92).
Ansible-core
- Удалён устаревший метод
Templar.set_available_variables()(https://github.com/ansible/ansible/issues/75828) - cli — удалена устаревшая возможность задавать уровень подробности до подкоманды (https://github.com/ansible/ansible/issues/75823)
- copy — удалён устаревший псевдоним
thirsty(https://github.com/ansible/ansible/issues/75824) - psrp — удалён резервный вариант с
put_fileдля более старых версийpypsrp. Пользователям необходимо иметь как минимумpypsrp>=0.4.0. - url_argument_spec — удалён устаревший псевдоним
thirstyдля модулейget_urlиuri(https://github.com/ansible/ansible/issues/75825, https://github.com/ansible/ansible/issues/75826)
community.general
- ali_instance_info — удалены параметры
availability_zone,instance_idsиinstance_names. Используйте элемент фильтраzone_idвместоavailability_zone, элемент фильтраinstance_idsвместоinstance_idsи элемент фильтраinstance_nameвместоinstance_names(https://github.com/ansible-collections/community.general/pull/4516). - apt_rpm — удалён устаревший псевдоним
update-cacheпараметраupdate_cache(https://github.com/ansible-collections/community.general/pull/4516). - compose — удалены различные устаревшие псевдонимы. Вместо этого используйте вариант с
_, а не-(https://github.com/ansible-collections/community.general/pull/4516). - dnsimple — удалена поддержка dnsimple < 2.0.0 (https://github.com/ansible-collections/community.general/pull/4516).
- github_deploy_key — удалён устаревший псевдоним
2fa_tokenпараметраotp(https://github.com/ansible-collections/community.general/pull/4516). - homebrew, homebrew_cask — удалён устаревший псевдоним
update-brewпараметраupdate_brew(https://github.com/ansible-collections/community.general/pull/4516). - linode — удалён параметр
backupsenabled. Для включения резервного копирования используйтеbackupweeklydayилиbackupwindow(https://github.com/ansible-collections/community.general/pull/4516). - opkg — удалён устаревший псевдоним
update-cacheпараметраupdate_cache(https://github.com/ansible-collections/community.general/pull/4516). - pacman — если
update_cache=trueиспользуется сnameилиupgrade, состояние changed теперь также будет указывать, если обновлён только кэш. Чтобы сохранить прежнее поведение — указыватьchangedтолько при установке или обновлении пакета, — используйтеchanged_when, как показано в примерах модуля (https://github.com/ansible-collections/community.general/pull/4516). - pacman — удалён устаревший псевдоним
update-cacheпараметраupdate_cache(https://github.com/ansible-collections/community.general/pull/4516). - proxmox, proxmox_kvm, proxmox_snap — теперь нельзя указывать имя виртуальной машины, соответствующее нескольким ВМ. В этом случае модули завершаются с ошибкой (https://github.com/ansible-collections/community.general/pull/4516).
- serverless — удалён параметр
functions. Модуль его не использовал (https://github.com/ansible-collections/community.general/pull/4516). - slackpkg — удалён устаревший псевдоним
update-cacheпараметраupdate_cache(https://github.com/ansible-collections/community.general/pull/4516). - urpmi — удалён устаревший псевдоним
no-recommendsпараметраno_recommends(https://github.com/ansible-collections/community.general/pull/4516). - urpmi — удалён устаревший псевдоним
update-cacheпараметраupdate_cache(https://github.com/ansible-collections/community.general/pull/4516). - xbps — удалён устаревший псевдоним
update-cacheпараметраupdate_cache(https://github.com/ansible-collections/community.general/pull/4516). - xfconf — состояние
getудалено. Вместо него используйте модульxfconf_info(https://github.com/ansible-collections/community.general/pull/4516).
community.hashi_vault
- Аутентификация aws_iam — удалён устаревший псевдоним
aws_iam_loginдля значенияaws_iamпараметраauth_method(https://github.com/ansible-collections/community.hashi_vault/issues/194). - Коллекция community.hashi_vault — удалена поддержка Ansible 2.9 и ansible-base 2.10 (https://github.com/ansible-collections/community.hashi_vault/issues/189).
- Поиск hashi_vault — удалён устаревший раздел конфигурации INI
[lookup_hashi_vault]; вместо него используется общий для коллекции раздел[hashi_vault_collection](https://github.com/ansible-collections/community.hashi_vault/issues/179). - Удалена настройка интеграционных тестов «legacy»; это не затрагивает конечных пользователей и относится только к участникам разработки (https://github.com/ansible-collections/community.hashi_vault/pull/191).
community.network
- Модули aireos — удалена устаревшая поддержка
connection: local. Вместо неё используйтеconnection: network_cli(https://github.com/ansible-collections/community.network/pull/440). - Модули aireos — удалён устаревший параметр
provider. Вместо него используйтеconnection: network_cli(https://github.com/ansible-collections/community.network/pull/440). - Модули aruba — удалена устаревшая поддержка
connection: local. Вместо неё используйтеconnection: network_cli(https://github.com/ansible-collections/community.network/pull/440). - Модули aruba — удалён устаревший параметр
provider. Вместо него используйтеconnection: network_cli(https://github.com/ansible-collections/community.network/pull/440). - Модули ce — удалена устаревшая поддержка
connection: local. Вместо неё используйтеconnection: network_cli(https://github.com/ansible-collections/community.network/pull/440). - Модули ce — удалён устаревший параметр
provider. Вместо него используйтеconnection: network_cli(https://github.com/ansible-collections/community.network/pull/440). - Модули enos — удалена устаревшая поддержка
connection: local. Вместо неё используйтеconnection: network_cli(https://github.com/ansible-collections/community.network/pull/440). - Модули enos — удалён устаревший параметр
provider. Вместо него используйтеconnection: network_cli(https://github.com/ansible-collections/community.network/pull/440). - Модули ironware — удалена устаревшая поддержка
connection: local. Вместо неё используйтеconnection: network_cli(https://github.com/ansible-collections/community.network/pull/440). - Модули ironware — удалён устаревший параметр
provider. Вместо него используйтеconnection: network_cli(https://github.com/ansible-collections/community.network/pull/440). - Модули sros — удалена устаревшая поддержка
connection: local. Вместо неё используйтеconnection: network_cli(https://github.com/ansible-collections/community.network/pull/440). - Модули sros — удалён устаревший параметр
provider. Вместо него используйтеconnection: network_cli(https://github.com/ansible-collections/community.network/pull/440).
community.vmware
- vcenter_extension_facts — устаревший модуль
vcenter_extension_factsудалён; вместо него используйтеvcenter_extension_info. - vmware_about_facts — устаревший модуль
vmware_about_factsудалён; вместо него используйтеvmware_about_info. - vmware_category_facts — устаревший модуль
vmware_category_factsудалён; вместо него используйтеvmware_category_info. - vmware_cluster — конфигурация DRS удалена; вместо неё используйте модуль
vmware_cluster_drs. - vmware_cluster — конфигурация HA удалена; вместо неё используйте модуль
vmware_cluster_ha. - vmware_cluster — конфигурация VSAN удалена; вместо неё используйте модуль
vmware_cluster_vsan. - vmware_cluster_facts — устаревший модуль
vmware_cluster_factsудалён; вместо него используйтеvmware_cluster_info. - vmware_datastore_facts — устаревший модуль
vmware_datastore_factsудалён; вместо него используйтеvmware_datastore_info. - vmware_drs_group_facts — устаревший модуль
vmware_drs_group_factsудалён; вместо него используйтеvmware_drs_group_info. - vmware_drs_rule_facts — устаревший модуль
vmware_drs_rule_factsудалён; вместо него используйтеvmware_drs_rule_info. - vmware_dvs_portgroup — устаревший параметр
portgroup_typeудалён; вместо него используйтеport_binding. - vmware_dvs_portgroup_facts — устаревший модуль
vmware_dvs_portgroup_factsудалён; вместо него используйтеvmware_dvs_portgroup_info. - vmware_guest_boot_facts — устаревший модуль
vmware_guest_boot_factsудалён; вместо него используйтеvmware_guest_boot_info. - vmware_guest_customization_facts — устаревший модуль
vmware_guest_customization_factsудалён; вместо него используйтеvmware_guest_customization_info. - vmware_guest_disk_facts — устаревший модуль
vmware_guest_disk_factsудалён; вместо него используйтеvmware_guest_disk_info. - vmware_guest_facts — устаревший модуль
vmware_guest_factsудалён; вместо него используйтеvmware_guest_info. - vmware_guest_snapshot_facts — устаревший модуль
vmware_guest_snapshot_factsудалён; вместо него используйтеvmware_guest_snapshot_info. - vmware_host_capability_facts — устаревший модуль
vmware_host_capability_factsудалён; вместо него используйтеvmware_host_capability_info. - vmware_host_config_facts — устаревший модуль
vmware_host_config_factsудалён; вместо него используйтеvmware_host_config_info. - vmware_host_dns_facts — устаревший модуль
vmware_host_dns_factsудалён; вместо него используйтеvmware_host_dns_info. - vmware_host_feature_facts — устаревший модуль
vmware_host_feature_factsудалён; вместо него используйтеvmware_host_feature_info. - vmware_host_firewall_facts — устаревший модуль
vmware_host_firewall_factsудалён; вместо него используйтеvmware_host_firewall_info. - vmware_host_ntp_facts — устаревший модуль
vmware_host_ntp_factsудалён; вместо него используйтеvmware_host_ntp_info. - vmware_host_package_facts — устаревший модуль
vmware_host_package_factsудалён; вместо него используйтеvmware_host_package_info. - vmware_host_service_facts — устаревший модуль
vmware_host_service_factsудалён; вместо него используйтеvmware_host_service_info. - vmware_host_ssl_facts — устаревший модуль
vmware_host_ssl_factsудалён; вместо него используйтеvmware_host_ssl_info. - vmware_host_vmhba_facts — устаревший модуль
vmware_host_vmhba_factsудалён; вместо него используйтеvmware_host_vmhba_info. - vmware_host_vmnic_facts — устаревший модуль
vmware_host_vmnic_factsудалён; вместо него используйтеvmware_host_vmnic_info. - vmware_local_role_facts — устаревший модуль
vmware_local_role_factsудалён; вместо него используйтеvmware_local_role_info. - vmware_local_user_facts — устаревший модуль
vmware_local_user_factsудалён; вместо него используйтеvmware_local_user_info. - vmware_portgroup_facts — устаревший модуль
vmware_portgroup_factsудалён; вместо него используйтеvmware_portgroup_info. - vmware_resource_pool_facts — устаревший модуль
vmware_resource_pool_factsудалён; вместо него используйтеvmware_resource_pool_info. - vmware_tag_facts — устаревший модуль
vmware_tag_factsудалён; вместо него используйтеvmware_tag_info. - vmware_target_canonical_facts — устаревший модуль
vmware_target_canonical_factsудалён; вместо него используйтеvmware_target_canonical_info. - vmware_vm_facts — устаревший модуль
vmware_vm_factsудалён; вместо него используйтеvmware_vm_info. - vmware_vmkernel_facts — устаревший модуль
vmware_vmkernel_factsудалён; вместо него используйтеvmware_vmkernel_info. - vmware_vmkernel_ip_config — устаревший модуль
vmware_vmkernel_ip_configудалён; вместо него используйтеvmware_vmkernel. - vmware_vswitch_facts — устаревший модуль
vmware_vswitch_factsудалён; вместо него используйтеvmware_vswitch_info.
Устаревшие функции
- Коллекция
community.sapпереименована вcommunity.sap_libs. Пока обе коллекции включены в Ansible. Содержимоеcommunity.sapбудет заменено устаревшими перенаправлениями на новую коллекцию в Ansible 7.0.0, а затем эти перенаправления будут удалены из Ansible. Обновите свои FQCN дляcommunity.sap.
Ansible-core
- ansible-core — прекращается поддержка Python 2.6.
- ansible-test — прекращается поддержка Python 2.6.
- Параметр плагина подключения ssh scp_if_ssh заменяется на ssh_transfer_method.
amazon.aws
- ec2_instance — значение по умолчанию для
`instance_type`объявлено устаревшим; в следующем выпуске необходимо будет задать instance_type или launch_template (https://github.com/ansible-collections/amazon.aws/pull/587). - module_utils — поддержка исходного AWS SDK
botoобъявлена устаревшей в пользу SDKboto3/botocore. Все модули на основеbotoлибо объявлены устаревшими, либо перенесены наbotocore, а оставшийся код поддержки в module_utils будет удалён в выпуске 4.0.0 коллекции amazon.aws. Все модули вне коллекций amazon.aws и community.aws, использующие библиотекуboto, необходимо будет перенести на библиотекиboto3/botocore(https://github.com/ansible-collections/amazon.aws/pull/575).
cisco.ios
- Модуль lldp объявлен устаревшим.
- ios_acls — альтернативный логический атрибут fragment объявлен устаревшим; используйте enable_fragment.
cisco.nxos
- Модуль nxos_snmp_community объявлен устаревшим.
- Модуль nxos_snmp_contact объявлен устаревшим.
- Модуль nxos_snmp_host объявлен устаревшим.
- Модуль nxos_snmp_location объявлен устаревшим.
- Модуль nxos_snmp_traps объявлен устаревшим.
- Модуль nxos_snmp_user объявлен устаревшим.
community.docker
- Поддержка Ansible 2.9 и ansible-base 2.10 объявлена устаревшей и будет удалена в следующем основном выпуске (community.docker 3.0.0). Некоторые модули могут продолжить работать с этими версиями, но мы больше не будем сохранять код совместимости, необходимый для их поддержки (https://github.com/ansible-collections/community.docker/pull/361).
- Зависимость от docker-compose для сред выполнения объявлена устаревшей и будет удалена в community.docker 3.0.0. Библиотека Python docker-compose не поддерживается и может вызывать проблемы с зависимостями. При необходимости её по-прежнему можно установить вручную в среде выполнения (https://github.com/ansible-collections/community.docker/pull/373).
- Различные модули — значение по умолчанию
tls_hostname, которое предполагалось удалить в community.docker 2.0.0, теперь будет удалено в версии 3.0.0 (https://github.com/ansible-collections/community.docker/pull/362). - docker_stack — возвращаемые значения
outиerr, которые предполагалось удалить в community.docker 2.0.0, теперь будут удалены в версии 3.0.0 (https://github.com/ansible-collections/community.docker/pull/362).
community.general
- ansible_galaxy_install — объявлена устаревшей поддержка
ansible2.9 иansible-base2.10 (https://github.com/ansible-collections/community.general/pull/4601). - Модуль поиска dig — тип записи
DLVвыведен из эксплуатации в 2017 году; его поддержка будет удалена из community.general 6.0.0 (https://github.com/ansible-collections/community.general/pull/4618). - gem — значение по умолчанию параметра
norcобъявлено устаревшим и будет изменено наtrueв community.general 6.0.0. Чтобы избежать предупреждения об устаревании, укажите значение явно (https://github.com/ansible-collections/community.general/pull/4517). - Модуль обратного вызова mail — отсутствие параметра
senderобъявлено устаревшим и будет запрещено в community.general 6.0.0 (https://github.com/ansible-collections/community.general/pull/4140). - Утилиты модулей module_helper — атрибут
ModuleHelper.VarDictобъявлен устаревшим (https://github.com/ansible-collections/community.general/pull/3801). - nmcli — режим hairpin по умолчанию для моста объявлен устаревшим. Это позволит изменить его на
falseв community.general 7.0.0, поскольку это также значение по умолчанию вnmcli(https://github.com/ansible-collections/community.general/pull/4334). - pacman — начиная с community.general 5.0.0 статус
changedдляupdate_cacheбольше не будет игнорироваться, если указанnameилиupgrade. Чтобы сохранить прежнее поведение, добавьте к задаче, например,register: resultиchanged_when: result.packages | length > 0(https://github.com/ansible-collections/community.general/pull/4329). - Модуль инвентаризации proxmox — текущее значение по умолчанию
trueпараметраwant_proxmox_nodes_ansible_hostобъявлено устаревшим. В community.general 6.0.0 значение по умолчанию изменится наfalse. Чтобы сохранить текущее поведение, явно задайте дляwant_proxmox_nodes_ansible_hostзначениеtrueв конфигурации инвентаризации. Рекомендуем заранее перейти на новое поведение, явно задав значениеfalseи используяcompose:для установкиansible_hostв правильное значение. Подробности см. в примерах документации плагина (https://github.com/ansible-collections/community.general/pull/4466). - vmadm — параметр модуля
debugобъявлен устаревшим, поскольку нигде не использовался (https://github.com/ansible-collections/community.general/pull/4580).
community.hashi_vault
- Поддержка Ansible 2.9 и ansible-base 2.10 объявлена устаревшей и будет удалена в следующем основном выпуске (community.hashi_vault 3.0.0) следующей весной (https://github.com/ansible-community/community-topics/issues/50, https://github.com/ansible-collections/community.hashi_vault/issues/189).
- Метод аутентификации aws_iam_login — метод
aws_iam_loginпереименован вaws_iam. Старое имя будет удалено в версии коллекции3.0.0. До этого момента будут работать оба имени; при использовании старого будет выводиться предупреждение (https://github.com/ansible-collections/community.hashi_vault/pull/193). - Параметры token_validate — значение по умолчанию общего параметра аутентификации
token_validateизменится сTrueнаFalseв версии community.hashi_vault 4.0.0. Для поиска и модуляvault_loginсохранится значение по умолчаниюTrue(https://github.com/ansible-collections/community.hashi_vault/issues/248). - Параметры token_validate — значение по умолчанию общего параметра аутентификации
token_validateизменится сtrueнаfalseв версии community.hashi_vault 4.0.0. Для поиска и модуляvault_loginсохранится значение по умолчаниюtrue(https://github.com/ansible-collections/community.hashi_vault/issues/248).
community.network
- Поддержка Ansible 2.9 и ansible-base 2.10 объявлена устаревшей и будет удалена в следующем основном выпуске (community.network 4.0.0) этой весной. Хотя большая часть содержимого, вероятно, продолжит работать с ansible-base 2.10, мы удалим символические ссылки для модулей и подключаемых модулей действий, из-за чего их больше нельзя будет использовать с Ansible 2.9. Используйте community.network 3.x.y с Ansible 2.9 и ansible-base 2.10: эти выпуски продолжат поддерживать Ansible 2.9 и ansible-base 2.10 даже после окончания срока их службы (https://github.com/ansible-community/community-topics/issues/50, https://github.com/ansible-collections/community.network/pull/382).
junipernetworks.junos
- Параметр ‘router_id’ объявлен устаревшим в ресурсных модулях junos_ospf_interfaces, junos_ospfv2 и junos_ospfv3.
purestorage.flasharray
- purefa_sso — объявлен устаревшим в пользу M(purefa_admin). Будет удалён в версии 2.0 коллекции.
© 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_6.html