ansible的find模块

ansible的find模块

微信搜索 zze_coding 或扫描 👉 二维码关注我的微信公众号获取更多资源推送:

此文章为「ansible笔记(2)之常用模块」的子文章。

find 模块可以帮助我们在远程主机中查找符合条件的文件,就像 find 命令一样。

参数说明:

  • paths:必须参数,指定在哪个目录中查找文件,可以指定多个路径,路径间用逗号隔开,此参数有别名,使用别名 path 或者别名 name 可以代替 paths
  • recurse:默认情况下,只会在指定的目录中查找文件,也就是说,如果目录中还包含目录,ansible 并不会递归的进入子目录查找对应文件,如果想要递归的查找文件,需要使用 recurse 参数,当 recurse 参数设置为 yes 时,表示在指定目录中递归的查找文件;
  • hidden:默认情况下,隐藏文件会被忽略,当hidden参数的值设置为yes时,才会查找隐藏文件;
  • file_type:默认情况下,ansible 只会根据条件查找文件,并不会查找目录或软链接等文件类型,如果想要指定查找的文件类型,可以通过 file_type 指定文件类型,可指定的文件类型有 anydirectoryfilelink 四种;
  • patterns:使用此参数指定需要查找的文件名称,支持使用 shell(比如通配符)或者正则表达式去匹配文件名称,默认情况下,使用 shell 匹配对应的文件名,如果想要使用 python 的正则去匹配文件名,需要将 use_regex 参数的值设置为 yes
  • use_regex:默认情况下,find 模块不会使用正则表达式去解析 patterns 参数中对应的内容,当 use_regex 设置为 yes时,表示使用 python 正则解析 patterns 参数中的表达式,否则,使用 glob 通配符解析 patterns 参数中的表达式;
  • contains:使用此参数可以根据文章内容查找文件,此参数的值为一个正则表达式,find 模块会根据对应的正则表达式匹配文件内容。
  • age:使用此参数可以根据时间范围查找文件,默认以文件的 mtime 为准与指定的时间进行对比,比如,如果想要查找 mtime 在 3 天之前的文件,那么可以设置 age=3d,如果想要查找 mtime 在 3 天以内的文件,可以设置 age=-3d,这里所说的 3 天是按照当前时间往前推 3 天,可以使用的单位有秒(s)、分(m)、时(h)、天(d)、星期(w);
  • age_stamp 参数:文件的时间属性中有三个时间种类,atimectimemtime,当我们根据时间范围查找文件时,可以指定以哪个时间种类为准,当根据时间查找文件时,默认以 mtime 为准;
  • size 参数 :使用此参数可以根据文件大小查找文件,比如,如果想要查找大于 3M 的文件,那么可以设置 size=3m,如果想要查找小于 50k 的文件,可以设置 size=-50k,可以使用的单位有tgmkb
  • get_checksum 参数:当有符合查找条件的文件被找到时,会同时返回对应文件的 sha1 校验码,如果要查找的文件比较大,那么生成校验码的时间会比较长;

例 1:在客户机的 /testdir 目录中查找文件内容中包含 abc 字符串的文件,隐藏文件会被忽略,不会进行递归查找。

$ ansible all -m find -a 'paths=/testdir contains=".*abc.*" '

例 2:在客户机的 /testdir 目录以及其子目录中查找文件内容中包含 abc 字符串的文件,隐藏文件会被忽略。

$ ansible -m find -a 'paths=/testdir contains=".*abc.*" recurse=yes '

例 3:在客户机的 /testdir 目录中查找以 .sh 结尾的文件,包括隐藏文件,但是不包括目录或其他文件类型,不会进行递归查找。

$ ansible all -m find -a 'paths=/testdir patterns="*.sh" hidden=yes'

例 4:在客户机的 /testdir 目录中查找以 .sh 结尾的文件,包括隐藏文件,包括所有文件类型,比如文件、目录、或者软链接,但是不会进行递归查找。

$ ansible all -m find -a 'paths=/testdir patterns="*.sh" file_type=any hidden=yes'

例 5:在客户机的 /testdir 目录中查找以 .sh 结尾的文件,只不过 patterns 对应的表达式为正则表达式,查找范围包括隐藏文件,包括所有文件类型,但是不会进行递归查找,不会对 /testdir 目录的子目录进行查找。

$ ansible all -m find -a 'paths=/testdir patterns=".*\.sh" use_regex=yes file_type=any hidden=yes'

例 6:在客户机的 /testdir 目录中以及其子目录中查找 mtime4 天以内的文件,不包含隐藏文件,不包含目录或软链接文件等文件类型。

$ ansible all -m find -a "path=/testdir age=-4d recurse=yes"

例 7:在客户机的 /testdir 目录中以及其子目录中查找 atime2 星期以内的文件,不包含隐藏文件,不包含目录或软链接文件等文件类型。

$ ansible all -m find -a "path=/testdir age=-2w age_stamp=atime recurse=yes"

例 8:在客户机的 /testdir 目录中以及其子目录中查找大于 2G 的文件,不包含隐藏文件,不包含目录或软链接文件等文件类型。

$ ansible all -m find -a "paths=/testdir size=2g recurse=yes" 

例 9:在客户机的 /testdir 目录中以及其子目录中查找以 .sh 结尾的文件,并且返回符合条件文件的 sha1 校验码,包括隐藏文件。

$ ansible all -m find -a "paths=/testdir patterns=*.sh get_checksum=yes  hidden=yes recurse=yes"

Copyright: 采用 知识共享署名4.0 国际许可协议进行许可

Links: https://www.zze.xyz/archives/ansible-module-find.html

Buy me a cup of coffee ☕.