community.general.filetree lookup — рекурсивное сопоставление всех файлов в дереве каталогов

Краткое описание

• Этот lookup позволяет шаблонизировать полное дерево файлов в целевой системе, сохраняя разрешения и владельца.
• Поддерживаются каталоги, файлы и символические ссылки, включая SELinux и другие свойства файлов.
• Если указано несколько путей, применяется логика first_found, а записи, обработанные в предыдущих путях, повторно не обрабатываются. Это позволяет объединять разные деревья в порядке приоритета или добавлять role_vars к определённым путям, чтобы влиять на различные экземпляры одной и той же роли.

Термины

Именованные параметры

Здесь описаны именованные параметры lookup. Это значения key1=value1, key2=value2 и так далее в следующих примерах: lookup('community.general.filetree', key1=value1, key2=value2, ...) и query('community.general.filetree', key1=value1, key2=value2, ...)

Примечания

Примеры

- name: Create directories
  ansible.builtin.file:
    path: /web/{{ item.path }}
    state: directory
    mode: '{{ item.mode }}'
  with_community.general.filetree: web/
  when: item.state == 'directory'

- name: Template files (explicitly skip directories in order to use the 'src' attribute)
  ansible.builtin.template:
    src: '{{ item.src }}'
    # Your template files should be stored with a .j2 file extension,
    # but should not be deployed with it. splitext|first removes it.
    dest: /web/{{ item.path | splitext | first }}
    mode: '{{ item.mode }}'
  with_community.general.filetree: web/
  when: item.state == 'file'

- name: Recreate symlinks
  ansible.builtin.file:
    src: '{{ item.src }}'
    dest: /web/{{ item.path }}
    state: link
    follow: false  # avoid corrupting target files if the link already exists
    force: true
    mode: '{{ item.mode }}'
  with_community.general.filetree: web/
  when: item.state == 'link'

- name: list all files under web/
  ansible.builtin.debug:
    msg: "{{ lookup('community.general.filetree', 'web/') }}"

- name: list all files under web/; exclude .git and .node_modules
  ansible.builtin.debug:
    msg: >-
      {{ lookup('community.general.filetree', 'web/', exclude='^(\.git|\.node_modules)$') }}

Возвращаемое значение