Spec-Zone.ru › Ansible

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

  • Плейбук
  • Командная строка
  • Устаревшие элементы
  • Изменения, требующие переработки

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

    • Удаленные модули
    • Уведомления об устаревании
    • Заметные изменения в модулях
  • Плагины
  • Перенос пользовательских скриптов
  • Руководство по переносу для версии 4.10.0

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

    • Известные проблемы
    • Основные изменения
  • Руководство по переносу для версии 4.8.0

    • Изменения, требующие переработки
    • Устаревшие функции
  • Руководство по переносу для версии 4.7.0

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

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

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

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

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

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

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

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

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

Плейбук

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

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

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

Устаревшие элементы

Постоянная ansible.module_utils.basic._CHECK_ARGUMENT_TYPES_DISPATCHER устарела. Используйте ansible.module_utils.common.parameters.DEFAULT_TYPE_VALIDATORS вместо этого.

END_OF_DOCUMENT_MARKER

Изменения, требующие переписывания кода

Изменения в 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, вам необходимо pip uninstall ansible или pip uninstall ansible-base перед установкой ansible-core, чтобы избежать конфликтов.
  • 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 задачи по-прежнему всегда выполняются.

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

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

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

Замечания о устаревших элементах

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

Примечательные изменения в модулях

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

Плагины

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

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

Нет заметных изменений

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

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

containers.podman

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

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

cisco.nxos

  • Модуль nxos_snmp_community устарел.
  • Модуль nxos_snmp_contact устарел.
  • Модуль nxos_snmp_host устарел.
  • Модуль nxos_snmp_location устарел.
  • Модуль nxos_snmp_traps устарел.
  • Модуль nxos_snmp_user устарел.

junipernetworks.junos

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

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

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

purestorage.flashblade

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

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

fortinet.fortios

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

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

Изменения, требующие переноса

community.zabbix

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

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

community.azure

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

community.hashi_vault

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

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

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

openvswitch.openvswitch

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

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

cisco.ios

  • Модули ios_ntp устарели.

cisco.nxos

  • Модули nxos_ntp, nxos_ntp_options, nxos_ntp_auth устарели.

community.vmware

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

junipernetworks.junos

  • Параметр router_id в модуле ospfv2 устарел.

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

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

containers.podman

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

gluster.gluster

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

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

community.grafana

  • lookup grafana_dashboard - Предоставление искажённой версии API-ключа больше не предпочтительно.

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

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

hetzner.hcloud

  • Введение групп размещения

ovirt.ovirt

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

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

ansible.netcommon

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

cisco.ios

  • Модуль ios_bgp устарел в пользу ios_bgp_global и ios_bgp_address_family.
  • Удаление тестирования с поставщиком для задач интеграции ansible-test. Это помогает подготовиться к переходу на интеграционные тесты network-ee.

junipernetworks.junos

  • Параметр router_id в модуле ospfv3 устарел.
END_OF_DOCUMENT_MARKER

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

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

dellemc.openmanage

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

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

cisco.iosxr

  • Модуль iosxr_logging устарел и заменён новым модулем ресурса iosxr_logging_global. Он будет удалён в выпуске после ‘2023-08-01’.

cisco.nxos

  • Модуль nxos_logging устарел и заменён новым модулем ресурса nxos_logging_global. Он будет удалён в выпуске после ‘2023-08-01’.

community.docker

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

junipernetworks.junos

  • Модуль junos_logging устарел и заменён новым модулем ресурса junos_logging_global. Он будет удалён в выпуске после ‘2023-08-01’.

vyos.vyos

  • Модуль vyos_logging устарел и заменён новым модулем ресурса vyos_logging_global. Он будет удалён в выпуске после “2023-08-01”.

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

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

netapp.cloudmanager

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

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

community.hashi_vault

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

Руководство по портированию для v4.2.0

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

dellemc.openmanage

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

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

community.vmware

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

dellemc.openmanage

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

fortinet.fortios

  • Новый модуль fortios_monitor_fact.
  • Поддержка Fortios 7.0.
  • Поддержка API-интерфейсов протокола логирования.

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

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

ansible.windows

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

community.general

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

community.hashi_vault

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

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

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

dellemc.openmanage

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

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

cloudscale_ch.cloud

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

community.postgresql

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

dellemc.openmanage

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

fortinet.fortios

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

netbox.netbox

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

Удаленные возможности

ansible.windows

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

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

ansible.windows

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

community.docker

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

community.general

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

