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

Плейбук

• При вызове задач и задании async задавать ANSIBLE_ASYNC_DIR в environment: больше нельзя. Вместо этого используйте переменную конфигурации оболочки async_dir, например задав ansible_async_dir:

tasks:
  - dnf:
      name: '*'
      state: latest
    async: 300
    poll: 5
    vars:
      ansible_async_dir: /path/to/my/custom/dir

• В среду шаблонов добавлена функция undef() для создания неопределённых переменных непосредственно в шаблоне. При необходимости для переменных, которые предполагается переопределять, можно указать подсказку.

vars:
  old: "{{ undef }}"
  new: "{{ undef() }}"
  new_with_hint: "{{ undef(hint='You must override this variable') }}"

Обнаружение интерпретатора Python

Значение по умолчанию INTERPRETER_PYTHON изменилось на auto. Список интерпретаторов Python в INTERPRETER_PYTHON_FALLBACK изменён так, чтобы отдавать предпочтение Python 3, а не Python 2. В результате этих двух изменений новое поведение по умолчанию — незаметно отдавать предпочтение Python 3 перед Python 2 на удалённых узлах. Ранее в случаях, когда при обнаружении интерпретатора выбирался бы Python 3, но интерпретатор был задан как /usr/bin/python, выводилось предупреждение об устаревании.

Значение INTERPRETER_PYTHON_FALLBACK можно изменить с заданного по умолчанию списка интерпретаторов, установив переменную ansible_interpreter_python_fallback.

Дополнительные сведения см. в документации по обнаружению интерпретатора.

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

• Для узла-контроллера в этом выпуске требуется Python 3.8. Скрипты командной строки не будут работать с более ранними версиями Python.
• ansible-vault больше не поддерживает PyCrypto и требует cryptography.

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

• Использование Python 2.6 на целевом узле объявлено устаревшим в этом выпуске. В ansible-core 2.13 поддержка Python 2.6 будет удалена.
• Переменные без кавычек в условиях: условия when больше не преобразуют автоматически строковые логические значения, например "true" и "false", в логические значения. Любая переменная, содержащая непустую строку, считается истинной. Ранее это можно было настроить с помощью параметра конфигурации CONDITIONAL_BARE_VARS (и переменной среды ANSIBLE_CONDITIONAL_BARE_VARS). Эта настройка больше не действует. Обойти эту проблему можно с помощью фильтра |bool:

vars:
  teardown: 'false'

tasks:
  - include_tasks: teardown.yml
    when: teardown | bool

  - include_tasks: provision.yml
    when: not teardown | bool

• Метод _remote_checksum() в ActionBase объявлен устаревшим. Любому плагину действий, использующему этот метод, следует вместо него использовать _execute_remote_stat().

Модули

• cron теперь требует указывать name во всех случаях.
• cron больше не принимает параметр reboot. Используйте вместо него special_time: reboot.
• hostname — во FreeBSD результат before больше не будет равен "temporarystub", если постоянный файл имени узла отсутствует. Для единообразия с другими системами вместо этого будет возвращаться "" (пустая строка).
• hostname — в системах на базе OpenRC и Solaris результат before больше не будет равен "UNKNOWN", если постоянный файл имени узла отсутствует. Для единообразия с другими системами вместо этого будет возвращаться "" (пустая строка).
• pip теперь использует модуль Python pip, установленный для интерпретатора Python модуля Ansible, если он доступен, кроме случаев, когда указаны executable или virtualenv.

Плагины

• unique при использовании с Jinja2 < 2.10 учитывает регистр и теперь последовательно выдаёт ошибку, если case_sensitive=False, а не при case_sensitive=True.
• Фильтры теории множеств (intersect, difference, symmetric_difference и union) теперь учитывают регистр. Чтобы сохранить прежнее поведение, явно используйте case_sensitive=False. Примечание: в Jinja2 < 2.10 фильтры уже по умолчанию учитывали регистр.
• password_hash теперь использует значения по умолчанию passlib, если параметр не задан. Например, bcrypt_sha256 теперь по умолчанию использует формат «2b»; если требуется формат «2a», его необходимо указать.

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

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

Сетевые технологии

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

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

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

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

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

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

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

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

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

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

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

Руководство по переносу на v5.0.0