Spec-Zone.ru › Ansible

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

  • Плейбук
  • Командная строка
  • Устаревшее

  • Критические изменения

    • Изменения в AnsibleModule
    • Изменения в ansible.module_utils.common.parameters
  • Прочее

  • Модули

    • Удалённые модули
    • Уведомления об устаревании
    • Важные изменения модулей
  • Плагины
  • Перенос пользовательских скриптов

  • Руководство по переносу для v4.10.0

    • Основные изменения
    • Устаревшие функции

  • Руководство по переносу для v4.9.0

    • Известные проблемы
    • Основные изменения

  • Руководство по переносу для v4.8.0

    • Критические изменения
    • Устаревшие функции

  • Руководство по переносу для v4.7.0

    • Основные изменения
    • Устаревшие функции

  • Руководство по переносу для v4.6.0

    • Основные изменения
    • Устаревшие функции

  • Руководство по переносу для v4.5.0

    • Основные изменения
    • Устаревшие функции

  • Руководство по переносу для v4.4.0

    • Известные проблемы
    • Устаревшие функции

  • Руководство по переносу для v4.3.0

    • Основные изменения
    • Устаревшие функции

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

    • Известные проблемы
    • Основные изменения
    • Устаревшие функции

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

    • Известные проблемы
    • Основные изменения
    • Удалённые функции
    • Устаревшие функции

  • Руководство по переносу для v4.0.0

    • Известные проблемы
    • Критические изменения
    • Основные изменения
    • Удалённые функции
    • Устаревшие функции

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

Плейбук

  • Настройка jinja2_native теперь не влияет на модуль template, который неявно возвращает строки. Для lookup-плагина template добавлен новый аргумент jinja2_native (по умолчанию выключен), управляющий этой функцией. Остальные выражения Jinja2 по-прежнему работают в соответствии с настройкой jinja2_native.

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

  • Команда ansible-galaxy login удалена, поскольку базовый API, использовавшийся для аутентификации в GitHub, отключён. Для публикации ролей или коллекций в Galaxy с помощью ansible-galaxy теперь необходимо передать токен API Galaxy в CLI через файл токена (расположение по умолчанию — ~/.ansible/galaxy_token) либо (небезопасно) с помощью аргумента --token для ansible-galaxy.

Устаревшее

Константа ansible.module_utils.basic._CHECK_ARGUMENT_TYPES_DISPATCHER объявлена устаревшей. Вместо неё используйте ansible.module_utils.common.parameters.DEFAULT_TYPE_VALIDATORS.

Критические изменения

Изменения в AnsibleModule

В связи с переходом на ArgumentSpecValidator для проверки спецификации аргументов удалены следующие закрытые методы из AnsibleModule:

  • _check_argument_types()
  • _check_argument_values()
  • _check_arguments()
  • _check_mutually_exclusive() –> ansible.module_utils.common.validation.check_mutually_exclusive()
  • _check_required_arguments() –> ansible.module_utils.common.validation.check_required_arguments()
  • _check_required_by() –> ansible.module_utils.common.validation.check_required_by()
  • _check_required_if() –> ansible.module_utils.common.validation.check_required_if()
  • _check_required_one_of() –> ansible.module_utils.common.validation.check_required_one_of()
  • _check_required_together() –> ansible.module_utils.common.validation.check_required_together()
  • _check_type_bits() –> ansible.module_utils.common.validation.check_type_bits()
  • _check_type_bool() –> ansible.module_utils.common.validation.check_type_bool()
  • _check_type_bytes() –> ansible.module_utils.common.validation.check_type_bytes()
  • _check_type_dict() –> ansible.module_utils.common.validation.check_type_dict()
  • _check_type_float() –> ansible.module_utils.common.validation.check_type_float()
  • _check_type_int() –> ansible.module_utils.common.validation.check_type_int()
  • _check_type_jsonarg() –> ansible.module_utils.common.validation.check_type_jsonarg()
  • _check_type_list() –> ansible.module_utils.common.validation.check_type_list()
  • _check_type_path() –> ansible.module_utils.common.validation.check_type_path()
  • _check_type_raw() –> ansible.module_utils.common.validation.check_type_raw()
  • _check_type_str() –> ansible.module_utils.common.validation.check_type_str()
  • _count_terms() –> ansible.module_utils.common.validation.count_terms()
  • _get_wanted_type()
  • _handle_aliases()
  • _handle_no_log_values()
  • _handle_options()
  • _set_defaults()
  • _set_fallbacks()

Модулям и плагинам, использующим эти закрытые методы, следует использовать общедоступные функции из ansible.module_utils.common.validation или ArgumentSpecValidator.validate(), если выше не указана общедоступная функция.

Изменения в ansible.module_utils.common.parameters

Следующие функции в ansible.module_utils.common.parameters теперь являются закрытыми и не должны использоваться напрямую. Вместо них используйте ArgumentSpecValidator.validate().

  • list_no_log_values
  • list_deprecations
  • handle_aliases

Прочее

  • Обновление: если вы обновляетесь с ansible < 2.10 или с ansible-base и используете pip, перед установкой ansible-core необходимо pip uninstall ansible или pip uninstall ansible-base, чтобы избежать конфликтов.
  • Python 3.8 на управляющем узле является мягким требованием для этого выпуска. ansible-core 2.11 по-прежнему работает с теми же версиями Python, что и ansible-base 2.10, однако 2.11 выдаёт предупреждение при запуске на управляющем узле с версией Python ниже 3.8. Это предупреждение можно отключить, задав в окружении ANSIBLE_CONTROLLER_PYTHON_WARNING=False. Для ansible-core 2.12 потребуется Python 3.8 или новее.
  • Теперь система конфигурации проверяет поле choices, поэтому любые настройки, нарушающие его и игнорировавшиеся в версии 2.10, вызывают ошибку в версии 2.11. Например, ANSIBLE_COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH=0 теперь вызывает ошибку (допустимые значения: ignore, warn или error).
  • Теперь команда ansible-galaxy использует resolvelib для разрешения зависимостей. В большинстве случаев для пользователей ничего не изменится, кроме повышения производительности, но мы упоминаем об этом для полноты информации.
  • Если вы импортируете Python module_utils в любые поддерживаемые вами модули, теперь можно пометить импорт как необязательный во время сборки полезной нагрузки модуля, поместив инструкцию import в блок try или if. Это позволяет модулям использовать module_utils, которые могут отсутствовать в некоторых версиях Ansible или коллекции, а также выполнять произвольные действия по восстановлению или резервные действия во время выполнения модуля.