inspur.sm

  • add_ad_group - Эта функция будет удалена в inspur.sm.add_ad_group 3.0.0. Заменено на inspur.sm.ad_group.
  • add_ldap_group - Эта функция будет удалена в inspur.sm.add_ldap_group 3.0.0. Заменено на inspur.sm.ldap_group.
  • add_user - Эта функция будет удалена в inspur.sm.add_user 3.0.0. Заменено на inspur.sm.user.
  • add_user_group - Эта функция будет удалена в inspur.sm.add_user_group 3.0.0. Заменено на inspur.sm.user_group.
  • del_ad_group - Эта функция будет удалена в inspur.sm.del_ad_group 3.0.0. Заменено на inspur.sm.ad_group.
  • del_ldap_group - Эта функция будет удалена в inspur.sm.del_ldap_group 3.0.0. Заменено на inspur.sm.ldap_group.
  • del_user - Эта функция будет удалена в inspur.sm.del_user 3.0.0. Заменено на inspur.sm.user.
  • del_user_group - Эта функция будет удалена в inspur.sm.del_user_group 3.0.0. Заменено на inspur.sm.user_group.
  • edit_ad_group - Эта функция будет удалена в inspur.sm.edit_ad_group 3.0.0. Заменено на inspur.sm.ad_group.
  • edit_ldap_group - Эта функция будет удалена в inspur.sm.edit_ldap_group 3.0.0. Заменено на inspur.sm.ldap_group.
  • edit_user - Эта функция будет удалена в inspur.sm.edit_user 3.0.0. Заменено на inspur.sm.user.
  • edit_user_group - Эта функция будет удалена в inspur.sm.edit_user_group 3.0.0. Заменено на inspur.sm.user_group.

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

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

Ansible-core

  • ansible-test - Тест pylint целостности больше не правильно обнаруживает «плохие» имена переменных для не-констант. См. проблему 3701 для получения дополнительной информации.

dellemc.openmanage

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

fortinet.fortios

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

Изменения, требующие переработки

Ansible-core

  • Сделаны коллекции SCM, которые будут переустанавливаться независимо от наличия --force.
  • Факты виртуализации NetBSD (в частности, ansible_virtualization_type) теперь возвращают более точное значение, проверяя значение ключа machdep.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 была удалена (см. проблему 71560)

ansible.netcommon

  • Удален пакет ipaddress из коллекции. Если вы используете ansible_collections.ansible.netcommon.plugins.module_utils.compat.ipaddress в своей коллекции, вам необходимо изменить это на импорт ipaddress вместо него. Если ваш контент, использующий ipaddress, поддерживает Python 2.7, вам также необходимо убедиться, что у пользователя установлен пакет ipaddress. Обратитесь к https://docs.ansible.com/ansible/latest/dev_guide/developing_modules_best_practices.html#importing-and-using-shared-code, чтобы узнать, как безопасно импортировать внешние пакеты, которые могут отсутствовать на системе пользователя. Бэкпорт ipaddress для Python 2.7 доступен по адресу https://pypi.org/project/ipaddress/

community.docker

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

community.general

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

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

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

fortinet.fortios

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

servicenow.servicenow

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

theforeman.foreman

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

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

Ansible-core

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

ansible.netcommon

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

arista.eos

  • Требуется ansible.netcommon v2.0.0+ для поддержки ansible_network_single_user_mode и ansible_network_import_modules - Подробности см. в журнале изменений ansible.netcommon changelog.

cisco.asa

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

cisco.ios

  • Подробности см. в журнале изменений ansible.netcommon changelog.
  • Требуется ansible.netcommon v2.0.0+ для поддержки ansible_network_single_user_mode и ansible_network_import_modules.

cisco.iosxr

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

cisco.nxos

  • Подробности см. в журнале изменений ansible.netcommon changelog.
  • Требуется ansible.netcommon v2.0.0+ для поддержки ansible_network_single_user_mode и ansible_network_import_modules.

community.grafana

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

community.mysql

  • mysql_replication - добавлено предупреждение о устаревании, что значения возврата Is_Slave и Is_Master будут заменены на Is_Primary и Is_Replica в community.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 changelog.
  • Требуется ansible.netcommon v2.0.0+ для поддержки ansible_network_single_user_mode и ansible_network_import_modules.

netapp.ontap

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

openvswitch.openvswitch

  • Для данного выпуска нет существенных изменений, и он был помечен ошибочно и не может быть отменён.

servicenow.servicenow

  • Переработан клиент для наследования от AnsibleModule
  • поддерживает протокол аутентификации OpenID Connect
  • поддерживает токен bearer для аутентификации

vyos.vyos

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

Удаленные возможности

Ansible-core

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

community.general

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

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

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

community.network

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

f5networks.f5_modules

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

fortinet.fortios

  • Модуль fortios_facts был удален
  • Модуль fortios_registration_forticare был удален
  • Модуль fortios_registration_vdom был удален
  • Модуль fortios_system_config_backup_restore был удален
  • Модуль fortios_system_vmlicense был удален

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

Ansible-core

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

ansible.netcommon

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

cisco.nxos

  • Устарел nxos_bgp_af в пользу модуля ресурса nxos_bgp_address_family.
  • Устарел nxos_bgp_neighbor_af в пользу модуля ресурса nxos_bgp_neighbor_address_family.

cloudscale_ch.cloud

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

community.aws

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

community.crypto

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

community.general

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

community.vmware

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

f5networks.f5_modules

  • Поддержка версий Python, предшествующих 3.5, устарела.

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

Spec-Zone.ru

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