Nota

Este módulo es parte de ansible-base e incluido en todas las instalaciones de Ansible. En la mayoría de los casos, puede utilizar el nombre corto del módulo find incluso sin especificar el collections: palabra clave. A pesar de eso, le recomendamos que utilice el FQCN para facilitar la vinculación a la documentación del módulo y evitar conflictos con otras colecciones que puedan tener el mismo nombre de módulo.

Nuevo en la versión 2.0: de ansible.builtin

  • Sinopsis
  • Parámetros
  • Ver también
  • Ejemplos de
  • Valores devueltos

Sinopsis

  • Devuelve una lista de archivos según criterios específicos. Múltiples criterios son Y juntos.
  • Para los destinos de Windows, use el ansible.windows.win_find módulo en su lugar.

Parámetros

Parámetro Opciones / Valores predeterminados Comentarios
la edadstring Seleccione archivos cuya antigüedad sea igual o mayor que el tiempo especificado.Use una edad negativa para buscar archivos iguales o menores que el tiempo especificado.Puede elegir segundos, minutos, horas, días o semanas especificando la primera letra de cualquier de esas palabras (por ejemplo, “1w”).
age_stampstring
    Opciones:

  • un momento
  • ctime
  • mtime ←
 Elija la propiedad del archivo con la que comparamos la edad.
contienestring Una expresión o patrón regular que debe coincidir con el contenido del archivo. Funciona solo cuando Tipo de archivo es file.
profundidadentero agregado en 2.6 de ansible.builtin Establezca el número máximo de niveles a los que descender. no anulará este valor, que es efectivamente la profundidad 1. El valor predeterminado es la profundidad ilimitada.
excluyelista / elementos =string agregado en 2.5 de ansible.builtin Uno o más patrones (shell o regex), cuyo tipo está controlado por use_regex Los elementos cuyos nombres de base coinciden excludes patrón son seleccionados de patterns partidos. Se pueden especificar varios patrones usando una lista.
alias: excluir
Tipo de archivostring
    Opciones:

  • alguna
  • directorio
  • expediente ←
  • Enlace
 Tipo de archivo para seleccionar Las opciones de ‘enlace’ y ‘cualquier’ se agregaron en Ansible 2.3.
seguirbooleano
    Opciones:

  • no ←
  • sí
 Establezca esto en yes para seguir enlaces simbólicos en la ruta para sistemas con python 2.6+.
get_checksumbooleano
    Opciones:

  • no ←
  • sí
 Establezca esto en yes para recuperar la suma de comprobación SHA1 de un archivo.
ocultobooleano
    Opciones:

  • no ←
  • sí
 Establezca esto en yes para incluir archivos ocultos, de lo contrario se ignorarán.
caminoslista / elementos =string / requerido Lista de rutas de directorios para buscar. Todos los caminos deben estar completamente calificados.
alias: nombre, ruta
patroneslista / elementos =string Defecto:
“*”		 Uno o más patrones (shell o regex), cuyo tipo está controlado por use_regex Los patrones restringen la lista de archivos que se devolverán a aquellos cuyos nombres base coincidan con al menos uno de los patrones especificados. Se pueden especificar varios patrones usando una lista. El patrón se compara con el nombre base del archivo, excluyendo el directorio. Cuando se usa regexen, el patrón DEBE coincidir con el nombre de archivo COMPLETO, no solo con partes de él. Entonces, si está buscando hacer coincidir todos los archivos que terminan en .default, necesitará usar ‘. * . Default’ como una expresión regular y no solo ‘ .default’.Este parámetro espera una lista, que puede ser una coma separados o YAML. Si alguno de los patrones contiene una coma, asegúrese de ponerlos en una lista para evitar dividir los patrones de formas no deseadas.
alias: patrón
read_whole_filebooleano agregado en 2.11 de ansible.builtin
    Opciones:

  • no ←
  • sí
 Al hacer un contains búsqueda, determina si todo el archivo debe leerse en la memoria o si la expresión regular debe aplicarse al archivo línea por línea. true puede tener implicaciones de rendimiento y memoria para archivos grandes. re.search() en lugar de re.match().
recurrentebooleano
    Opciones:

  • no ←
  • sí
 Si el destino es un directorio, descienda recursivamente al directorio en busca de archivos.
Tallastring Seleccione archivos cuyo tamaño sea igual o mayor que el tamaño especificado.Use un tamaño negativo para buscar archivos iguales o menores que el tamaño especificado.Los valores no calificados están en bytes, pero b, k, m, gyt se pueden agregar a especificar bytes, kilobytes, megabytes, gigabytes y terabytes, respectivamente. El tamaño no se evalúa para los directorios.
use_regexbooleano
    Opciones:

  • no ←
  • sí
 Si no, los patrones son archivos globs (shell). yes, son expresiones regulares de Python.

Ver también

Ver también

ansible.windows.win_find

La documentación oficial sobre el ansible.windows.win_find módulo.

Ejemplos de

-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:3600age_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'# When using patterns that contain a comma, make sure they are formatted as lists to avoid splitting the pattern-name: Use a single pattern that contains a comma formatted as a list
  find:paths: /var/log
    file_type: file
    use_regex: yes
    patterns:['^_[0-9]2,4_.*.log$']-name: Use multiple patterns that contain a comma formatted as a YAML list
  find:paths: /var/log
    file_type: file
    use_regex: yes
    patterns:-'^_[0-9]2,4_.*.log$'-'^[a-z]1,5_.*log$'

Valores devueltos

Los valores de retorno comunes están documentados aquí, los siguientes son los campos exclusivos de este módulo:

Llave Devuelto Descripción
examinadoentero éxito Número de objetos del sistema de archivos examinados
Muestra:34
archivoslista / elementos =string éxito Todas las coincidencias encontradas con los criterios especificados (consulte el módulo de estadísticas para obtener la salida completa de cada diccionario)
Muestra:[‘…’: ‘…’, ‘checksum’: ’16fac7be61a6e4591a33ef4b729c5c3302307523′, ‘mode’: ‘0644’, ‘path’: ‘/var/tmp/test1’, ‘…’: ‘…’, ‘path’: ‘/var/tmp/test2’]
emparejadoentero éxito Numero de partidos
Muestra:14

Autores

  • Brian Coca (@bcoca)