Модули

  • Модуль apt_key явно определяет file как несовместимый с data, keyserver и url. Теперь их нельзя использовать вместе.
  • Модуль meta теперь поддерживает метки для задач, определённых пользователем. Чтобы сохранить прежнее поведение, задайте для задачи метку ‘always’. Внутренние задачи meta по-прежнему выполняются всегда.

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

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

  • Примечательных изменений нет

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

Примечательных изменений нет

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

  • Факты — в NetBSD модуль ansible_virtualization_type теперь пытается сообщить более точный результат, чем xen, если система виртуализирована и не работает на Xen.
  • Факты виртуализации теперь содержат ключи virtualization_tech_guest и virtualization_tech_host. Это списки технологий виртуализации, частью которых является гостевая система или которые предоставляет хост, соответственно. Например, если настроить хост для работы с KVM и VirtualBox, оба значения будут включены в virtualization_tech_host. Аналогично, контейнер podman, запущенный на виртуальной машине под управлением KVM, имеет значение ["kvm", "podman", "container"] для virtualization_tech_guest.
  • Тип параметра filter в модуле setup изменён с string на list, чтобы можно было использовать несколько фильтров. Прежнее поведение (с использованием string) сохранено и работает как один фильтр.

Плагины

  • Плагины инвентаризации — CachePluginAdjudicator.flush() теперь вызывает flush() базового плагина кэша, а не только удаляет известные ему ключи. Для удаления определённых ключей плагины инвентаризации должны использовать delete(). Для пользователя это означает, что при вызове плагином инвентаризации метода clear_cache() из кэша также могут быть удалены факты. Чтобы избежать этого, можно настроить плагины инвентаризации на использование серверной части кэша, независимой от кэша фактов.
  • Плагины обратного вызова — выполнение задач meta теперь передаётся в v2_playbook_on_task_start, как и выполнение любых других задач. По умолчанию туда передаются только явно заданные задачи meta. Плагины обратного вызова могут включить получение внутренних неявно созданных задач, чтобы обрабатывать и их, как указано в документации по разработке плагинов.
  • Теперь выполняется проверка choices, поэтому плагины, в которых были указаны неверные или неполные варианты, вызывают ошибку в версии 2.11, если переданное значение не соответствует им. Исправить это просто: обновите записи в choices в соответствии с реальными значениями.

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

Примечательных изменений нет

Руководство по переносу для v4.10.0

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

containers.podman

  • Добавлен модуль podman_tag
  • Добавлена поддержка драйвера секретов и параметров драйвера

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

cisco.nxos

  • Модуль nxos_snmp_community объявлен устаревшим.
  • Модуль nxos_snmp_contact объявлен устаревшим.
  • Модуль nxos_snmp_host объявлен устаревшим.
  • Модуль nxos_snmp_location объявлен устаревшим.
  • Модуль nxos_snmp_traps объявлен устаревшим.
  • Модуль nxos_snmp_user объявлен устаревшим.

junipernetworks.junos

  • Параметр ‘router_id’ объявлен устаревшим в ресурсных модулях junos_ospf_interfaces, junos_ospfv2 и junos_ospfv3.

Руководство по переносу для v4.9.0

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

purestorage.flashblade

  • purefb_lag — поле mac_address в ответе не заполняется. Это будет исправлено в одном из будущих обновлений FlashBlade.

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

fortinet.fortios

  • В раздел примеров некоторых модулей конфигурации добавлены примеры использования в реальных условиях.
  • Сбор текущих конфигураций модулей и преобразование их в плейбуки.
  • Добавлена поддержка FortiOS 7.0.1.
  • Добавлена поддержка операций с элементами (удаление и добавление дополнительных элементов) для объектов со списком элементов.
  • Добавлена поддержка функции селекторов в fortios_monitor_fact и fortios_log_fact.

Руководство по переносу для v4.8.0

Критические изменения

community.zabbix

  • Теперь все роли ссылаются на другие роли и модули, используя их полные имена коллекций, поэтому минимальной поддерживаемой версией Ansible для ролей становится 2.10 (см. задачу 477).

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

