fileglob – list files matching a pattern

From Get docs
< Lookup PluginsAnsible/docs/2.7/plugins/lookup/fileglob


fileglob – list files matching a pattern

New in version 1.4.


Synopsis

  • Matches all files in a single directory, non-recursively, that match a pattern. It calls Python’s “glob” library.

Parameters

Parameter Choices/Defaults Configuration Comments

_terms

- / required

path(s) of files to read



Notes

Note

  • Patterns are only supported on files, not directory/paths.
  • Matching is against local system files.


Examples

- name: display content of all .txt files in dir
  debug: msg={{lookup('fileglob', '/my/path/*.txt')}}

- name: Copy each file over that matches the given pattern
  copy:
    src: "{{ item }}"
    dest: "/etc/fooapp/"
    owner: "root"
    mode: 0600
  with_fileglob:
    - "/playbooks/files/fooapp/*"

Return Values

Common return values are documented here, the following are the fields unique to this lookup:

Key Returned Description

_list

-

list of files





Status

Authors

Hint

If you notice any issues in this documentation you can edit this document to improve it.


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/plugins/lookup/fileglob.html