Управление BSD-узлами с помощью Ansible

Пакеты и порты FreeBSD

В FreeBSD нет гарантии, что по умолчанию установлен исполняемый файл /usr/local/bin/python или ссылка на исполняемый файл. При работе с удалённым узлом Ansible рекомендуется установить как минимум версию Python, поддерживаемую Ansible, например lang/python311, а также метапорты lang/python3 и lang/python. Цитата из /usr/ports/lang/python3/pkg-descr:

This is a meta port to the Python 3.x interpreter and provides symbolic links
to bin/python3, bin/pydoc3, bin/idle3 and so on to allow compatibility with
minor version agnostic Python scripts.

Цитата из /usr/ports/lang/python/pkg-descr:

This is a meta port to the Python interpreter and provides symbolic links
to bin/python, bin/pydoc, bin/idle and so on to allow compatibility with
version agnostic python scripts.

В результате устанавливаются следующие пакеты:

shell> pkg info | grep python
python-3.11_3,2                "meta-port" for the default version of Python interpreter
python3-3_4                    Meta-port for the Python interpreter 3.x
python311-3.11.10              Interpreted object-oriented programming language

а также следующие исполняемые файлы и ссылки:

shell> ls -l /usr/local/bin/ | grep python
lrwxr-xr-x  1 root wheel       7 Nov  1 18:55 python -> python3
lrwxr-xr-x  1 root wheel      14 Nov  1 18:55 python-config -> python3-config
lrwxr-xr-x  1 root wheel      10 Oct 31 11:40 python3 -> python3.11
lrwxr-xr-x  1 root wheel      17 Oct 31 11:40 python3-config -> python3.11-config
-r-xr-xr-x  1 root wheel    4744 Oct 31 11:14 python3.11
-r-xr-xr-x  1 root wheel    3113 Oct 31 11:14 python3.11-config

INTERPRETER_PYTHON_FALLBACK

Начиная с версии 2.8 в Ansible доступна полезная переменная ansible_interpreter_python_fallback, позволяющая задать список путей для поиска Python. См. INTERPRETER_PYTHON_FALLBACK. Поиск выполняется по этому списку, и используется первый найденный элемент. Например, приведённая ниже конфигурация позволит отказаться от установки метапортов из предыдущего раздела: если метапорты Python не установлены, первые два элемента списка будут пропущены, а будет обнаружен /usr/local/bin/python3.11.

ansible_interpreter_python_fallback=['/usr/local/bin/python', '/usr/local/bin/python3', '/usr/local/bin/python3.11']

Можно использовать эту переменную, дополнив список более ранними версиями Python, и, например, поместить её в group_vars/all. Затем при необходимости переопределите её для отдельных групп в group_vars/{group1, group2, ...}, а для отдельных узлов — в host_vars/{host1, host2, ...}. См. Приоритет переменных: где следует задавать переменную?.

Отладка обнаружения Python

Например, для следующего инвентаря

shell> cat hosts
[test]
test_11
test_12
test_13

[test:vars]
ansible_connection=ssh
ansible_user=admin
ansible_become=true
ansible_become_user=root
ansible_become_method=sudo
ansible_interpreter_python_fallback=['/usr/local/bin/python', '/usr/local/bin/python3', '/usr/local/bin/python3.11']
ansible_perl_interpreter=/usr/local/bin/perl

следующий плейбук

# playbook.yml
- hosts: test_11
  gather_facts: false
  tasks:
    - command: which python
      register: result
    - debug:
        var: result.stdout
    - debug:
        msg: |-
          {% for i in _vars %}
          {{ i }}:
            {{ lookup('vars', i)|to_nice_yaml|indent(2) }}
          {% endfor %}
      vars:
        _vars: "{{ query('varnames', '.*python.*') }}"

выводит подробные сведения

shell> ANSIBLE_CALLBACK_RESULT_FORMAT=yaml ansible-playbook -i hosts playbook.yml

PLAY [test_11] *******************************************************************************

TASK [command] *******************************************************************************
[WARNING]: Platform freebsd on host test_11 is using the discovered Python interpreter at
/usr/local/bin/python, but future installation of another Python interpreter could change the
meaning of that path. See https://docs.ansible.com/ansible-
core/2.18/reference_appendices/interpreter_discovery.html for more information.
changed: [test_11]

TASK [debug] *********************************************************************************
ok: [test_11] =>
    result.stdout: /usr/local/bin/python

TASK [debug] *********************************************************************************
ok: [test_11] =>
    msg: |-
        ansible_interpreter_python_fallback:
          - /usr/local/bin/python
          - /usr/local/bin/python3
          - /usr/local/bin/python3.11

        discovered_interpreter_python:
          /usr/local/bin/python

        ansible_playbook_python:
          /usr/bin/python3

Как видно, на удалённом узле FreeBSD был обнаружен первый элемент списка ansible_interpreter_python_fallback. Переменная ansible_playbook_python содержит путь к Python на управляющем узле Linux, с которого был запущен плейбук.

Что касается предупреждения, цитата из INTERPRETER_PYTHON:

The fallback behavior will issue a warning that the interpreter
should be set explicitly (since interpreters installed later may
change which one is used). This warning behavior can be disabled by
setting auto_silent or auto_legacy_silent. ...

Можно проигнорировать это предупреждение или избавиться от него, задав переменную ansible_python_interpreter=auto_silent, поскольку именно этого и следует ожидать при использовании /usr/local/bin/python («установленные позднее интерпретаторы могут изменить, какой из них будет использоваться»). Например:

shell> cat hosts
[test]
test_11
test_12
test_13

[test:vars]
ansible_connection=ssh
ansible_user=admin
ansible_become=true
ansible_become_user=root
ansible_become_method=sudo
ansible_interpreter_python_fallback=['/usr/local/bin/python', '/usr/local/bin/python3', '/usr/local/bin/python3.11']
ansible_python_interpreter=auto_silent
ansible_perl_interpreter=/usr/local/bin/perl

Дополнительные переменные

Если вы используете дополнительные плагины, не входящие в состав Ansible, можно задать аналогичные переменные для bash, perl или ruby — в зависимости от реализации плагина. Например:

[freebsd:vars]
ansible_python_interpreter=/usr/local/bin/python
ansible_perl_interpreter=/usr/local/bin/perl