Руководство по переносу Ansible 3
Ansible 3 основан на Ansible-Base 2.10, который относится к тому же основному выпуску, что и Ansible 2.10. Поэтому в этом руководстве по переносу нет раздела, посвящённого ansible-base. Если вы переходите с Ansible 2.9, сначала ознакомьтесь с руководством по переносу Ansible 2.10, а затем продолжайте работу с руководством по переносу Ansible 3.
Рекомендуем ознакомиться с этой страницей и списком изменений Ansible 3, чтобы понять, какие обновления вам может потребоваться выполнить.
Руководство по переносу для v3.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. Дождитесь завершения задания и запустите задачу снова. - 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 поддерживает такую возможность. Если восходящее соединение создаётся с именем уже существующего соединения, существующее соединение изменяется.
Основные изменения
Ansible-base
- ansible-test — тесты, запускаемые с контейнерами тестов
centos6иdefault, теперь используют контейнер-прокси PyPI для доступа к PyPI при использовании Python 2.6. Это позволяет тестам, выполняемым под Python 2.6, продолжать работу, несмотря на прекращение поддержки PyPI клиентов, не поддерживающих SNI.
community.postgresql
- postgresql_query — значение по умолчанию параметра
as_single_queryбудет изменено наyesв community.postgresql 2.0.0 (https://github.com/ansible-collections/community.postgresql/issues/85).
netapp.ontap
- na_ontap_autosupport — в модуль добавлена поддержка REST.
Устаревшие функции
community.aws
- 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.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).
Руководство по переносу для v3.3.0
Основные изменения
community.mysql
- mysql_user —
REQUIRESSLявляется псевдонимом ключаsslв параметреtls_requiresвcommunity.mysql2.0.0. Поддержка этого псевдонима будет полностью удалена вcommunity.mysql3.0.0 (https://github.com/ansible-collections/community.mysql/issues/121).
Устаревшие функции
community.vmware
- vmware_vmkernel_ip_config — объявлен устаревшим в пользу vmware_vmkernel (https://github.com/ansible-collections/community.vmware/pull/667).
f5networks.f5_modules
- Поддержка версий Python ниже 3.5 объявлена устаревшей
Руководство по переносу для v3.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_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 поддерживает такую возможность. Если восходящее соединение создаётся с именем уже существующего соединения, существующее соединение изменяется.
Несовместимые изменения
community.docker
- docker_swarm — если указан
join_token, возвращённый токен присоединения с таким же значением будет заменён наVALUE_SPECIFIED_IN_NO_LOG_PARAMETER. Не используйте вслепую токены присоединения из возвращаемого значения этого модуля, если он запущен с указаннымjoin_token! Это несовместимое изменение включено в минорный выпуск, поскольку необходимо для устранения проблемы безопасности (https://github.com/ansible-collections/community.docker/pull/103).
Устаревшие функции
community.crypto
- acme module_utils — модуль
acmemodule_utils (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).
Руководство по переносу для v3.1.0
Известные проблемы
dellemc.openmanage
- ome_smart_fabric — проблема (185322): OpenManage Enterprise Modular поддерживает только три типа проектов, однако модуль успешно создаёт фабрику, если тип проекта не поддерживается.
- ome_smart_fabric_uplink — проблема (186024): модуль ome_smart_fabric_uplink не позволяет создавать несколько восходящих соединений с одинаковым именем, хотя OpenManage Enterprise Modular поддерживает такую возможность. Если восходящее соединение создаётся с именем уже существующего соединения, существующее соединение изменяется.
Основные изменения
community.grafana
- в модули grafana_teams и grafana_folder добавлен параметр «skip_version_check» (#147)
community.mysql
- mysql_replication — значения параметра mode
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 — слово
SLAVEв сообщениях, возвращаемых модулем, будет заменено наREPLICAвcommunity.mysql2.0.0 (https://github.com/ansible-collections/community.mysql/issues/98).
Удалённые функции
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
Устаревшие функции
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 вместе с lookup (https://github.com/ansible-collections/community.aws/pull/366).
community.crypto
- 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). - 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).
Руководство по переносу на v3.0.0
Известные проблемы
dellemc.openmanage
- Проблема 1(186024): модуль ome_smart_fabric_uplink не позволяет создавать несколько восходящих каналов с одинаковым именем, хотя OpenManage Enterprise Modular поддерживает такую возможность. Если восходящий канал создается с именем, совпадающим с именем существующего канала, существующий канал изменяется.
- Проблема 2(187956): если указано недопустимое значение job_id, idrac_lifecycle_controller_job_status_info возвращает сообщение об ошибке. В этом сообщении не содержится информация о конкретной проблеме с недопустимым значением job_id.
- Проблема 3(188267): при обновлении микропрограммы iDRAC модуль idrac_firmware завершает выполнение до окончания задания обновления микропрограммы. В выводе задачи отображается неверное сообщение: «DRAC WSMAN endpoint returned HTTP code ‘400’ Reason ‘Bad Request’». Эта проблема может возникнуть, если целевая версия микропрограммы iDRAC ниже 3.30.30.30
Несовместимые изменения
Ansible-base
- Команда ansible-galaxy login удалена (см. проблему 71560)
ansible.utils
- Если в коллекцию добавлены пользовательские подмодули подключаемых модулей, перенесите их из старого расположения
plugins/<sub-plugin-name>в новое расположениеplugins/sub_plugins/<sub-plugin-name>и при необходимости обновите импорты - Переместите подмодули подключаемых модулей cli_parsers, fact_diff и validate в каталог
plugins/sub_plugins - Имя каталога подмодулей подключаемых модулей
cli_parsersизменено наcli_parseдля обеспечения единообразия именования; теперь все подмодули cli_parse будут находиться в каталогеplugins/sub_plugins/cli_parse
cloudscale_ch.cloud
- floating_ip — для назначения нового плавающего IP-адреса требуется
name.
community.general
-
Если вы используете Ansible 2.9 и подключаемые модули или модули Google Cloud из этой коллекции, community.general 2.0.0 вызывает ошибки при попытке использовать содержимое Google Cloud по FQCN, например
community.general.gce_img. Поскольку Ansible 2.9 не поддерживает перенаправления, необходимо вручную изменить плейбуки и роли, чтобы использовать новые FQCN (community.google.gce_imgв предыдущем примере), а также убедиться, что установлен пакетcommunity.google.Если вы используете ansible-base 2.10 или новее и не устанавливали Ansible 3.0.0, а установили (и/или обновили) community.general вручную, необходимо также установить коллекции
community.googleилиgoogle.cloud, если используются какие-либо подключаемые модули или модули Google Cloud. Хотя ansible-base 2.10 или новее может использовать перенаправления, добавленные в community.general 2.0.0, для их работы должна быть установлена целевая коллекция (например, community.google). -
Если вы используете Ansible 2.9 и подключаемые модули или модули Kubevirt из этой коллекции, community.general 2.0.0 вызывает ошибки при попытке использовать содержимое Kubevirt по FQCN, например
community.general.kubevirt_vm. Поскольку Ansible 2.9 не поддерживает перенаправления, необходимо вручную изменить плейбуки и роли, чтобы использовать новые FQCN (community.kubevirt.kubevirt_vmв предыдущем примере), а также убедиться, что установлена коллекцияcommunity.kubevirt.Если вы используете ansible-base 2.10 или новее и не устанавливали Ansible 3.0.0, а установили (и/или обновили) community.general вручную, необходимо также установить коллекцию
community.kubevirt, если используются какие-либо подключаемые модули или модули Kubevirt. Хотя ansible-base 2.10 или новее может использовать перенаправления, добавленные в community.general 2.0.0, для их работы должна быть установлена целевая коллекция (например, community.google). -
Если вы используете Ansible 2.9 и подключаемые модули или модули
dockerиз этой коллекции, community.general 2.0.0 вызывает ошибки при попытке использовать содержимое docker по FQCN, напримерcommunity.general.docker_container. Поскольку Ansible 2.9 не поддерживает перенаправления, необходимо вручную изменить плейбуки и роли, чтобы использовать новые FQCN (community.docker.docker_containerв предыдущем примере), а также убедиться, что установлен пакетcommunity.docker.Если вы используете ansible-base 2.10 или новее и не устанавливали Ansible 3.0.0, а установили (и/или обновили) community.general вручную, необходимо также установить
community.docker, если используются какие-либо подключаемые модули или модулиdocker. Хотя ansible-base 2.10 или новее может использовать перенаправления, добавленные в community.general 2.0.0, для их работы должна быть установлена целевая коллекция (community.docker). -
Если вы используете Ansible 2.9 и модуль поиска
hashi_vaultиз этой коллекции, community.general 2.0.0 вызывает ошибки при попытке использовать содержимое Hashi Vault по FQCN, напримерcommunity.general.hashi_vault. Поскольку Ansible 2.9 не поддерживает перенаправления, необходимо вручную изменить инвентаризации, файлы переменных, плейбуки и роли, чтобы использовать новый FQCN (community.hashi_vault.hashi_vault), а также убедиться, что установлена коллекцияcommunity.hashi_vault.Если вы используете ansible-base 2.10 или новее и не устанавливали Ansible 3.0.0, а установили (и/или обновили) community.general вручную, необходимо также установить
community.hashi_vault, если используется подключаемый модульhashi_vault. Хотя ansible-base 2.10 или новее может использовать перенаправления, добавленные в community.general 2.0.0, для их работы должна быть установлена целевая коллекция (community.hashi_vault). -
Если вы используете Ansible 2.9 и модули
hetznerиз этой коллекции, community.general 2.0.0 вызывает ошибки при попытке использовать содержимое hetzner по FQCN, напримерcommunity.general.hetzner_firewall. Поскольку Ansible 2.9 не поддерживает перенаправления, необходимо вручную изменить плейбуки и роли, чтобы использовать новые FQCN (community.hrobot.firewallв предыдущем примере), а также убедиться, что установлена коллекцияcommunity.hrobot.Если вы используете ansible-base 2.10 или новее и не устанавливали Ansible 3.0.0, а установили (и/или обновили) community.general вручную, необходимо также установить
community.hrobot, если используются какие-либо модулиhetzner. Хотя ansible-base 2.10 или новее может использовать перенаправления, добавленные в community.general 2.0.0, для их работы должна быть установлена целевая коллекция (community.hrobot). -
Если вы используете Ansible 2.9 и подключаемый модуль соединения
ocиз этой коллекции, community.general 2.0.0 вызывает ошибки при попытке использовать содержимое oc по FQCN, напримерcommunity.general.oc. Поскольку Ansible 2.9 не поддерживает перенаправления, необходимо вручную изменить инвентаризации, файлы переменных, плейбуки и роли, чтобы использовать новый FQCN (community.okd.oc), а также убедиться, что установлена коллекцияcommunity.okd.Если вы используете ansible-base 2.10 или новее и не устанавливали Ansible 3.0.0, а установили (и/или обновили) community.general вручную, необходимо также установить
community.okd, если используется подключаемый модульoc. Хотя ansible-base 2.10 или новее может использовать перенаправления, добавленные в community.general 2.0.0, для их работы должна быть установлена целевая коллекция (community.okd). -
Если вы используете Ansible 2.9 и модули
postgresqlиз этой коллекции, community.general 2.0.0 вызывает ошибки при попытке использовать содержимое postgresql по FQCN, напримерcommunity.general.postgresql_info. Поскольку Ansible 2.9 не поддерживает перенаправления, необходимо вручную изменить плейбуки и роли, чтобы использовать новые FQCN (community.postgresql.postgresql_infoв предыдущем примере), а также убедиться, что установлена коллекцияcommunity.postgresql.Если вы используете ansible-base 2.10 или новее и не устанавливали Ansible 3.0.0, а установили (и/или обновили) community.general вручную, необходимо также установить
community.postgresql, если используются какие-либо модулиpostgresql. Хотя ansible-base 2.10 или новее может использовать перенаправления, добавленные в community.general 2.0.0, для их работы должна быть установлена целевая коллекция (community.postgresql). - Скрипт инвентаризации Google Cloud
gce.pyперенесен в коллекциюcommunity.google. Чтобы продолжить его использование, установите коллекциюcommunity.google. - archive — удалять сам каталог path, если параметр
removeимеет значение true (https://github.com/ansible-collections/community.general/issues/1041). - Обратный вызов log_plays — добавлена отсутствовавшая информация в журналы, формируемые подключаемым модулем обратного вызова. Формат сообщений журнала изменен (https://github.com/ansible-collections/community.general/pull/442).
- Подключаемый модуль поиска passwordstore — теперь запись хранилища паролей по возможности разбирается как YAML с пропуском первой строки (по соглашению она содержит только пароль). Если разобрать запись как YAML не удается, для ее обработки используется старый синтаксический анализатор
key: value. Это может нарушить обратную совместимость, если код в формате YAML разбирался не как YAML. Например,foo: [bar, baz]в новой версии станет списком из двух элементов, а в старой — строкой'[bar, baz]'(https://github.com/ansible-collections/community.general/issues/1673). - pkgng — передача
name: *вместе сstate: absentбольше не удаляет из системы все установленные пакеты. Теперь эта операция ничего не делает. (https://github.com/ansible-collections/community.general/pull/569). - pkgng — передача
name: *вместе сstate: latestилиstate: presentбольше не устанавливает все пакеты из настроенных репозиториев пакетов. Вместо этогоname: *, state: latestобновит все уже установленные пакеты, аname: *, state: presentничего не сделает. (https://github.com/ansible-collections/community.general/pull/569). - proxmox_kvm — распознает
force=yesв сочетании сstate=absentдля принудительного удаления работающей виртуальной машины (https://github.com/ansible-collections/community.general/pull/849). - utm_proxy_auth_profile — возвращаемое значение
frontend_cookie_secretтеперь содержит строку-заполнитель вместо параметра модуляfrontend_cookie_secret(https://github.com/ansible-collections/community.general/pull/1736).
community.hashi_vault
- hashi_vault — переменная окружения
VAULT_ADDRтеперь проверяется последней для параметраurl. Сведения о случаях использования, которых это касается, см. в (https://github.com/ansible-collections/community.hashi_vault/issues/8).
community.hrobot
- firewall — теперь требуется библиотека ipaddress (https://github.com/ansible-collections/community.hrobot/pull/2).
community.network
-
Если вы используете Ansible 2.9 и модули FortiOS из этой коллекции, community.network 2.0.0 вызывает ошибки при попытке использовать содержимое FortiOS по FQCN, например
community.network.fmgr_device. Поскольку Ansible 2.9 не поддерживает перенаправления, необходимо вручную изменить плейбуки и роли, чтобы использовать новые FQCN (community.fortios.fmgr_deviceв предыдущем примере), а также убедиться, что установлена коллекцияcommunity.fortios.Если вы используете ansible-base 2.10 или новее и не устанавливали Ansible 3.0.0, а установили (и/или обновили) community.network вручную, необходимо также установить
community.fortios, если используются какие-либо модули FortiOS. Хотя ansible-base 2.10 или новее может использовать перенаправления, добавленные в community.network 2.0.0, для их работы должна быть установлена целевая коллекция (community.fortios). - Если вы используете Ansible 2.9 и модуль
cp_publishиз этой коллекции, community.network 2.0.0 вызывает ошибки при попытке использовать этот модуль по FQCN, то естьcommunity.network.cp_publish. Поскольку Ansible 2.9 не поддерживает перенаправления, необходимо вручную изменить плейбуки и роли, чтобы использовать новые FQCN (check_point.mgmt.cp_mgmt_publish), а также убедиться, что установлена коллекцияcheck_point.mgmt. Если вы используете ansible-base 2.10 или новее и не устанавливали Ansible 3.0.0, а установили (и/или обновили) community.network вручную, необходимо также установитьcheck_point.mgmt, если используется модульcp_publish. Хотя ansible-base 2.10 или новее может использовать перенаправления, добавленные в community.network 2.0.0, для их работы должна быть установлена целевая коллекция (check_point.mgmt). -
Если вы используете Ansible 2.9 и подключаемый модуль httpapi
fortimanagerиз этой коллекции, community.network 2.0.0 вызывает ошибки при попытке использовать его по FQCN (community.network.fortimanager). Поскольку Ansible 2.9 не поддерживает перенаправления, необходимо вручную изменить плейбуки и роли, чтобы использовать новый FQCNfortinet.fortimanager.fortimanager, а также убедиться, что установлена коллекцияfortinet.fortimanager.Если вы используете ansible-base 2.10 или новее и не устанавливали Ansible 3.0.0, а установили (и/или обновили) community.network вручную, необходимо также установить
fortinet.fortimanager, если используется подключаемый модуль httpapifortimanager. Хотя ansible-base 2.10 или новее может использовать перенаправление, добавленное в community.network 2.0.0, для его работы должна быть установлена целевая коллекция (fortinet.fortimanager). -
Если вы используете Ansible 2.9 и модули
nsoиз этой коллекции, community.network 2.0.0 вызывает ошибки при попытке использовать содержимое nso по FQCN, напримерcommunity.network.nso_config. Поскольку Ansible 2.9 не поддерживает перенаправления, необходимо вручную изменить плейбуки и роли, чтобы использовать новые FQCN (cisco.nso.nso_configв предыдущем примере), а также убедиться, что установлена коллекцияcisco.nso.Если вы используете ansible-base 2.10 или новее и не устанавливали Ansible 3.0.0, а установили (и/или обновили) community.network вручную, необходимо также установить
cisco.nso, если используются какие-либо модулиnso. Хотя ansible-base 2.10 или новее может использовать перенаправления, добавленные в community.network 2.0.0, для их работы должна быть установлена целевая коллекция (cisco.nso). -
Если вы используете Ansible 2.9 и подключаемые модули или модули
routerosиз этой коллекции, community.network 2.0.0 вызывает ошибки при попытке использовать содержимое routeros по FQCN, напримерcommunity.network.routeros_command. Поскольку Ansible 2.9 не поддерживает перенаправления, необходимо вручную изменить плейбуки и роли, чтобы использовать новые FQCN (community.routeros.commandв предыдущем примере), а также убедиться, что установлена коллекцияcommunity.routeros.Если вы используете ansible-base 2.10 или новее и не устанавливали Ansible 3.0.0, а установили (и/или обновили) community.network вручную, необходимо также установить
community.routeros, если используются какие-либо подключаемые модули или модулиrouteros. Хотя ansible-base 2.10 или новее может использовать перенаправления, добавленные в community.network 2.0.0, для их работы должна быть установлена целевая коллекция (community.routeros). - cnos_static_route — перенести импорт ipaddress из ansible.netcommon во встроенный модуль или пакет до удаления ipaddress из ansible.netcommon. Если вы используете этот модуль в Python 2.7, убедитесь, что установлен пакет ipaddress (https://github.com/ansible-collections/community.network/pull/129).
dellemc.os10
- os10_bgp — ключ «subnet» заменен со словаря на список в ключе «listen» для поддержки нескольких префиксов соседей в команде listen
- os10_bgp — ключ «vrf» заменен со словаря на список для поддержки нескольких VRF в router BGP; имя ключа «vrf» изменено на «vrfs»
ngine_io.cloudstack
- Удален вариант аутентификации с использованием INI-файлов, например
cloudstack.ini. Единственный поддерживаемый вариант аутентификации — использование параметров модуля с резервным переходом к переменным окружения. - Устаревание зоны по умолчанию — параметр
zone, значение которого по умолчанию использовалось в нескольких модулях, объявлен устаревшим из-за ненадежности API (https://github.com/ngine-io/ansible-collection-cloudstack/pull/62).
Основные изменения
cisco.aci
- В модуле aci_aaa_user_certificate для операции запроса параметр certificate_name заменен на name
community.general
-
В community.general 3.0.0 модули
ome_device_info,idrac_firmwareиidrac_server_config_profileбудут перенесены в коллекцию dellemc.openmanage. Будет добавлено перенаправление, поэтому пользователям ansible-base 2.10 или новее не потребуется ничего менять.Если вы используете Ansible 2.9 и явно используете упомянутые выше модули DellEMC из этой коллекции, необходимо изменить плейбуки и роли, заменив FQCN, начинающиеся с
community.general., на FQCN, начинающиеся сdellemc.openmanage.; например, заменить в задачеcommunity.general.ome_device_infoнаdellemc.openmanage.ome_device_info.Если вы используете ansible-base, вручную установили
community.generalи полагаетесь на упомянутые выше модули DellEMC, убедитесь, что установлена также коллекцияdellemc.openmanage. При использовании FQCN, напримерcommunity.general.ome_device_infoвместоome_device_info, все продолжит работать, но мы рекомендуем также обновить FQCN. - Коллекция community.general больше не зависит от коллекции ansible.netcommon (https://github.com/ansible-collections/community.general/pull/1561).
- Коллекция community.general больше не зависит от коллекции ansible.posix (https://github.com/ansible-collections/community.general/pull/1157).
community.kubernetes
- k8s — добавлена поддержка параметра template (https://github.com/ansible-collections/community.kubernetes/pull/230).
- k8s_* — добавлена поддержка зашифрованных kubeconfig и src (https://github.com/ansible-collections/community.kubernetes/pull/193).
community.okd
- Добавлен пользовательский модуль k8s, улучшены тесты Molecule (https://github.com/ansible-collections/community.okd/pull/7).
- Добавлены сценарии сборки для последующей сборки redhat.openshift (https://github.com/ansible-collections/community.okd/pull/20).
- Добавлен подключаемый модуль соединения openshift, подключаемый модуль инвентаризации обновлен для его использования (https://github.com/ansible-collections/community.okd/pull/18).
- Добавлен модуль openshift_process для визуализации шаблонов и необязательного применения визуализированных ресурсов (https://github.com/ansible-collections/community.okd/pull/44).
- Добавлен модуль openshift_route для создания маршрутов из служб (https://github.com/ansible-collections/community.okd/pull/40).
- Выполнен первоначальный перенос содержимого из community.kubernetes (https://github.com/ansible-collections/community.okd/pull/3).
- openshift_auth — новый модуль (перенесен из k8s_auth в community.kubernetes) (https://github.com/ansible-collections/community.okd/pull/33).
dellemc.openmanage
- Удалены существующие устаревшие модули.
- Десять модулей Ansible для iDRAC приведены к единому стандарту в соответствии с рекомендациями Ansible.
- Добавлена поддержка OpenManage Enterprise Modular.
dellemc.os10
- os10_bgp — расширена поддержка ключевых слов router bgp для VRF, отличных от VRF по умолчанию, которые поддерживаются для VRF по умолчанию; добавлено ключевое слово для поддержки как VRF по умолчанию, так и остальных VRF
- Роль os10_snmp — добавлена поддержка функций SNMP V3 для community, group, host и engineID
f5networks.f5_modules
- Во все модули добавлена интеграция Teem для отправки телеметрии; ее можно отключить, задав переменную окружения F5_TEEM или параметр поставщика no_f5_teem
- В модуль bigip_ucs_fetch добавлен параметр async_timeout для настройки времени ожидания модулем асинхронного интерфейса
- Модуль bigip_ucs_fetch изменен для использования асинхронного интерфейса при создании файлов UCS
kubernetes.core
- Добавлены журнал изменений и его фрагменты, задокументирован процесс ведения журнала изменений (https://github.com/ansible-collections/kubernetes.core/pull/131).
- helm — новый модуль для управления диаграммами Helm (https://github.com/ansible-collections/kubernetes.core/pull/61).
- helm_info — новый модуль для получения сведений о диаграммах Helm (https://github.com/ansible-collections/kubernetes.core/pull/61).
- helm_plugin — новый модуль для управления подключаемыми модулями Helm (https://github.com/ansible-collections/kubernetes.core/pull/154).
- helm_plugin_info — новые модули для сбора сведений о подключаемых модулях Helm (https://github.com/ansible-collections/kubernetes.core/pull/154).
- helm_repository — новый модуль для управления репозиториями Helm (https://github.com/ansible-collections/kubernetes.core/pull/61).
- k8s — добавлена поддержка параметра template (https://github.com/ansible-collections/kubernetes.core/pull/230).
- k8s — источник инвентаризации перенесен из Ansible 2.9 в коллекцию Kubernetes.
- k8s — подключаемый модуль поиска перенесен из Ansible 2.9 в коллекцию Kubernetes.
- k8s — модуль перенесен из Ansible 2.9 в коллекцию Kubernetes.
- k8s_* — добавлена поддержка зашифрованных kubeconfig и src (https://github.com/ansible-collections/kubernetes.core/pull/193).
- k8s_auth — модуль перенесен из Ansible 2.9 в коллекцию Kubernetes.
- k8s_config_resource_name — подключаемый модуль фильтра перенесен из Ansible 2.9 в коллекцию Kubernetes.
- k8s_exec — новый модуль для выполнения команд в подах через API Kubernetes (https://github.com/ansible-collections/kubernetes.core/pull/14).
- k8s_exec — для выполненной команды возвращается rc (https://github.com/ansible-collections/kubernetes.core/pull/158).
- k8s_info — модуль перенесен из Ansible 2.9 в коллекцию Kubernetes.
- k8s_log — новый модуль для получения журналов подов (https://github.com/ansible-collections/kubernetes.core/pull/16).
- k8s_scale — модуль перенесен из Ansible 2.9 в коллекцию Kubernetes.
- k8s_service — модуль перенесен из Ansible 2.9 в коллекцию Kubernetes.
- kubectl — подключаемый модуль соединения перенесен из Ansible 2.9 в коллекцию Kubernetes.
- openshift — источник инвентаризации перенесен из Ansible 2.9 в коллекцию Kubernetes.
netbox.netbox
- nb_inventory — добавлен параметр
dns_name, который добавляетdns_nameк узлу, еслиTrueи у устройства есть основной IP-адрес. (#394) - nb_inventory — добавлен
statusкак параметрgroup_by. (398) - nb_inventory — изменено расположение
extracted_primary_ip, чтобы разрешить переопределение с помощьюconfig_contextилиcustom_field. (#377) - nb_inventory — из-за изменений в NetBox 2.10 службы теперь представлены списком целых чисел. (#396)
- nb_lookup — разрешена передача ID; вместо
.filterиспользуется.get. (#376) - nb_lookup — разрешен поиск
api_endpointиtokenчерез переменные окружения. (#391)
ovirt.ovirt
- cluster_upgrade — перенос роли (https://github.com/oVirt/ovirt-ansible-collection/pull/94).
- disaster_recovery — перенос роли (https://github.com/oVirt/ovirt-ansible-collection/pull/134).
- engine_setup — перенос роли (https://github.com/oVirt/ovirt-ansible-collection/pull/69).
- hosted_engine_setup — перенос роли (https://github.com/oVirt/ovirt-ansible-collection/pull/106).
- image_template — перенос роли (https://github.com/oVirt/ovirt-ansible-collection/pull/95).
- infra — перенос роли (https://github.com/oVirt/ovirt-ansible-collection/pull/92).
- manageiq — перенос роли (https://github.com/oVirt/ovirt-ansible-collection/pull/97).
- ovirt_system_option_info — добавлен новый модуль (https://github.com/oVirt/ovirt-ansible-collection/pull/206).
- repositories — перенос роли (https://github.com/oVirt/ovirt-ansible-collection/pull/96).
- shutdown_env — перенос роли (https://github.com/oVirt/ovirt-ansible-collection/pull/112).
- vm_infra — перенос роли (https://github.com/oVirt/ovirt-ansible-collection/pull/93).
servicenow.servicenow
- добавлены новые тесты (поиск без результатов, поиск нескольких элементов)
- добавлены связанные тесты
- добавлена поддержка параметров API таблиц ServiceNOW display_value, exclude_reference_link и suppress_pagination_header
- используется новый API для pysnow >=0.6.0
Удалённые функции
community.docker
- docker_container — больше не возвращает
ansible_facts(https://github.com/ansible-collections/community.docker/pull/1). - docker_container — значение по умолчанию для
networks_cli_compatibleизменено наtrue(https://github.com/ansible-collections/community.docker/pull/1). - docker_container — неиспользуемый параметр
trust_image_contentудалён (https://github.com/ansible-collections/community.docker/pull/1). - docker_image —
state=buildудалён. Вместо него используйтеpresent(https://github.com/ansible-collections/community.docker/pull/1). - docker_image — параметры
container_limits,dockerfile,http_timeout,nocache,rm,path,buildargs,pullудалены. Вместо них используйте соответствующие подопцииbuild(https://github.com/ansible-collections/community.docker/pull/1). - docker_image — параметр
forceудалён. Вместо него используйте более конкретные параметрыforce_*(https://github.com/ansible-collections/community.docker/pull/1). - docker_image — параметр
sourceтеперь является обязательным (https://github.com/ansible-collections/community.docker/pull/1). - docker_image — параметр
use_tlsудалён. Вместо него используйтеtlsиvalidate_certs(https://github.com/ansible-collections/community.docker/pull/1). - docker_image — значение по умолчанию для параметра
build.pullизменено наfalse(https://github.com/ansible-collections/community.docker/pull/1). - docker_image_facts — этот псевдоним больше недоступен, вместо него используйте
docker_image_info(https://github.com/ansible-collections/community.docker/pull/1). - docker_network — больше не возвращает
ansible_facts(https://github.com/ansible-collections/community.docker/pull/1). - docker_network — параметр
ipam_optionsудалён. Вместо него используйтеipam_config(https://github.com/ansible-collections/community.docker/pull/1). - docker_service — больше не возвращает
ansible_facts(https://github.com/ansible-collections/community.docker/pull/1). - docker_swarm —
state=inspectудалён. Вместо него используйтеdocker_swarm_info(https://github.com/ansible-collections/community.docker/pull/1). - docker_swarm_service — параметр
constraintsудалён. Вместо него используйтеplacement.constraints(https://github.com/ansible-collections/community.docker/pull/1). - docker_swarm_service — параметры
limit_cpuиlimit_memoryудалены. Вместо них используйте соответствующие подопции вlimits(https://github.com/ansible-collections/community.docker/pull/1). - docker_swarm_service — параметры
log_driverиlog_driver_optionsудалены. Вместо них используйте соответствующие подопции вlogging(https://github.com/ansible-collections/community.docker/pull/1). - docker_swarm_service — параметры
reserve_cpuиreserve_memoryудалены. Вместо них используйте соответствующие подопции вreservations(https://github.com/ansible-collections/community.docker/pull/1). - docker_swarm_service — параметры
restart_policy,restart_policy_attempts,restart_policy_delayиrestart_policy_windowудалены. Вместо них используйте соответствующие подопции вrestart_config(https://github.com/ansible-collections/community.docker/pull/1). - docker_swarm_service — параметры
update_delay,update_parallelism,update_failure_action,update_monitor,update_max_failure_ratioиupdate_orderудалены. Вместо них используйте соответствующие подопции вupdate_config(https://github.com/ansible-collections/community.docker/pull/1). - docker_volume — больше не возвращает
ansible_facts(https://github.com/ansible-collections/community.docker/pull/1). - docker_volume — параметр
forceудалён. Вместо него используйтеrecreate(https://github.com/ansible-collections/community.docker/pull/1).
community.general
-
Все модули и плагины Google Cloud перенесены из этой коллекции. Их можно найти в коллекциях community.google или google.cloud. Если вы используете ansible-base 2.10 или новее, для них предусмотрены перенаправления.
Если вы используете Ansible 2.9 и установили эту коллекцию, необходимо скорректировать полные имена модулей (FQCN) (
community.general.gce_img→community.google.gce_img) и установить соответствующую коллекцию community.google или google.cloud. -
Все модули и плагины Kubevirt перенесены из community.general в коллекцию Ansible community.kubevirt. Если вы используете ansible-base 2.10 или новее, для них предусмотрены перенаправления.
Если вы используете Ansible 2.9 и установили эту коллекцию, необходимо скорректировать полные имена модулей (FQCN) (
community.general.kubevirt_vm→community.kubevirt.kubevirt_vm) и установить коллекцию community.kubevirt. -
Все модули и плагины
dockerудалены из этой коллекции. Они перенесены в коллекцию community.docker. Если вы используете ansible-base 2.10 или новее, для них предусмотрены перенаправления.Если вы используете Ansible 2.9 и установили эту коллекцию, необходимо скорректировать полные имена модулей (FQCN) (
community.general.docker_container→community.docker.docker_container) и установить коллекцию community.docker. -
Все модули
hetznerудалены из этой коллекции. Они перенесены в коллекцию community.hrobot. Если вы используете ansible-base 2.10 или новее, для них предусмотрены перенаправления.Если вы используете Ansible 2.9 и установили эту коллекцию, необходимо скорректировать полные имена модулей (FQCN) (
community.general.hetzner_firewall→community.hrobot.firewall) и установить коллекцию community.hrobot. -
Все модули
postgresqlудалены из этой коллекции. Они перенесены в коллекцию community.postgresql.Если вы используете ansible-base 2.10 или новее, для них предусмотрены перенаправления. Если вы используете Ansible 2.9 и установили эту коллекцию, необходимо скорректировать полные имена модулей (FQCN) (
community.general.postgresql_info→community.postgresql.postgresql_info) и установить коллекцию community.postgresql. - Скрипт инвентаризации Google Cloud
gce.pyперенесён в коллекциюcommunity.google. Чтобы продолжить его использование, установите коллекциюcommunity.google. -
Плагин поиска
hashi_vaultудалён из этой коллекции. Он перенесён в коллекцию community.hashi_vault. Если вы используете ansible-base 2.10 или новее, для него предусмотрено перенаправление.Если вы используете Ansible 2.9 и установили эту коллекцию, необходимо скорректировать полные имена модулей (FQCN) (
community.general.hashi_vault→community.hashi_vault.hashi_vault) и установить коллекцию community.hashi_vault. -
Плагин подключения
ocудалён из этой коллекции. Он перенесён в коллекцию community.okd. Если вы используете ansible-base 2.10 или новее, для него предусмотрено перенаправление.Если вы используете Ansible 2.9 и установили эту коллекцию, необходимо скорректировать полные имена модулей (FQCN) (
community.general.oc→community.okd.oc) и установить коллекцию community.okd. - Устаревший плагин обратного вызова
actionableудалён. Вместо него используйте плагин обратного вызоваansible.builtin.defaultс параметрамиdisplay_skipped_hosts = noиdisplay_ok_hosts = no(https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
foremanудалён. Вместо него используйте модули из коллекции theforeman.foreman (https://github.com/ansible-collections/community.general/pull/1347) (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший плагин обратного вызова
full_skipудалён. Вместо него используйте плагин обратного вызоваansible.builtin.defaultс параметромdisplay_skipped_hosts = no(https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
gcdns_recordудалён. Вместо него используйтеgoogle.cloud.gcp_dns_resource_record_set(https://github.com/ansible-collections/community.general/pull/1370). - Устаревший модуль
gcdns_zoneудалён. Вместо него используйтеgoogle.cloud.gcp_dns_managed_zone(https://github.com/ansible-collections/community.general/pull/1370). - Устаревший модуль
gceудалён. Вместо него используйтеgoogle.cloud.gcp_compute_instance(https://github.com/ansible-collections/community.general/pull/1370). - Устаревший модуль
gcp_backend_serviceудалён. Вместо него используйтеgoogle.cloud.gcp_compute_backend_service(https://github.com/ansible-collections/community.general/pull/1370). - Устаревший модуль
gcp_forwarding_ruleудалён. Вместо него используйтеgoogle.cloud.gcp_compute_forwarding_ruleилиgoogle.cloud.gcp_compute_global_forwarding_rule(https://github.com/ansible-collections/community.general/pull/1370). - Устаревший модуль
gcp_healthcheckудалён. Вместо него используйтеgoogle.cloud.gcp_compute_health_check,google.cloud.gcp_compute_http_health_checkилиgoogle.cloud.gcp_compute_https_health_check(https://github.com/ansible-collections/community.general/pull/1370). - Устаревший модуль
gcp_target_proxyудалён. Вместо него используйтеgoogle.cloud.gcp_compute_target_http_proxy(https://github.com/ansible-collections/community.general/pull/1370). - Устаревший модуль
gcp_url_mapудалён. Вместо него используйтеgoogle.cloud.gcp_compute_url_map(https://github.com/ansible-collections/community.general/pull/1370). - Устаревший модуль
gcspannerудалён. Вместо него используйтеgoogle.cloud.gcp_spanner_databaseи/илиgoogle.cloud.gcp_spanner_instance(https://github.com/ansible-collections/community.general/pull/1370). - Устаревший модуль
github_hooksудалён. Вместо него используйтеcommunity.general.github_webhookиcommunity.general.github_webhook_info(https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
katelloудалён. Вместо него используйте модули из коллекции theforeman.foreman (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
na_cdot_aggregateудалён. Вместо него используйте netapp.ontap.na_ontap_aggregate (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
na_cdot_licenseудалён. Вместо него используйте netapp.ontap.na_ontap_license (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
na_cdot_lunудалён. Вместо него используйте netapp.ontap.na_ontap_lun (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
na_cdot_qtreeудалён. Вместо него используйте netapp.ontap.na_ontap_qtree (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
na_cdot_svmудалён. Вместо него используйте netapp.ontap.na_ontap_svm (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
na_cdot_user_roleудалён. Вместо него используйте netapp.ontap.na_ontap_user_role (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
na_cdot_userудалён. Вместо него используйте netapp.ontap.na_ontap_user (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
na_cdot_volumeудалён. Вместо него используйте netapp.ontap.na_ontap_volume (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
sf_account_managerудалён. Вместо него используйте netapp.elementsw.na_elementsw_account (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
sf_check_connectionsудалён. Вместо него используйте netapp.elementsw.na_elementsw_check_connections (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
sf_snapshot_schedule_managerудалён. Вместо него используйте netapp.elementsw.na_elementsw_snapshot_schedule (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
sf_volume_access_group_managerудалён. Вместо него используйте netapp.elementsw.na_elementsw_access_group (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший модуль
sf_volume_managerудалён. Вместо него используйте netapp.elementsw.na_elementsw_volume (https://github.com/ansible-collections/community.general/pull/1347). - Устаревший плагин обратного вызова
stderrудалён. Вместо него используйте плагин обратного вызоваansible.builtin.defaultс параметромdisplay_failed_stderr = yes(https://github.com/ansible-collections/community.general/pull/1347). - Перенаправление плагина поиска
conjur_variableв коллекциюcyberark.conjur.conjur_variableудалено (https://github.com/ansible-collections/community.general/pull/1346). - Перенаправление модуля
firewalldи module_utilsfirewalldв коллекциюansible.posixудалено (https://github.com/ansible-collections/community.general/pull/1346). - Перенаправление в коллекцию
community.digitaloceanудалено для фрагмента документацииdigital_ocean, module_utilsdigital_oceanи следующих модулей:digital_ocean,digital_ocean_account_facts,digital_ocean_account_info,digital_ocean_block_storage,digital_ocean_certificate,digital_ocean_certificate_facts,digital_ocean_certificate_info,digital_ocean_domain,digital_ocean_domain_facts,digital_ocean_domain_info,digital_ocean_droplet,digital_ocean_firewall_facts,digital_ocean_firewall_info,digital_ocean_floating_ip,digital_ocean_floating_ip_facts,digital_ocean_floating_ip_info,digital_ocean_image_facts,digital_ocean_image_info,digital_ocean_load_balancer_facts,digital_ocean_load_balancer_info,digital_ocean_region_facts,digital_ocean_region_info,digital_ocean_size_facts,digital_ocean_size_info,digital_ocean_snapshot_facts,digital_ocean_snapshot_info,digital_ocean_sshkey,digital_ocean_sshkey_facts,digital_ocean_sshkey_info,digital_ocean_tag,digital_ocean_tag_facts,digital_ocean_tag_info,digital_ocean_volume_facts,digital_ocean_volume_info(https://github.com/ansible-collections/community.general/pull/1346). - Перенаправление в коллекцию
community.mysqlудалено для фрагмента документацииmysql, module_utilsmysqlи следующих модулей:mysql_db,mysql_info,mysql_query,mysql_replication,mysql_user,mysql_variables(https://github.com/ansible-collections/community.general/pull/1346). - Перенаправление в коллекцию
community.proxysqlудалено для фрагмента документацииproxysqlи следующих модулей:proxysql_backend_servers,proxysql_global_variables,proxysql_manage_config,proxysql_mysql_users,proxysql_query_rules,proxysql_replication_hostgroups,proxysql_scheduler(https://github.com/ansible-collections/community.general/pull/1346). - Перенаправление в коллекцию
infinidat.infiniboxудалено для фрагмента документацииinfinibox, module_utilsinfiniboxи следующих модулей:infini_export,infini_export_client,infini_fs,infini_host,infini_pool,infini_vol(https://github.com/ansible-collections/community.general/pull/1346). - Поиск conjur_variable перенесён в коллекцию
cyberark.conjur. Перенаправление пока действует и будет удалено в версии 2.0.0 (https://github.com/ansible-collections/community.general/pull/570). - digital_ocean_* — все модули DigitalOcean перенесены в коллекцию
community.digitalocean. Перенаправление пока действует и будет удалено в версии 2.0.0 (https://github.com/ansible-collections/community.general/pull/622). - infini_* — все модули infinidat перенесены в коллекцию
infinidat.infinibox. Перенаправление пока действует и будет удалено в версии 2.0.0 (https://github.com/ansible-collections/community.general/pull/607). - iptables_state — среда
ANSIBLE_ASYNC_DIRбольше не поддерживается, вместо неё используйте параметр оболочкиasync_dir(https://github.com/ansible-collections/community.general/pull/1371). - logicmonitor — модуль удалён в версии 1.0.0, так как он не поддерживается, а API, используемый модулем, был отключён в 2017 году (https://github.com/ansible-collections/community.general/issues/539, https://github.com/ansible-collections/community.general/pull/541).
- logicmonitor_facts — модуль удалён в версии 1.0.0, так как он не поддерживается, а API, используемый модулем, был отключён в 2017 году (https://github.com/ansible-collections/community.general/issues/539, https://github.com/ansible-collections/community.general/pull/541).
- Плагин кэша memcached — вместо этого не импортируйте
CacheModule``s directly. Use ``ansible.plugins.loader.cache_loader(https://github.com/ansible-collections/community.general/pull/1371). - mysql_* — все модули MySQL перенесены в коллекцию
community.mysql. Перенаправление пока действует и будет удалено в версии 2.0.0 (https://github.com/ansible-collections/community.general/pull/633). - proxysql_* — все модули ProxySQL перенесены в коллекцию
community.proxysql. Перенаправление пока действует и будет удалено в версии 2.0.0 (https://github.com/ansible-collections/community.general/pull/624). - Плагин кэша redis — вместо этого не импортируйте
CacheModule``s directly. Use ``ansible.plugins.loader.cache_loader(https://github.com/ansible-collections/community.general/pull/1371). - xml — при
content=attributeпараметрattributeигнорируется (https://github.com/ansible-collections/community.general/pull/1371).
community.network
-
Все модули и плагины FortiOS удалены из этой коллекции. Они перенесены в коллекцию community.fortios. Если вы используете ansible-base 2.10 или новее, настроены перенаправления.
Если вы используете Ansible 2.9 и установили эту коллекцию, необходимо скорректировать FQCN (
community.network.fmgr_device→community.fortios.fmgr_device) и убедиться, что установлена коллекцияcommunity.fortios. -
Все модули
nsoудалены из этой коллекции. Они перенесены в коллекцию cisco.nso. Если вы используете ansible-base 2.10 или новее, настроены перенаправления.Если вы используете Ansible 2.9 и установили эту коллекцию, необходимо скорректировать FQCN (
community.network.nso_config→cisco.nso.nso_config) и убедиться, что установлена коллекцияcisco.nso. -
Все модули и плагины
routerosудалены из этой коллекции. Они перенесены в коллекцию community.routeros. Если вы используете ansible-base 2.10 или новее, настроены перенаправления.Если вы используете Ansible 2.9 и установили эту коллекцию, необходимо скорректировать FQCN (
community.network.routeros_command→community.routeros.command) и убедиться, что установлена коллекция community.routeros. - Модуль
cp_publishудален из этой коллекции. Он дублировалcheck_point.mgmt.cp_mgmt_publishиз коллекции check_point.mgmt. Если вы используете ansible-base 2.10 или новее, настроены перенаправления. Если вы используете Ansible 2.9 и установили эту коллекцию, необходимо скорректировать FQCN (community.network.cp_publish→check_point.mgmt.cp_mgmt_publish) и убедиться, что установлена коллекция check_point.mgmt. -
Плагин httpapi
fortimanagerудален из этой коллекции. Он дублировал плагин из коллекции fortinet.fortimanager. Если вы используете ansible-base 2.10 или новее, настроено перенаправление.Если вы используете Ansible 2.9 и установили эту коллекцию, необходимо скорректировать FQCN (
community.network.fortimanager→fortinet.fortimanager.fortimanager) и убедиться, что установлена коллекцияfortinet.fortimanager. - Зависимость от коллекции
check_point.mgmtудалена. Если вы полагаетесь на то, что установкаcommunity.networkтакже устанавливаетcheck_point.mgmt, необходимо явно установитьcheck_point.mgmt. - Устаревшие модули Pluribus Networks
pn_cluster,pn_ospf,pn_ospfarea,pn_show,pn_trunk,pn_vlag,pn_vlan,pn_vrouter,pn_vrouterbgp,pn_vrouterif,pn_vrouterlbifудалены (https://github.com/ansible-collections/community.network/pull/176). - Устаревшие модули
panos_admin,panos_admpwd,panos_cert_gen_ssh,panos_check,panos_commit,panos_dag,panos_dag_tags,panos_import,panos_interface,panos_lic,panos_loadcfg,panos_match_rule,panos_mgtconfig,panos_nat_rule,panos_object,panos_op,panos_pg,panos_query_rules,panos_restart,panos_sag,panos_security_rule,panos_setудалены. Вместо них используйте модули коллекции paloaltonetworks.panos (https://github.com/ansible-collections/community.network/pull/176). - Удалено перенаправление на коллекцию
mellanox.onyxдля: плагина cliconfonyx, плагина терминала, module_utils, плагина action, фрагмента документации и следующих модулей:onyx_aaa,onyx_bfd,onyx_bgp,onyx_buffer_pool,onyx_command,onyx_config,onyx_facts,onyx_igmp,onyx_igmp_interface,onyx_igmp_vlan,onyx_interface,onyx_l2_interface,onyx_l3_interface,onyx_linkagg,onyx_lldp,onyx_lldp_interface,onyx_magp,onyx_mlag_ipl,onyx_mlag_vip,onyx_ntp,onyx_ntp_servers_peers,onyx_ospf,onyx_pfc_interface,onyx_protocol,onyx_ptp_global,onyx_ptp_interface,onyx_qos,onyx_snmp,onyx_snmp_hosts,onyx_snmp_users,onyx_syslog_files,onyx_syslog_remote,onyx_traffic_class,onyx_username,onyx_vlan,onyx_vxlan,onyx_wjh(https://github.com/ansible-collections/community.network/pull/175). - onyx — все модули и плагины onyx перенесены в коллекцию mellanox.onyx. Добавлены перенаправления, которые будут удалены в community.network 2.0.0 (https://github.com/ansible-collections/community.network/pull/83).
f5networks.f5_modules
- Из модуля bigip_virtual_address удален параметр arp_state
Устаревшие функции
cisco.nxos
- Модули
nxos_bgpиnxos_bgp_neighborобъявлены устаревшими в пользу модуля ресурсовnxos_bgp_global. - Модуль
nxos_interface_ospfобъявлен устаревшим в пользу модуля ресурсовnxos_ospf_interfaces. - Модуль
nxos_smuобъявлен устаревшим в пользу модуляnxos_rpm. - Модуль
nxos_ospf_vrfобъявлен устаревшим; вместо него следует использовать модули ресурсовnxos_ospfv2иnxos_ospfv3.
community.aws
- ec2_vpc_igw_info — после 2022-06-22 значение параметра
convert_tagsпо умолчанию изменится сFalseнаTrueв соответствии со стандартным поведением коллекции (https://github.com/ansible-collections/community.aws/pull/318).
community.docker
- docker_container — сейчас
published_portsможет содержать сопоставления портов наряду со специальным значениемall; в этом случае сопоставления портов игнорируются. Такое поведение объявлено устаревшим для community.docker 2.0.0: в этой версии оно либо будет запрещено, либо будет реализовано должным образом, аналогично тому, как это обрабатывает инструмент командной строки Docker (https://github.com/ansible-collections/community.docker/issues/8, https://github.com/ansible-collections/community.docker/pull/60).
community.general
- Модули
gluster_heal_info,gluster_peerиgluster_volumeперенесены в коллекцию gluster.gluster. В Ansible-base 2.10.1 целевой маршрут перенаправления был изменен так, чтобы указывать на модули в этой коллекции, поэтому мы удалим эти модули из community.general 3.0.0. Если вы используете Ansible 2.9 или FQCNcommunity.general.gluster_*в своих плейбуках и/или ролях, обновите их, чтобы использовать вместо них модули изgluster.gluster. - Модуль ldap_attr объявлен устаревшим и будет удален в одном из следующих выпусков; вместо него используйте ldap_attrs.
- django_manage — параметр
liveserverотносится к стороннему модулю django, поддержка которого прекращена. Этот параметр объявлен устаревшим и будет удален в community.general 3.0.0 (https://github.com/ansible-collections/community.general/pull/1154). - proxmox — значение нового параметра
proxmox_default_behaviorпо умолчанию изменится сcompatibilityнаno_defaultsв community.general 4.0.0. Укажите для параметра явное значение, чтобы избежать предупреждения об устаревании (https://github.com/ansible-collections/community.general/pull/850). - proxmox_kvm — значение нового параметра
proxmox_default_behaviorпо умолчанию изменится сcompatibilityнаno_defaultsв community.general 4.0.0. Укажите для параметра явное значение, чтобы избежать предупреждения об устаревании (https://github.com/ansible-collections/community.general/pull/850). - syspatch — аргумент
applyобъявлен устаревшим как избыточный (https://github.com/ansible-collections/community.general/pull/360). - xbps — параметр
forceникогда не влиял на работу. Теперь он объявлен устаревшим и будет удален в версии 3.0.0 (https://github.com/ansible-collections/community.general/pull/568).
community.hashi_vault
- hashi_vault — приоритет переменной окружения
VAULT_ADDRдля параметраurlбудет снижен в версии 1.0.0; используйтеANSIBLE_HASHI_VAULT_ADDR, чтобы намеренно переопределить значение конфигурации (https://github.com/ansible-collections/community.hashi_vault/issues/8). - hashi_vault — переменная окружения
VAULT_AUTH_METHODдля параметраauth_methodбудет удалена в версии 2.0.0; вместо нее используйтеANSIBLE_HASHI_VAULT_AUTH_METHOD(https://github.com/ansible-collections/community.hashi_vault/issues/17). - hashi_vault — переменная окружения
VAULT_ROLE_IDдля параметраrole_idбудет удалена в версии 2.0.0; вместо нее используйтеANSIBLE_HASHI_VAULT_ROLE_ID(https://github.com/ansible-collections/community.hashi_vault/issues/20). - hashi_vault — переменная окружения
VAULT_SECRET_IDдля параметраsecret_idбудет удалена в версии 2.0.0; вместо нее используйтеANSIBLE_HASHI_VAULT_SECRET_ID(https://github.com/ansible-collections/community.hashi_vault/issues/20). - hashi_vault — переменная окружения
VAULT_TOKEN_FILEдля параметраtoken_fileбудет удалена в версии 2.0.0; вместо нее используйтеANSIBLE_HASHI_VAULT_TOKEN_FILE(https://github.com/ansible-collections/community.hashi_vault/issues/15). - hashi_vault — переменная окружения
VAULT_TOKEN_PATHдля параметраtoken_pathбудет удалена в версии 2.0.0; вместо нее используйтеANSIBLE_HASHI_VAULT_TOKEN_PATH(https://github.com/ansible-collections/community.hashi_vault/issues/15).
community.network
- Поддержка connection=local для сетевых платформ, использующих постоянную инфраструктуру, объявлена устаревшей (https://github.com/ansible-collections/community.network/pull/120).
community.vmware
- vmware_host_firewall_manager — после выпуска версии 2.0.0 создание нового правила без записи
allowed_ipв словареallowed_hostsбудет запрещено.
dellemc.openmanage
- Модуль
dellemc_get_firmware_inventoryобъявлен устаревшим и заменен наidrac_firmware_info. - Модуль
dellemc_get_system_inventoryобъявлен устаревшим и заменен наidrac_system_info. - Модуль dellemc_change_power_state объявлен устаревшим и заменен на модуль redfish_powerstate.
- Модуль dellemc_configure_bios объявлен устаревшим и заменен на модуль idrac_bios.
- Модуль dellemc_configure_idrac_network объявлен устаревшим и заменен на модуль idrac_network.
- Модуль dellemc_configure_idrac_timezone объявлен устаревшим и заменен на модуль idrac_timezone_ntp.
- Модуль dellemc_configure_idrac_users объявлен устаревшим и заменен на модуль idrac_user.
- Модули dellemc_delete_lc_job и dellemc_delete_lc_job_queue объявлены устаревшими и заменены на модуль idrac_lifecycle_controller_jobs.
- Модуль dellemc_export_lc_logs объявлен устаревшим и заменен на модуль idrac_lifecycle_controller_logs.
- Модуль dellemc_get_lc_job_status объявлен устаревшим и заменен на модуль idrac_lifecycle_controller_job_status_info.
- Модуль dellemc_get_lcstatus объявлен устаревшим и заменен на модуль idrac_lifecycle_controller_status_info.
- Модуль dellemc_idrac_reset объявлен устаревшим и заменен на модуль idrac_reset.
- Модуль dellemc_setup_idrac_syslog объявлен устаревшим и заменен на модуль idrac_syslog.
© 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_3.html