fileglob - list files matching a pattern¶

New in version 1.4.

Synopsis
Parameters
Notes
Examples
Return Values
Status
- Author

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 ore only supported on files, not directory/paths.

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
_raw		content of file(s)

Status ¶

Author ¶

Michael DeHaan <michael.dehaan@gmail.com>

Hint

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