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

В этом разделе обсуждаются изменения в поведении между Ansible 2.5 и Ansible 2.6.

Он предназначен для помощи в обновлении ваших playbooks, плагинов и других частей вашей инфраструктуры Ansible, чтобы они работали с этой версией Ansible.

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

Этот документ является частью коллекции по переносу. Полный список руководств по переносу можно найти по адресу руководствам по переносу.

• Playbook
• Устаревшее
• Модули
  • Удаленные модули
  • Заметки об устаревании
  • Заметные изменения в модулях
• Плагины
  • Заметки об устаревании
  • Заметные изменения в плагинах
• Перенос пользовательских скриптов
• Сети
• Скрипты динамической инвентаризации

Playbook

• Устаревшее задание always_run было удалено, используйте check_mode: no вместо него.

Устаревшее

• В модуле nxos_igmp_interface свойства oif_prefix и oif_source устарели. Используйте параметр ois_ps со словарем префикса и источника для значений вместо них.

Модули

Основные изменения в популярных модулях описаны здесь

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

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

Заметки об устаревании

Следующие модули будут удалены в Ansible 2.10. Пожалуйста, обновите свои playbooks соответственно.

• k8s_raw используйте k8s вместо него.
• openshift_raw используйте k8s вместо него.
• openshift_scale используйте k8s_scale вместо него.

Заметные изменения в модулях

• Параметр модуля upgrade для win_chocolatey был удален; используйте state: latest вместо него.
• Параметр модуля reboot для win_feature был удален; используйте плагин действия win_reboot вместо него.
• Модуль win_iis_webapppool больше не принимает строку для параметра модуля attributes; используйте значение словаря произвольной формы вместо него.
• Параметр модуля name для win_package был удален; он нигде не используется и должен быть удален из ваших playbooks.
• Модуль win_regedit больше не автоматически исправляет путь к hive HCCC на HKCC; используйте HKCC, так как это правильный путь к hive.

• Модуль file - Устанавливает атрибуты файлов теперь выводит предупреждение об устаревании, когда src задан со значением состояния, отличным от hard или link, так как он должен быть полезен только с ними. Это может повлиять на людей, которые полагались на ошибочное взаимодействие src и других состояний для размещения файлов в подкаталоге. Например:

  $ ansible localhost -m file -a 'path=/var/lib src=/tmp/ state=directory'
  

  Создаст каталог с именем /tmp/lib. Вместо этого просто укажите весь путь назначения так:

  $ ansible localhost -m file -a 'path=/tmp/lib state=directory'
  

• Модули k8s_raw и openshift_raw были переименованы в новый модуль k8s.
• Модуль k8s поддерживает все ресурсы Kubernetes, включая те, что из определений пользовательских ресурсов и агрегированных API-серверов. Это включает все ресурсы OpenShift.
• Модуль k8s не будет принимать ресурсы, где подключаемые ключи были переименованы в snake_case. Это было решением, предложенным вместе с модулями k8s_raw и openshift_raw.
• Модуль k8s может не принять ресурсы, где api_version был изменён на сокращённую версию в клиенте Kubernetes Python. Теперь вы должны указать правильный полный Kubernetes api_version для ресурса.
• Модуль k8s теперь может обрабатывать файлы YAML с несколькими документами, если они переданы с параметром src. Он обработает каждый документ как отдельный ресурс. Ресурсы, предоставленные внутри параметра resource_definition, должны оставаться единственным документом.
• Модуль k8s не будет автоматически изменять запросы создания Project на запросы создания ProjectRequest, как это делал модуль openshift_raw. Теперь вы должны явно указать вид ProjectRequest.
• Модуль k8s больше не будет автоматически удалять секреты из значений возврата Ansible (и, соответственно, из лога). Чтобы предотвратить вывод значений секретов в задаче в лог, укажите параметр no_log в блоке задачи.
• Модуль k8s_scale теперь поддерживает масштабируемые объекты OpenShift, такие как DeploymentConfig.
• Модуль lineinfile был изменён, чтобы отображать предупреждение при использовании пустой строки в качестве регулярного выражения. Поскольку пустое регулярное выражение соответствует каждой строке в файле, оно заменит последнюю строку в файле вместо вставки. Если такое поведение нужно, используйте '^', которое будет соответствовать каждой строке и не вызовет предупреждения.
• Модули Openstack больше не используют библиотеку shade. Вместо неё используется openstacksdk. Так как openstacksdk должна быть уже установлена в качестве зависимости к shade, дополнительные действия не требуются.

Плагины

Заметки об устаревании

Следующие модули будут удалены в Ansible 2.10. Пожалуйста, обновите свои playbooks соответственно.

• openshift используйте k8s вместо него.

Заметные изменения в плагинах

• Плагин поиска k8s теперь поддерживает все ресурсы Kubernetes, включая те, что из определений пользовательских ресурсов и агрегированных API-серверов. Это включает все ресурсы OpenShift.
• Плагин поиска k8s может не принять ресурсы, где api_version был изменён на сокращённую версию в клиенте Kubernetes Python. Теперь вы должны указать правильный полный Kubernetes api_version для ресурса.
• Плагин поиска k8s больше не будет удалять секреты из значений возврата Ansible (и, соответственно, из лога). Чтобы предотвратить вывод значений секретов в задаче в лог, укажите параметр no_log в блоке задачи.

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

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

Сети

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

Скрипты динамической инвентаризации

• contrib/inventory/openstack.py был переименован в contrib/inventory/openstack_inventory.py. Если вы использовали openstack.py как имя файла динамической инвентаризации OpenStack, измените его на openstack_inventory.py. В противном случае имя файла будет конфликтовать с импортами из openstacksdk.