find - Возвращает список файлов на основе определенных критериев
Новое в версии 2.0.
Описание
- Возвращает список файлов на основе определенных критериев. Несколько критериев объединяются операцией И.
- Для целевых платформ Windows используйте модуль win_find.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| age | Выбирает файлы, чей возраст равен или больше указанного времени. Используйте отрицательный возраст, чтобы найти файлы, чей возраст равен или меньше указанного времени. Вы можете выбрать секунды, минуты, часы, дни или недели, указав первую букву соответствующего слова (например, "1w"). | |
| age_stamp |
| Выберите свойство файла, по которому сравнивается возраст. |
| contains | Один или несколько регулярных выражений, которые должны совпадать с содержимым файла. | |
| excludes (добавлено в 2.5) | По умолчанию: None | Один или несколько шаблонов (оболочки или регулярные выражения), тип которых контролируется параметром use_regex. Параметр excludes определяет шаблоны, которые не должны быть включены в список. Можно указать несколько шаблонов, используя список. псевдонимы: exclude |
| file_type |
| Тип файла для выбора. Варианты 'link' и 'any' были добавлены в версии 2.3. |
| follow |
| Установите значение в true, чтобы следовать символичным ссылкам в пути для систем с python 2.6+. |
| get_checksum |
| Установите значение в true, чтобы получить контрольную сумму sha1 файла. |
| hidden |
| Установите значение в true, чтобы включить скрытые файлы, в противном случае они будут проигнорированы. |
| paths обязательно | Список путей к каталогам для поиска. Все пути должны быть полными. псевдонимы: name, path | |
| patterns | По умолчанию: * | Один или несколько шаблонов (оболочки или регулярные выражения), тип которых контролируется параметром use_regex. Шаблоны ограничивают список возвращаемых файлов файлами, имена которых соответствуют хотя бы одному из указанных шаблонов. Можно указать несколько шаблонов, используя список. псевдонимы: pattern |
| recurse |
| Если целевой объект — каталог, рекурсивно спускайтесь в каталог, ища файлы. |
| size | Выбирает файлы, размер которых равен или больше указанного размера. Используйте отрицательный размер, чтобы найти файлы, размер которых равен или меньше указанного размера. Неквалифицированные значения — в байтах, но можно добавить b, k, m, g и t, чтобы указать байты, килобайты, мегабайты, гигабайты и терабайты соответственно. Размер не вычисляется для каталогов. | |
| use_regex |
| Если false, шаблоны — шаблоны оболочки (shell), если true — регулярные выражения Python. |
Примечания
Примечание
- Для целевых платформ Windows используйте модуль win_find.
Примеры
- name: Recursively find /tmp files older than 2 days
find:
paths: /tmp
age: 2d
recurse: yes
- name: Recursively find /tmp files older than 4 weeks and equal or greater than 1 megabyte
find:
paths: /tmp
age: 4w
size: 1m
recurse: yes
- name: Recursively find /var/tmp files with last access time greater than 3600 seconds
find:
paths: /var/tmp
age: 3600
age_stamp: atime
recurse: yes
- name: Find /var/log files equal or greater than 10 megabytes ending with .old or .log.gz
find:
paths: /var/log
patterns: '*.old,*.log.gz'
size: 10m
# Note that YAML double quotes require escaping backslashes but yaml single quotes do not.
- name: Find /var/log files equal or greater than 10 megabytes ending with .old or .log.gz via regex
find:
paths: /var/log
patterns: "^.*?\\.(?:old|log\\.gz)$"
size: 10m
use_regex: yes
- name: Find /var/log all directories, exclude nginx and mysql
find:
paths: /var/log
recurse: no
file_type: directory
excludes: 'nginx,mysql'
Значения возврата
Общие значения возврата документированы здесь, следующие — поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| examined строка | успех | количество просмотренных файловых объектов Пример: 34 |
| files список | успех | все совпадения, найденные по заданным критериям (см. модуль stat для полного вывода каждого словаря) Пример: [{'path': '/var/tmp/test1', 'mode': '0644', '...': '...', 'checksum': '16fac7be61a6e4591a33ef4b729c5c3302307523'}, {'path': '/var/tmp/test2', '...': '...'}] |
| matched строка | успех | количество совпадений Пример: 14 |
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будут вноситься несовместимые с обратной совместимостью изменения в интерфейс.
Поддержка
Для получения дополнительной информации о поддержке данного модуля Red Hat, пожалуйста, обратитесь к этой статье базы знаний
Автор
- Брайан Кока (на основе Tidy Руджеро Маркеи)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/find_module.html
