Ansible Module find: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
Line 24: Line 24:
==<tt>paths</tt>==
==<tt>paths</tt>==
Each element listed here must be a directory.
Each element listed here must be a directory.
==<tt>patterns</tt>==
==<tt>recurse</tt>==
==<tt>recurse</tt>==
If target is a directory, recursively descend into the directory looking for files. Values: <code>yes</code>, <code>no</code>. Default is <code>no</code>.
If target is a directory, recursively descend into the directory looking for files. Values: <code>yes</code>, <code>no</code>. Default is <code>no</code>.
==<tt>patterns</tt>==
==<tt>file_type</tt>==
==<tt>file_type</tt>==
==<tt>depth</tt>==
==<tt>depth</tt>==
An integer that specifies the maximum number of levels to descend into. Setting [[#recurse|recurse]] to no will override this value, which is effectively depth 1. Default is unlimited depth.
An integer that specifies the maximum number of levels to descend into. Setting [[#recurse|recurse]] to no will override this value, which is effectively depth 1. Default is unlimited depth.

Revision as of 09:24, 4 July 2021

External

Internal

Overview

Return a list of files based on specific criteria. Multiple criteria are ANDed together.

Example

- name: Find JetBrains applications
  find:
    paths: "{{ ansible_env.HOME }}/Library/Application Support/JetBrains/Toolbox/apps"
    recurse: yes
    patterns: '.history.json'
    hidden: yes
    file_type: file
    depth: 5
  register: intellij_apps

Module Arguments

paths

Each element listed here must be a directory.

patterns

recurse

If target is a directory, recursively descend into the directory looking for files. Values: yes, no. Default is no.

file_type

depth

An integer that specifies the maximum number of levels to descend into. Setting recurse to no will override this value, which is effectively depth 1. Default is unlimited depth.