community.azure

  • Все модули community.azure.azure_rm_<resource>_facts объявлены устаревшими. Вместо них используйте модули azure.azcollection.azure_rm_<resource>_info (https://github.com/ansible-collections/community.azure/pull/24).
  • Все модули community.azure.azure_rm_<resource>_info объявлены устаревшими. Вместо них используйте модули azure.azcollection.azure_rm_<resource>_info (https://github.com/ansible-collections/community.azure/pull/24).
  • community.azure.azure_rm_managed_disk и community.azure.azure_rm_manageddisk объявлены устаревшими. Вместо них используйте azure.azcollection.azure_rm_manageddisk (https://github.com/ansible-collections/community.azure/pull/24).
  • community.azure.azure_rm_virtualmachine_extension и community.azure.azure_rm_virtualmachineextension объявлены устаревшими. Вместо них используйте azure.azcollection.azure_rm_virtualmachineextension (https://github.com/ansible-collections/community.azure/pull/24).
  • community.azure.azure_rm_virtualmachine_scaleset и community.azure.azure_rm_virtualmachinescaleset объявлены устаревшими. Вместо них используйте azure.azcollection.azure_rm_virtualmachinescaleset (https://github.com/ansible-collections/community.azure/pull/24).

community.hashi_vault

  • lookup hashi_vault — раздел [lookup_hashi_vault] в файле ansible.cfg объявлен устаревшим и будет удалён в версии коллекции 3.0.0. Вместо него можно использовать раздел [hashi_vault_collection], который в дальнейшем будет применяться ко всем плагинам коллекции (https://github.com/ansible-collections/community.hashi_vault/pull/144).

Руководство по переносу для v4.7.0

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

openvswitch.openvswitch

  • По ошибке репозиторию присвоили тег 2.0.0. Поскольку это не планировалось и отменить это невозможно, выпускается версия 2.0.1, чтобы сообщить сообществу о переходе на новую основную версию.

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

cisco.ios

  • Модули ios_ntp объявлены устаревшими.

cisco.nxos

  • Модули nxos_ntp, nxos_ntp_options, nxos_ntp_auth объявлены устаревшими.

community.vmware

  • vmware_guest_vnc — в Sphere 7.0 встроенный VNC-сервер удалён (https://docs.vmware.com/en/VMware-vSphere/7.0/rn/vsphere-esxi-vcenter-server-70-release-notes.html#productsupport).

junipernetworks.junos

  • Параметр router_id объявлен устаревшим в ресурсном модуле ospfv2.

Руководство по переносу для v4.6.0

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

containers.podman

  • Добавлена генерация systemd для подов
  • Добавлена генерация файлов служб systemd для контейнеров

gluster.gluster

  • Включение client.ssl,server.ssl перед запуском тома gluster (https://github.com/gluster/gluster-ansible-collection/pull/19)

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

community.grafana

  • lookup grafana_dashboard — предоставление преобразованной версии ключа API больше не рекомендуется.

Руководство по переносу для v4.5.0

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

hetzner.hcloud

  • Добавлены группы размещения

ovirt.ovirt

  • remove_stale_lun — добавлена роль для удаления устаревших LUN (https://bugzilla.redhat.com/1966873).

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

ansible.netcommon

  • network_cli — параметр paramiko_ssh look_for_keys автоматически задавался на основе значений параметров password и private_key_file, переданных в network_cli. Теперь этот параметр можно задать явно; автоматическое задание look_for_keys будет удалено после 2024-01-01 (https://github.com/ansible-collections/ansible.netcommon/pull/271).

cisco.ios

  • ios_bgp объявлен устаревшим; вместо него используйте ios_bgp_global и ios_bgp_address_family.
  • Удалено тестирование с provider для заданий интеграции ansible-test. Это поможет подготовиться к переходу на интеграционные тесты network-ee.

junipernetworks.junos

  • Параметр router_id объявлен устаревшим в ресурсном модуле ospfv3.

Руководство по переносу для v4.4.0

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

dellemc.openmanage

  • idrac_user — проблема (192043): модуль может завершиться с ошибкой и сообщением unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress. Дождитесь завершения задания и запустите задачу повторно.

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

cisco.iosxr

  • Модуль iosxr_logging объявлен устаревшим; вместо него рекомендуется новый ресурсный модуль iosxr_logging_global. Модуль будет удалён в выпуске после ‘2023-08-01’.

cisco.nxos

  • Модуль nxos_logging объявлен устаревшим; вместо него рекомендуется новый ресурсный модуль nxos_logging_global. Модуль будет удалён в выпуске после ‘2023-08-01’.

community.docker

  • docker_container — значение по умолчанию нового command_handling, compatibility, объявлено устаревшим и изменится на correct в community.docker 3.0.0. Если поведение изменится, модуль выдаст предупреждение об устаревании. Обратите внимание: ansible-core выводит такое предупреждение только один раз, поэтому, если оно появилось для более ранней задачи, другие задачи с этим предупреждением могут остаться без него (https://github.com/ansible-collections/community.docker/pull/186).

junipernetworks.junos

  • Модуль junos_logging объявлен устаревшим; вместо него рекомендуется новый ресурсный модуль junos_logging_global. Модуль будет удалён в выпуске после ‘2023-08-01’.

vyos.vyos

  • Модуль vyos_logging объявлен устаревшим; вместо него рекомендуется новый ресурсный модуль vyos_logging_global. Модуль будет удалён в выпуске после “2023-08-01”.

Руководство по переносу для v4.3.0

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

netapp.cloudmanager

  • Добавлена тестовая среда во все модули cloudmanager

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

community.hashi_vault

  • Коллекция hashi_vault — поддержка Python 3.5 будет прекращена в версии 2.0.0 для community.hashi_vault (https://github.com/ansible-collections/community.hashi_vault/issues/81).

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

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

dellemc.openmanage

  • idrac_user — проблема (192043). Модуль может завершиться с ошибкой и вывести сообщение unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress. Дождитесь завершения задания и запустите задачу снова.
  • ome_smart_fabric_uplink — проблема (186024). Модуль ome_smart_fabric_uplink не позволяет создавать несколько восходящих каналов с одинаковым именем, хотя OpenManage Enterprise Modular поддерживает эту возможность. Если восходящий канал создан с именем, совпадающим с именем существующего канала, существующий канал будет изменен.

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

community.vmware

  • vmware_object_custom_attributes_info — добавлен новый модуль для сбора пользовательских атрибутов объекта (https://github.com/ansible-collections/community.vmware/pull/851).

dellemc.openmanage

  • idrac_server_config_profile — добавлена поддержка экспорта и импорта профиля конфигурации сервера через ресурс HTTP/HTTPS.
  • ome_device_group — добавлена поддержка добавления устройств в группу с использованием IP-адресов устройств и идентификатора группы.

fortinet.fortios

  • Добавлен новый модуль fortios_monitor_fact.
  • Добавлена поддержка Fortios 7.0.
  • Добавлена поддержка API журналов.

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

  • Коллекция community.kubernetes переименовывается в kubernetes.core. В Ansible 5 коллекция community.kubernetes будет заменена пустой коллекцией, в которой для всего текущего содержимого будут настроены устаревшие перенаправления на kubernetes.core. Если вы используете FQCN, начинающиеся с community.kubernetes., обновите их до kubernetes.core. уже сейчас. Обратите внимание, что kubernetes.core входит в состав Ansible начиная с версии Ansible 3.0.0 (https://github.com/ansible-community/community-topics/issues/22).

ansible.windows

  • win_updates — возвращаемое значение filtered_reason для каждого отфильтрованного обновления признано устаревшим; вместо него следует использовать filtered_reasons. Это изменение позволяет показывать все причины фильтрации обновления, а не только первую.
  • win_updates — параметр use_scheduled_task признан устаревшим, поскольку больше не используется.
  • win_updates — параметры whitelist и blacklist признаны устаревшими; вместо них следует использовать соответственно accept_list и reject_list, чтобы соответствовать новым стандартам Ansible для параметров такого типа.

community.general

  • ali_instance_info — отмечена версия удаления устаревших параметров availability_zone и instance_names (https://github.com/ansible-collections/community.general/issues/2429).
  • serverless — параметр functions признан устаревшим, поскольку он не использовался в коде (https://github.com/ansible-collections/community.general/pull/2845).

community.hashi_vault

  • Коллекция hashi_vault — поддержка Python 2 будет прекращена в версии 2.0.0 коллекции community.hashi_vault (https://github.com/ansible-collections/community.hashi_vault/issues/81).

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

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

dellemc.openmanage

  • idrac_user — проблема (192043). Модуль может завершиться с ошибкой и вывести сообщение unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress. Дождитесь завершения задания и запустите задачу снова.
  • ome_smart_fabric_uplink — проблема (186024). Модуль ome_smart_fabric_uplink не позволяет создавать несколько восходящих каналов с одинаковым именем, хотя OpenManage Enterprise Modular поддерживает эту возможность. Если восходящий канал создан с именем, совпадающим с именем существующего канала, существующий канал будет изменен.

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

cloudscale_ch.cloud

  • Добавлен модуль custom_image

community.postgresql

  • postgresql_query — значение параметра as_single_query по умолчанию будет изменено на yes в community.postgresql 2.0.0 (https://github.com/ansible-collections/community.postgresql/issues/85).

dellemc.openmanage

  • ome_firmware_baseline — модуль поддерживает режим проверки и позволяет изменять и удалять базовые версии микропрограмм.
  • ome_firmware_catalog — модуль поддерживает режим проверки и позволяет изменять и удалять каталоги микропрограмм.

fortinet.fortios

  • Улучшен fortios_configuration_fact: теперь можно одновременно использовать несколько селекторов.
  • Добавлена поддержка check_mode во всех модулях на основе cofigurationAPI.
  • Добавлена поддержка фильтрации в модулях сбора фактов fortios_configuration_fact и fortios_monitor_fact.
  • Добавлена поддержка перемещения политики в firewall_central_snat_map.
  • Унифицированы схемы для API мониторинга.

netbox.netbox

  • packages теперь является обязательным пакетом Python и устанавливается через Ansible 2.10+.

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

ansible.windows

  • win_reboot — удалены shutdown_timeout и shutdown_timeout_sec, которые не выполняли никаких действий начиная с Ansible 2.5.

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

ansible.windows

  • win_reboot — недоступные узлы можно игнорировать с помощью ignore_errors: True; эта возможность будет удалена в будущей версии. Вместо этого используйте ignore_unreachable: True, чтобы игнорировать недоступные узлы. — https://github.com/ansible-collections/ansible.windows/issues/62

community.docker

  • Модули и плагины docker_*, за исключением плагина подключения docker_swarm и docker_compose, а также docker_stack*` modules - the current default ``localhost для tls_hostname, признаны устаревшими. В community.docker 2.0.0 это значение будет вычисляться на основе docker_host (https://github.com/ansible-collections/community.docker/pull/134).

community.general

  • Все скрипты инвентаризации и хранилища будут удалены из community.general в версии 4.0.0. Если вы ссылаетесь на них, обновите ссылки на новый репозиторий contrib-scripts на GitHub, чтобы рабочий процесс не нарушился после выпуска community.general 4.0.0 (https://github.com/ansible-collections/community.general/pull/2697).
  • Модули подстановки nios, nios_next_ip и nios_next_network, фрагмент документации nios, а также модули nios_host_record, nios_ptr_record, nios_mx_record, nios_fixed_address, nios_zone, nios_member, nios_a_record, nios_aaaa_record, nios_network, nios_dns_view, nios_txt_record, nios_naptr_record, nios_srv_record, nios_cname_record, nios_nsgroup и nios_network_view признаны устаревшими и будут удалены из community.general 5.0.0. Вместо них установите коллекцию infoblox.nios_modules и используйте ее плагины и модули (https://github.com/ansible-collections/community.general/pull/2458).
  • Встроенная копия ipaddress будет удалена в community.general 4.0.0. Если ваш код использует встроенную версию ipaddress, перейдите на ipaddress из стандартной библиотеки Python 3 или установите ее из pypi (https://github.com/ansible-collections/community.general/pull/2459).
  • linode — параметр backupsenabled признан устаревшим и будет удален в community.general 5.0.0 (https://github.com/ansible-collections/community.general/pull/2410).
  • Плагин инвентаризации lxd — начиная с community.general 4.0.0 при использовании Python 2 плагин потребует установленный пакет ipaddress. ipaddress входит в стандартную библиотеку Python 3, но для Python 2 его можно установить из pypi (https://github.com/ansible-collections/community.general/pull/2459).
  • scaleway_security_group_rule — начиная с community.general 4.0.0 при использовании Python 2 модулю потребуется установленный пакет ipaddress. ipaddress входит в стандартную библиотеку Python 3, но для Python 2 его можно установить из pypi (https://github.com/ansible-collections/community.general/pull/2459).

inspur.sm

  • add_ad_group — эта функция будет удалена в inspur.sm.add_ad_group 3.0.0. Вместо нее используйте inspur.sm.ad_group.
  • add_ldap_group — эта функция будет удалена в inspur.sm.add_ldap_group 3.0.0. Вместо нее используйте inspur.sm.ldap_group.
  • add_user — эта функция будет удалена в inspur.sm.add_user 3.0.0. Вместо нее используйте inspur.sm.user.
  • add_user_group — эта функция будет удалена в inspur.sm.add_user_group 3.0.0. Вместо нее используйте inspur.sm.user_group.
  • del_ad_group — эта функция будет удалена в inspur.sm.del_ad_group 3.0.0. Вместо нее используйте inspur.sm.ad_group.
  • del_ldap_group — эта функция будет удалена в inspur.sm.del_ldap_group 3.0.0. Вместо нее используйте inspur.sm.ldap_group.
  • del_user — эта функция будет удалена в inspur.sm.del_user 3.0.0. Вместо нее используйте inspur.sm.user.
  • del_user_group — эта функция будет удалена в inspur.sm.del_user_group 3.0.0. Вместо нее используйте inspur.sm.user_group.
  • edit_ad_group — эта функция будет удалена в inspur.sm.edit_ad_group 3.0.0. Вместо нее используйте inspur.sm.ad_group.
  • edit_ldap_group — эта функция будет удалена в inspur.sm.edit_ldap_group 3.0.0. Вместо нее используйте inspur.sm.ldap_group.
  • edit_user — эта функция будет удалена в inspur.sm.edit_user 3.0.0. Вместо нее используйте inspur.sm.user.
  • edit_user_group — эта функция будет удалена в inspur.sm.edit_user_group 3.0.0. Вместо нее используйте inspur.sm.user_group.

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

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

Ansible-core

  • ansible-test — проверка sanity pylint больше не выявляет корректно «плохие» имена переменных, не являющихся константами. Дополнительные сведения см. в issue 3701.

dellemc.openmanage

  • idrac_user — проблема (192043). Модуль может завершиться с ошибкой и вывести сообщение unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress. Дождитесь завершения задания и запустите задачу снова.
  • ome_configuration_compliance_info — проблема (195592). Модуль может завершиться с ошибкой и вывести сообщение unable to process the request because an error occurred. Если проблема не исчезнет, сообщите о ней системному администратору.
  • ome_smart_fabric — проблема (185322). OpenManage Enterprise Modular поддерживает только три типа структуры, однако модуль успешно создает структуру, даже если указанный тип не поддерживается.
  • ome_smart_fabric_uplink — проблема (186024). Модуль ome_smart_fabric_uplink не позволяет создавать несколько восходящих каналов с одинаковым именем, хотя OpenManage Enterprise Modular поддерживает эту возможность. Если восходящий канал создан с именем, совпадающим с именем существующего канала, существующий канал будет изменен.

fortinet.fortios

  • Версии модулей для API мониторинга пока не указываются.

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

Ansible-core

  • Коллекции SCM теперь переустанавливаются независимо от наличия --force.
  • Факты виртуализации NetBSD (в частности, ansible_virtualization_type) теперь возвращают более точное значение, проверяя значение ключа machdep.hypervisor sysctl. Это изменение нарушает обратную совместимость, поскольку ранее в некоторых случаях мы ошибочно сообщали xen, даже если целевая система не работала на Xen. Это позволяет избежать такого поведения в большинстве случаев. (https://github.com/ansible/ansible/issues/69352)
  • Встроенный механизм разрешения зависимостей заменен внешней реализацией, которую pip >= 20.3 теперь использует по умолчанию, — resolvelib. (https://github.com/ansible/ansible/issues/71784)
  • Модуль meta теперь поддерживает теги для задач, определенных пользователем. Внутренние задачи meta по-прежнему выполняются всегда. (https://github.com/ansible/ansible/issues/64558)
  • Команда ansible-galaxy login удалена (см. issue 71560).

ansible.netcommon

  • Из netconf_config удалены устаревшие аргументы подключения.

community.docker

  • docker_swarm — если указан join_token, возвращаемый токен присоединения с тем же значением будет заменен на VALUE_SPECIFIED_IN_NO_LOG_PARAMETER. Не используйте вслепую токены присоединения из возвращаемого значения этого модуля, если модуль вызван с указанным join_token! Это несовместимое изменение включено в минорный выпуск, поскольку оно необходимо для устранения проблемы безопасности (https://github.com/ansible-collections/community.docker/pull/103).

community.general

  • Если вы используете Ansible 2.9 и плагины или модули из этой коллекции, community.general 3.0.0 вызовет ошибки при попытке использовать содержимое DellEMC через FQCN, например community.general.idrac_firmware. Поскольку Ansible 2.9 не поддерживает перенаправления, необходимо вручную изменить плейбуки и роли, заменив FQCN на новые (в приведенном выше примере — dellemc.openmanage.idrac_firmware) и убедившись, что у вас установлен dellemc.openmanage.

    Если вы используете ansible-base 2.10 или более новую версию, не устанавливали Ansible 4.0.0, но установили и/или обновили community.general вручную, убедитесь, что установлена также коллекция dellemc.openmanage, если вы используете какие-либо из этих плагинов или модулей. Хотя ansible-base 2.10 и более новые версии могут использовать перенаправления, добавленные в community.general 3.0.0, целевая коллекция (например, dellemc.openmanage) должна быть установлена, чтобы перенаправления работали.

  • gitlab_deploy_key — если для уже существующего ключа передавался другой открытый ключ, ничего не происходило. Теперь открытый ключ обновляется до нового значения (https://github.com/ansible-collections/community.general/pull/1661).
  • java_keystore — теперь хранилище ключей перезаписывается при изменении псевдонима (имени), а не происходит ошибка. Такое поведение изначально было предусмотрено, но не работало из-за логической ошибки. Убедитесь, что ваши плейбуки и роли не зависят от старого поведения, при котором вместо перезаписи возникала ошибка (https://github.com/ansible-collections/community.general/issues/1671).
  • java_keystore — теперь хранилище ключей перезаписывается при изменении парольной фразы, а не происходит ошибка. Убедитесь, что ваши плейбуки и роли не зависят от старого поведения, при котором вместо перезаписи возникала ошибка (https://github.com/ansible-collections/community.general/issues/1671).
  • one_image — используется pyone вместо python-oca (https://github.com/ansible-collections/community.general/pull/2032).
  • utm_proxy_auth_profile — возвращаемое значение frontend_cookie_secret теперь содержит строку-заполнитель вместо параметра модуля frontend_cookie_secret (https://github.com/ansible-collections/community.general/pull/1736).

fortinet.fortios

  • Универсальный модуль FortiOS — модуль FOS для выполнения универсальных запросов с помощью Ansible.
  • Поддержка API мониторинга FOS — добавлено несколько новых модулей для API мониторинга.
  • Унифицированная коллекция — сама коллекция fortios будет адаптирована для любых платформ FOS.

servicenow.servicenow

  • Поле auth теперь обязательно для всех методов аутентификации, кроме Basic.

theforeman.foreman

  • Теперь ко всем переменным ролей добавлен префикс foreman_, чтобы избежать конфликтов с переменными с такими же именами из ролей, не входящих в эту коллекцию.

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

Ansible-core

  • Коллекцию можно переустановить с новыми требованиями к версии, не используя флаг --force. При необходимости зависимости коллекции также будут обновлены в соответствии с новыми требованиями. Чтобы принудительно обновить транзитивные зависимости, используйте --upgrade.
  • AnsibleModule — для проверки спецификации аргументов используется класс ArgumentSpecValidator, а закрытые методы, связанные с проверкой спецификации аргументов, удалены. Теперь модулям, использующим закрытые методы, следует использовать класс ArgumentSpecValidator или соответствующую функцию проверки.
  • resolvelib >= 0.5.3, < 0.6.0 объявлен прямой зависимостью ansible-core. Ссылки: — https://github.com/sarugaku/resolvelib — https://pypi.org/p/resolvelib — https://pradyunsg.me/blog/2020/03/27/pip-resolver-testing
  • Стала доступна установка коллекций Ansible из локальных папок и папок пространств имен, имеющих структуру SCM с несколькими коллекциями.
  • Стало возможно обновлять коллекции Ansible с серверов Galaxy с помощью параметра --upgrade вместе с ansible-galaxy collection install.
  • Добавлена поддержка проверки спецификации аргументов роли во время ее выполнения. Если роль содержит спецификацию аргументов, в начало выполнения роли автоматически вставляется задача проверки.
  • Добавлен класс ArgumentSpecValidator для проверки параметров по спецификации аргументов вне AnsibleModule (https://github.com/ansible/ansible/pull/73335)
  • ansible-test — тесты, выполняемые в тестовых контейнерах centos6 и default, теперь используют контейнер прокси PyPI для доступа к PyPI при использовании Python 2.6. Это позволяет тестам на Python 2.6 продолжать работу, несмотря на прекращение PyPI поддержки клиентов без SNI.

ansible.netcommon

  • Из netconf_config удалены устаревшие аргументы подключения.

arista.eos

  • Для поддержки ansible_network_single_user_mode и ansible_network_import_modules требуется ansible.netcommon версии 2.0.0 или новее. Подробнее см. в журнале изменений ansible.netcommon.

cisco.asa

  • Подробнее см. в changelog <https://github.com/ansible-collections/ansible.netcommon/blob/main/changelogs/CHANGELOG.rst#ansible-netcommon-collection-release-notes> ansible.netcommon.
  • Для поддержки ansible_network_single_user_mode и ansible_network_import_modules требуется ansible.netcommon версии 2.0.0 или новее.

cisco.ios

  • Подробнее см. в журнале изменений ansible.netcommon.
  • Для поддержки ansible_network_single_user_mode и ansible_network_import_modules требуется ansible.netcommon версии 2.0.0 или новее.

cisco.iosxr

  • Подробнее см. в журнале изменений ansible.netcommon.
  • Для поддержки ansible_network_single_user_mode и ansible_network_import_modules требуется ansible.netcommon версии 2.0.0 или новее.
  • ipaddress больше не входит в ansible.netcommon. Для версий Python без ipaddress (< 3.0) теперь требуется пакет ipaddress.

cisco.nxos

  • Подробнее см. в журнале изменений ansible.netcommon.
  • Для поддержки ansible_network_single_user_mode и ansible_network_import_modules требуется ansible.netcommon версии 2.0.0 или новее.

community.grafana

  • В модули grafana_teams и grafana_folder добавлен параметр “skip_version_check” (#147)

community.mysql

  • mysql_replication — добавлено предупреждение об устаревании: возвращаемые значения Is_Slave и Is_Master будут заменены на Is_Primary и Is_Replica в community.mysql 3.0.0 (https://github.com/ansible-collections/community.mysql/pull/147).
  • mysql_replication — варианты параметра state, содержащие master, будут окончательно заменены альтернативными вариантами primary в community.mysql 3.0.0; добавлены предупреждения об устаревании (https://github.com/ansible-collections/community.mysql/pull/150).
  • mysql_replication — значения параметров режима getslave, startslave, stopslave, resetslave и resetslaveall` and the master_use_gtid option ``slave_pos признаны устаревшими (см. альтернативные значения) и будут удалены в community.mysql 3.0.0 (https://github.com/ansible-collections/community.mysql/pull/97).
  • mysql_replication — возвращаемые значения Is_Slave и Is_Master будут заменены на Is_Replica и Is_Primary в community.mysql 3.0.0 (https://github.com/ansible-collections/community.mysql/issues/145).
  • mysql_replication — слово SLAVE в сообщениях, возвращаемых модулем, будет заменено на REPLICA в community.mysql 2.0.0 (https://github.com/ansible-collections/community.mysql/issues/98).
  • mysql_replication — слово master в сообщениях, возвращаемых модулем, будет заменено на primary в community.mysql 3.0.0 (https://github.com/ansible-collections/community.mysql/issues/145).
  • mysql_replication — слово slave в сообщениях, возвращаемых модулем, заменено на replica (https://github.com/ansible-collections/community.mysql/issues/98).
  • mysql_user — REQUIRESSL является псевдонимом ключа ssl параметра tls_requires в community.mysql 2.0.0; поддержка будет полностью прекращена в community.mysql 3.0.0 (https://github.com/ansible-collections/community.mysql/issues/121).

fortinet.fortios

  • Добавлен новый модуль fortios_configuration_fact
  • Добавлен новый модуль fortios_json_generic
  • Добавлен новый модуль fortios_monitor
  • Добавлен новый модуль fortios_monitor_fact

junipernetworks.junos

  • Подробнее см. в журнале изменений ansible.netcommon.
  • Для поддержки ansible_network_single_user_mode и ansible_network_import_modules требуется ansible.netcommon версии 2.0.0 или новее.

netapp.ontap

  • na_ontap_autosupport — в модуль добавлена поддержка REST.

openvswitch.openvswitch

  • В этом выпуске нет существенных изменений; тег был добавлен по ошибке, и его невозможно отменить.

servicenow.servicenow

  • Клиент переработан: теперь он наследуется от AnsibleModule.
  • Добавлена поддержка протокола аутентификации OpenID Connect.
  • Добавлена поддержка токенов носителя для аутентификации.

vyos.vyos

  • Подробнее см. в журнале изменений ansible.netcommon.
  • Для поддержки ansible_network_single_user_mode и ansible_network_import_modules требуется ansible.netcommon версии 2.0.0 или новее.
  • ipaddress больше не входит в ansible.netcommon. Для версий Python без ipaddress (< 3.0) теперь требуется пакет ipaddress.

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

Ansible-core

  • Удалён класс SharedPluginLoaderObj из ansible.plugins.strategy. Он был объявлен устаревшим в пользу использования стандартного загрузчика плагинов.
  • Удалён псевдоним _get_item() из базового класса плагинов обратного вызова, который был объявлен устаревшим в пользу _get_item_label().
  • Параметр «user» ранее был объявлен устаревшим, а теперь удалён в пользу «scope»
  • Устаревший ansible.constants.BECOME_METHODS удалён.
  • Устаревший ansible.constants.get_config() удалён.
  • Устаревший ansible.constants.mk_boolean() удалён.
  • Циклы with_* больше не оптимизируются для модулей, параметры name которых могут принимать списки (в основном это менеджеры пакетов). Вместо перебора отдельных имён с помощью with_items и подобных конструкций используйте name.

community.general

  • Модули ome_device_info, idrac_firmware и idrac_server_config_profile перенесены из community.general в коллекцию Ansible dellemc.openmanage. При использовании ansible-base 2.10 или более новой версии доступны перенаправления.

    Если вы используете Ansible 2.9 и установили эту коллекцию, необходимо изменить полные имена коллекций (FQCN) (community.general.idrac_firmware → dellemc.openmanage.idrac_firmware) и установить коллекцию dellemc.openmanage.

  • Устаревший модуль ali_instance_facts удалён. Используйте вместо него ali_instance_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль gluster_heal_info удалён. Используйте вместо него gluster.gluster.gluster_heal_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль gluster_peer удалён. Используйте вместо него gluster.gluster.gluster_peer (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль gluster_volume удалён. Используйте вместо него gluster.gluster.gluster_volume (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль helm удалён. Используйте вместо него community.kubernetes.helm (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль hpilo_facts удалён. Используйте вместо него hpilo_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль idrac_redfish_facts удалён. Используйте вместо него idrac_redfish_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль jenkins_job_facts удалён. Используйте вместо него jenkins_job_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ldap_attr удалён. Используйте вместо него ldap_attrs (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль memset_memstore_facts удалён. Используйте вместо него memset_memstore_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль memset_server_facts удалён. Используйте вместо него memset_server_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль na_ontap_gather_facts удалён. Используйте вместо него netapp.ontap.na_ontap_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль nginx_status_facts удалён. Используйте вместо него nginx_status_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль one_image_facts удалён. Используйте вместо него one_image_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль onepassword_facts удалён. Используйте вместо него onepassword_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль oneview_datacenter_facts удалён. Используйте вместо него oneview_datacenter_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль oneview_enclosure_facts удалён. Используйте вместо него oneview_enclosure_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль oneview_ethernet_network_facts удалён. Используйте вместо него oneview_ethernet_network_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль oneview_fc_network_facts удалён. Используйте вместо него oneview_fc_network_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль oneview_fcoe_network_facts удалён. Используйте вместо него oneview_fcoe_network_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль oneview_logical_interconnect_group_facts удалён. Используйте вместо него oneview_logical_interconnect_group_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль oneview_network_set_facts удалён. Используйте вместо него oneview_network_set_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль oneview_san_manager_facts удалён. Используйте вместо него oneview_san_manager_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль online_server_facts удалён. Используйте вместо него online_server_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль online_user_facts удалён. Используйте вместо него online_user_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt удалён. Используйте вместо него ovirt.ovirt.ovirt_vm (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_affinity_label_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_affinity_label_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_api_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_api_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_cluster_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_cluster_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_datacenter_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_datacenter_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_disk_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_disk_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_event_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_event_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_external_provider_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_external_provider_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_group_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_group_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_host_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_host_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_host_storage_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_host_storage_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_network_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_network_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_nic_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_nic_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_permission_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_permission_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_quota_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_quota_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_scheduling_policy_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_scheduling_policy_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_snapshot_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_snapshot_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_storage_domain_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_storage_domain_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_storage_template_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_storage_template_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_storage_vm_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_storage_vm_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_tag_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_tag_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_template_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_template_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_user_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_user_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_vm_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_vm_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль ovirt_vmpool_facts удалён. Используйте вместо него ovirt.ovirt.ovirt_vmpool_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль purefa_facts удалён. Используйте вместо него purestorage.flasharray.purefa_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль purefb_facts удалён. Используйте вместо него purestorage.flasharray.purefb_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль python_requirements_facts удалён. Используйте вместо него python_requirements_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль redfish_facts удалён. Используйте вместо него redfish_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль scaleway_image_facts удалён. Используйте вместо него scaleway_image_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль scaleway_ip_facts удалён. Используйте вместо него scaleway_ip_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль scaleway_organization_facts удалён. Используйте вместо него scaleway_organization_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль scaleway_security_group_facts удалён. Используйте вместо него scaleway_security_group_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль scaleway_server_facts удалён. Используйте вместо него scaleway_server_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль scaleway_snapshot_facts удалён. Используйте вместо него scaleway_snapshot_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль scaleway_volume_facts удалён. Используйте вместо него scaleway_volume_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль smartos_image_facts удалён. Используйте вместо него smartos_image_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль vertica_facts удалён. Используйте вместо него vertica_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Устаревший модуль xenserver_guest_facts удалён. Используйте вместо него xenserver_guest_info (https://github.com/ansible-collections/community.general/pull/1924).
  • Фрагмент документации ovirt_facts удалён (https://github.com/ansible-collections/community.general/pull/1924).
  • airbrake_deployment — удалён устаревший параметр token. Вместо него используйте project_id и project_key (https://github.com/ansible-collections/community.general/pull/1926).
  • bigpanda — псевдоним message удалён. Используйте вместо него deployment_message (https://github.com/ansible-collections/community.general/pull/1926).
  • cisco_spark, cisco_webex — псевдоним message удалён. Используйте вместо него msg (https://github.com/ansible-collections/community.general/pull/1926).
  • clc_aa_policy — параметр wait удалён. Он не оказывал никакого влияния (https://github.com/ansible-collections/community.general/pull/1926).
  • datadog_monitor — псевдоним message удалён. Используйте вместо него notification_message (https://github.com/ansible-collections/community.general/pull/1926).
  • django_manage — параметр liveserver удалён (https://github.com/ansible-collections/community.general/pull/1926).
  • idrac_redfish_config — параметры manager_attribute_name и manager_attribute_value удалены. Используйте вместо них manager_attributes (https://github.com/ansible-collections/community.general/pull/1926).
  • iso_extract — псевдоним thirsty удалён. Используйте вместо него force (https://github.com/ansible-collections/community.general/pull/1926).
  • ldap_entry — параметр params полностью удалён. Его использование уже вызывало ошибку начиная с community.general 0.1.2 (https://github.com/ansible-collections/community.general/pull/2257).
  • pulp_repo — для параметра feed_client_cert больше не используется значение параметра client_cert по умолчанию (https://github.com/ansible-collections/community.general/pull/1926).
  • pulp_repo — для параметра feed_client_key больше не используется значение параметра client_key по умолчанию (https://github.com/ansible-collections/community.general/pull/1926).
  • pulp_repo — псевдоним ca_cert удалён. Используйте вместо него feed_ca_cert (https://github.com/ansible-collections/community.general/pull/1926).
  • rax — удалён неиспользуемый параметр service (https://github.com/ansible-collections/community.general/pull/2020).
  • Модули redfish — если имеется более одного целевого ресурса System, Chassis или Manager, больше нельзя выполнять команду изменения данных, не указав его ID. Чтобы указать целевой ID, используйте параметр resource_id (https://github.com/ansible-collections/community.general/pull/1926).
  • redfish_config — параметры bios_attribute_name и bios_attribute_value удалены. Используйте вместо них bios_attributes (https://github.com/ansible-collections/community.general/pull/1926).
  • syspatch — параметр apply удалён. Это режим по умолчанию, поэтому его удаление не изменит поведение (https://github.com/ansible-collections/community.general/pull/1926).
  • xbps — параметр force удалён. Он не оказывал никакого влияния (https://github.com/ansible-collections/community.general/pull/1926).

community.network

  • Устаревшие параметры community.network.ce_sflow: rate_limit, rate_limit_slot и forward_enp_slot удалены (https://github.com/ansible-collections/community.network/pull/255).
  • Устаревший плагин netconf community.network.sros удалён. Используйте вместо него nokia.sros.md (https://github.com/ansible-collections/community.network/pull/255).

f5networks.f5_modules

  • Удалена поддержка TMOS v11 для модулей bigip_gtm_pool и bigip_gtm_wide_ip
  • В модуле bigip_node удалены параметры quorum и monitor_type. См. раздел руководств по переносу на странице https://clouddocs.f5.com/products/orchestration/ansible/devel/usage/porting-guides.html
  • В модуле bigip_log_destination удалены параметры syslog_settings и pool_settings. См. раздел руководств по переносу на странице https://clouddocs.f5.com/products/orchestration/ansible/devel/usage/porting-guides.html

fortinet.fortios

  • Удалён модуль fortios_facts
  • Удалён модуль fortios_registration_forticare
  • Удалён модуль fortios_registration_vdom
  • Удалён модуль fortios_system_config_backup_restore
  • Удалён модуль fortios_system_vmlicense

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

Ansible-core

  • Начиная с версии 2.14, модули shell и command больше не будут предлагать параметр для вывода предупреждений и рекомендаций использовать модули вместо команд. Параметр warn этих модулей объявлен устаревшим и теперь по умолчанию имеет значение False. Аналогичным образом объявлен устаревшим параметр конфигурации COMMAND_WARNINGS, значение которого по умолчанию теперь False. Эти параметры будут удалены, а их наличие в версии 2.14 приведёт к ошибке.
  • apt_key — параметр key не оказывает никакого эффекта, объявлен устаревшим и будет удалён в версии ansible-core 2.14 (https://github.com/ansible/ansible/pull/70319).
  • psrp — минимальная версия pypsrp установлена на уровне 0.4.0.

ansible.netcommon

  • Модуль cli_parse и плагины анализаторов textfsm, ttp, xml и json объявлены устаревшими, поскольку перенесены в коллекцию ansible.utils (https://github.com/ansible-collections/ansible.netcommon/pull/182 https://github.com/ansible-collections/ansible.utils/pull/28)

cisco.nxos

  • Модуль nxos_bgp_af объявлен устаревшим в пользу модуля ресурсов nxos_bgp_address_family.
  • Модуль nxos_bgp_neighbor_af объявлен устаревшим в пользу модуля ресурсов nxos_bgp_neighbor_address_family.

cloudscale_ch.cloud

  • Псевдонимы server_uuids и server_uuid параметра servers модуля volume будут удалены в версии 3.0.0.

community.aws

  • ec2_eip — псевдоним instance_id для device_id официально объявлен устаревшим (https://github.com/ansible-collections/community.aws/pull/349).
  • ec2_vpc_endpoint — параметр policy_file объявлен устаревшим; рекомендуется использовать policy вместе с lookup (https://github.com/ansible-collections/community.aws/pull/366).
  • ec2_vpc_endpoint_info — параметр query объявлен устаревшим и будет удалён после 2022-12-01 (https://github.com/ansible-collections/community.aws/pull/346). Теперь ec2_vpc_endpoint_info по умолчанию выводит сведения о конечных точках. Возможность искать сведения о доступных сервисах перенесена в специальный модуль ec2_vpc_endpoint_service_info.

community.crypto

  • acme module_utils — module_utils acme (ansible_collections.community.crypto.plugins.module_utils.acme) объявлен устаревшим и будет удалён в community.crypto 2.0.0. Вместо него используйте новые модули Python из пакета acme (ansible_collections.community.crypto.plugins.module_utils.acme.xxx) (https://github.com/ansible-collections/community.crypto/pull/184).
  • acme_account_info — при условии retrieve_orders=url_list параметр orders больше не будет возвращаться в community.crypto 2.0.0. Вместо него используйте order_uris (https://github.com/ansible-collections/community.crypto/pull/178).

community.general

  • apt_rpm — недопустимый псевдоним параметра update-cache объявлен устаревшим и будет удалён в версии 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927).
  • composer — недопустимые псевдонимы параметров working-dir, global-command, prefer-source, prefer-dist, no-dev, no-scripts, no-plugins, optimize-autoloader, classmap-authoritative, apcu-autoloader, ignore-platform-reqs объявлены устаревшими и будут удалены в версии 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927).
  • cpanm — параметр system_lib объявлен устаревшим; вместо него используйте become (https://github.com/ansible-collections/community.general/pull/2218).
  • github_deploy_key — недопустимый псевдоним параметра 2fa_token объявлен устаревшим и будет удалён в версии 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927).
  • grove — параметр message будет удалён в community.general 4.0.0. Вместо него используйте новый параметр message_content (https://github.com/ansible-collections/community.general/pull/1929).
  • homebrew — недопустимый псевдоним параметра update-brew объявлен устаревшим и будет удалён в версии 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927).
  • homebrew_cask — недопустимый псевдоним параметра update-brew объявлен устаревшим и будет удалён в версии 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927).
  • opkg — недопустимый псевдоним параметра update-cache объявлен устаревшим и будет удалён в версии 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927).
  • pacman — недопустимый псевдоним параметра update-cache объявлен устаревшим и будет удалён в версии 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927).
  • puppet — недокументированный параметр show_diff объявлен устаревшим и будет удалён в версии 7.0.0. (https://github.com/ansible-collections/community.general/pull/1927).
  • runit — неиспользуемый параметр dist помечен как устаревший (https://github.com/ansible-collections/community.general/pull/1830).
  • slackpkg — недопустимый псевдоним параметра update-cache объявлен устаревшим и будет удалён в версии 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927).
  • urpmi — недопустимые псевдонимы параметров update-cache и no-recommends объявлены устаревшими и будут удалены в версии 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927).
  • xbps — недопустимый псевдоним параметра update-cache объявлен устаревшим и будет удалён в версии 5.0.0 (https://github.com/ansible-collections/community.general/pull/1927).
  • xfconf — возврат вывода в виде фактов объявлен устаревшим; эта возможность будет удалена в community.general 4.0.0. Зарегистрируйте вывод задачи в переменной и используйте её вместо этого. Уже сейчас можно перейти на новое поведение, используя новый параметр disable_facts (https://github.com/ansible-collections/community.general/pull/1747).

community.vmware

  • vmware_vmkernel_ip_config объявлен устаревшим в пользу vmware_vmkernel (https://github.com/ansible-collections/community.vmware/pull/667).

f5networks.f5_modules

  • Поддержка версий Python ниже 3.5 объявляется устаревшей.

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

Spec-Zone.ru

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