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

Сценарий выполнения

• При вызове задач и установке async, настройка ANSIBLE_ASYNC_DIR в environment: больше недействительна. Используйте вместо этого переменную конфигурации shell 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», необходимо указать его.

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

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

Сеть

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

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

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

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

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

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

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

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

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

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

Руководство по переносу для v5.0.1

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