saltstack模块之file相关模块

wshq

　　1、file.access
　　file.access：测试salt进程是否有对指定文件的对应访问权限。
[root@salt-master ~]# salt '*' file.access /etc/passwd f　　
salt-minion02.contoso.com:
　　
    True
　　
salt-minion01.contoso.com:
　　
    True
　　
[root@salt-master ~]# salt '*' file.access /etc/passwd r
　　
salt-minion02.contoso.com:
　　
    True
　　
salt-minion01.contoso.com:
　　
    True
　　
[root@salt-master ~]# salt '*' file.access /etc/passwd w
　　
salt-minion01.contoso.com:
　　
    True
　　
salt-minion02.contoso.com:
　　
    True
　　
[root@salt-master ~]# salt '*' file.access /etc/passwd x
　　
salt-minion02.contoso.com:
　　
    False
　　
salt-minion01.contoso.com:
　　
    False
　　2、file.touch
　　file.touch：如果文件不存在创建文件，相当于touch file，如果文件存在就更新访问时间或者修改时间。
[root@salt-master ~]# salt '*' file.touch /tmp/salt-test　　
salt-minion02.contoso.com:
　　
    True
　　
salt-minion01.contoso.com:
　　
    True
　　3、file.append
　　file.append：追加文字到文件的末尾。
[root@salt-master ~]# salt '*' file.append /tmp/sal-test "Hello,World."　　
salt-minion01.contoso.com:
　　
    Wrote 1 lines to "/tmp/sal-test"
　　
salt-minion02.contoso.com:
　　
    Wrote 1 lines to "/tmp/sal-test"
　　
[root@salt-master ~]# salt '*' file.append /tmp/sal-test args='Hello=Hi'
　　
salt-minion01.contoso.com:
　　
    Wrote 1 lines to "/tmp/sal-test"
　　
salt-minion02.contoso.com:
　　
    Wrote 1 lines to "/tmp/sal-test"
　　
[root@salt-master ~]# salt '*' file.append /tmp/sal-test args="['true=1','false=0']"
　　
salt-minion01.contoso.com:
　　
    Wrote 2 lines to "/tmp/sal-test"
　　
salt-minion02.contoso.com:
　　
    Wrote 2 lines to "/tmp/sal-test"
　　4、file.basename
　　file.basename：返回所给路径的最后一个部分。
[root@salt-master ~]# salt '*' file.basename /tmp/sal-test　　
salt-minion02.contoso.com:
　　
    sal-test
　　
salt-minion01.contoso.com:
　　
    sal-test
　　5、file.chgrp
　　file.chgrp：修改文件的属组。
[root@salt-master ~]# salt '*' file.chgrp /tmp/testfile nginx　　
salt-minion01.contoso.com:
　　
    None
　　
salt-minion02.contoso.com:
　　
    None
　　
[root@salt-master ~]# salt '*' cmd.run "ls -l /tmp/testfile"
　　
salt-minion01.contoso.com:
　　
    -rw-r--r-- 1 root nginx 0 Jun  4 01:27 /tmp/testfile
　　
salt-minion02.contoso.com:
　　
    -rw-r--r-- 1 root nginx 0 Jun  4 01:27 /tmp/testfile
　　6、file.chown
　　file.chown：修改文件的属主和属组。
[root@salt-master ~]# salt '*' file.chown /tmp/testfile nginx nginx　　
salt-minion01.contoso.com:
　　
    None
　　
salt-minion02.contoso.com:
　　
    None
　　
[root@salt-master ~]# salt '*' cmd.run "ls -l /tmp/testfile"
　　
salt-minion02.contoso.com:
　　
    -rw-r--r-- 1 nginx nginx 0 Jun  4 01:27 /tmp/testfile
　　
salt-minion01.contoso.com:
　　
    -rw-r--r-- 1 nginx nginx 0 Jun  4 01:27 /tmp/testfile
　　7、file.copy
　　file.copy：从源目录拷贝文件到目标目录。如果要拷贝目录，需要添加recurse标签，默认情况下会覆盖目标目录中相同路径的文件，并保留其他文件。remove_existing选项会提前移除目标目录中的所有文件，然后再从源路径拷贝文件到目标路径。
[root@salt-master ~]# salt '*' file.copy /etc/hosts /tmp/hosts　　
salt-minion01.contoso.com:
　　
    True
　　
salt-minion02.contoso.com:
　　
    True
　　
[root@salt-master ~]# salt '*' cmd.run 'ls -l /tmp/hosts'
　　
salt-minion01.contoso.com:
　　
    -rw-r--r-- 1 root root 327 Jun  4 01:41 /tmp/hosts
　　
salt-minion02.contoso.com:
　　
    -rw-r--r-- 1 root root 330 Jun  4 01:41 /tmp/hosts
　　
[root@salt-master ~]# salt '*' file.copy /var/spool/cron/ /tmp/ recurse=True
　　
salt-minion01.contoso.com:
　　
    True
　　
salt-minion02.contoso.com:
　　
    True
　　
[root@salt-master ~]# salt '*' cmd.run 'ls -l /tmp/root'
　　
salt-minion02.contoso.com:
　　
    -rw-r--r-- 1 root root 89 Jun  4 01:46 /tmp/root
　　
salt-minion01.contoso.com:
　　
    -rw-r--r-- 1 root root 73 Jun  4 01:46 /tmp/root
　　
[root@salt-master ~]# salt '*' file.copy /var/spool/cron/ /tmp/ recurse=True remove_existing=True
　　
salt-minion02.contoso.com:
　　
    True
　　
salt-minion01.contoso.com:
　　
    True
　　
[root@salt-master ~]# salt '*' cmd.run 'ls -l /tmp'
　　
salt-minion01.contoso.com:
　　
    total 4
　　
    -rw-r--r-- 1 root root 73 Mar 11 21:35 root
　　
salt-minion02.contoso.com:
　　
    total 4
　　
    -rw------- 1 root root 89 May 25 13:32 root
　　8、file.dirname
　　file.dirname：返回指定路径的目录部分。
[root@salt-master ~]# salt '*' file.dirname /etc/passwd　　
salt-minion01.contoso.com:
　　
    /etc
　　
salt-minion02.contoso.com:
　　
    /etc
　　9、file.diskusage
　　file.diskusage：递归计算指定目录所占的磁盘空间并以字节为单位返回计算出的值。
[root@salt-master ~]# salt '*' file.diskusage /root/install.log　　
salt-minion01.contoso.com:
　　
    30131
　　
salt-minion02.contoso.com:
　　
    30131
　　10、file.file_exists
　　file.file_exists：测试目标路径是否是一个有效文件，返回值为True或False。
[root@salt-master ~]# salt '*' file.file_exists /etc/passwd　　
salt-minion02.contoso.com:
　　
    True
　　
salt-minion01.contoso.com:
　　
    True
　　11、file.find
　　file.find：返回指定搜索条件返回的文件路径，相当于Linux中的find命令，参数也兼容find命令。
[root@salt-master ~]# salt 'salt-minion01.contoso.com' file.find /var name=minion　　
salt-minion01.contoso.com:
　　
    - /var/cache/salt/minion
　　
    - /var/log/salt/minion
　　
    - /var/run/salt/minion
　　
[root@salt-master ~]# salt 'salt-minion01.contoso.com' file.find /var name=minion size=-1m
　　
salt-minion01.contoso.com:
　　
    - /var/cache/salt/minion
　　
    - /var/log/salt/minion
　　
    - /var/run/salt/minion
　　
[root@salt-master ~]# salt 'salt-minion01.contoso.com' file.find /var name=minion size=-1m print=path,size,mtime
　　
salt-minion01.contoso.com:
　　
    |_
　　
      - /var/cache/salt/minion
　　
      - 4096
　　
      - 1495711378
　　
    |_
　　
      - /var/log/salt/minion
　　
      - 1123
　　
      - 1496551874
　　
    |_
　　
      - /var/run/salt/minion
　　
      - 4096
　　
      - 1496544267
　　12、file.get_gid
　　file.get_gid：返回所给文件的属组的id。
[root@salt-master ~]# salt '*' file.get_gid /etc/passwd　　
salt-minion02.contoso.com:
　　
    0
　　
salt-minion01.contoso.com:
　　
    0
　　13、file.get_group
　　file.get_group：返回所给文件的属组。
[root@salt-master ~]# salt '*' file.get_group /etc/passwd　　
salt-minion02.contoso.com:
　　
    root
　　
salt-minion01.contoso.com:
　　
    root
　　14、file.get_uid
　　file.get_uid：返回所给文件的属主的id。
[root@salt-master ~]# salt '*' file.get_uid /etc/passwd　　
salt-minion01.contoso.com:
　　
    0
　　
salt-minion02.contoso.com:
　　
    0
　　15、file.get_user
　　file.get_user：返回所给文件的属主。
[root@salt-master ~]# salt '*' file.get_user /etc/passwd　　
salt-minion02.contoso.com:
　　
    root
　　
salt-minion01.contoso.com:
　　
    root
　　16、file.grep
　　file.grep：从指定文件中查找字符串，相当于Linux中的grep命令，参数也兼容grep命令。
[root@salt-master ~]# salt 'salt-minion01.contoso.com' file.grep /etc/passwd nobody　　
salt-minion01.contoso.com:
　　
    ----------
　　
    pid:
　　
        1858
　　
    retcode:
　　
        0
　　
    stderr:
　　
    stdout:
　　
        nobody:x:99:99:Nobody:/:/sbin/nologin
　　
        nfsnobody:x:65534:65534:Anonymous NFS User:/var/lib/nfs:/sbin/nologin
　　
[root@salt-master ~]# salt '*' file.grep /etc/sysconfig/network-scripts/ifcfg-eth0 ipaddr " -i"
　　
salt-minion01.contoso.com:
　　
    ----------
　　
    pid:
　　
        1896
　　
    retcode:
　　
        0
　　
    stderr:
　　
    stdout:
　　
        IPADDR=192.168.49.101
　　
salt-minion02.contoso.com:
　　
    ----------
　　
    pid:
　　
        1770
　　
    retcode:
　　
        0
　　
    stderr:
　　
    stdout:
　　
        IPADDR=192.168.49.102
　　17、file.makedirs
　　file.makedirs：创建目录，需要确认目录所包含的路径是可用的。注意，路径一定要在结尾添加“/”，不然会被当做父目录，比如如果传入/tmp/pfile，就会被当做/tmp/处理，而传入/tmp/pfile/则会当做/tmp/pfile/处理。另外，虽然该模块名称包含dirs，但其实无法批量创建多个目录，如果传入多个参数默认只处理第一个参数。但是可以创建多级目录，即使上级目录不存在。
[root@salt-master ~]# salt '*' file.makedirs /tmp/pfile　　
salt-minion01.contoso.com:
　　
    Directory '/tmp' already exists
　　
salt-minion02.contoso.com:
　　
    Directory '/tmp' already exists
　　
[root@salt-master ~]# salt '*' file.makedirs /tmp/pfile/
　　
salt-minion02.contoso.com:
　　
    None
　　
salt-minion01.contoso.com:
　　
    None
　　
[root@salt-master ~]# salt '*' cmd.run 'ls -l /tmp/'
　　
salt-minion01.contoso.com:
　　
    total 8
　　
    drwxr-xr-x 2 root root 4096 Jun  4 10:48 pfile
　　
    -rw-r--r-- 1 root root   73 Mar 11 21:35 root
　　
salt-minion02.contoso.com:
　　
    total 8
　　
    drwxr-xr-x 2 root root 4096 Jun  4 10:48 pfile
　　
    -rw------- 1 root root   89 May 25 13:32 root
　　
[root@salt-master ~]# salt '*' file.makedirs /tmp/dic1/dic2/dic3/
　　
salt-minion02.contoso.com:
　　
    None
　　
salt-minion01.contoso.com:
　　
    None
　　
[root@salt-master ~]# salt '*' cmd.run 'tree /tmp'
　　
salt-minion01.contoso.com:
　　
    /tmp
　　
    |-- dic1
　　
    |   `-- dic2
　　
    |       `-- dic3
　　
    |-- pfile
　　
    |-- root
　　
    `-- salt
　　

　　
    5 directories, 1 file
　　
salt-minion02.contoso.com:
　　
    /tmp
　　
    |-- dic1
　　
    |   `-- dic2
　　
    |       `-- dic3
　　
    |-- pfile
　　
    |-- root
　　
    `-- salt
　　

　　
    5 directories, 1 file
　　18、file.mkdir
　　file.mkdir：确认一个目录是可用的，也即创建指定目录。与file.makedirs不同的是，参数可以末尾不带“/”，也可以创建成功。另外，该模块支持批量创建多个目录，也支持创建多级目录。
[root@salt-master ~]# salt '*' file.mkdir /tmp/salt　　
salt-minion02.contoso.com:
　　
    None
　　
salt-minion01.contoso.com:
　　
    None
　　
[root@salt-master ~]# salt '*' cmd.run 'ls -l /tmp'
　　
salt-minion01.contoso.com:
　　
    total 12
　　
    drwxr-xr-x 2 root root 4096 Jun  4 10:48 pfile
　　
    -rw-r--r-- 1 root root   73 Mar 11 21:35 root
　　
    drwxr-xr-x 2 root root 4096 Jun  4 11:02 salt
　　
[root@salt-master ~]# salt '*' file.mkdir /tmp/salt1/slat2/salt3
　　
salt-minion02.contoso.com:
　　
    None
　　
salt-minion01.contoso.com:
　　
    None
　　
[root@salt-master ~]# salt '*' file.mkdir /tmp/test1 /tmp/test2 /tmp/test3
　　
salt-minion02.contoso.com:
　　
    None
　　
salt-minion01.contoso.com:
　　
    None
　　
[root@salt-master ~]# salt '*' file.mkdir /tmp/pfile/test
　　
salt-minion01.contoso.com:
　　
    None
　　
salt-minion02.contoso.com:
　　
    None
　　19、file.move
　　file.move：移动一个文件或目录。
[root@salt-master ~]# salt '*' file.move /tmp/pfile/test /tmp/salt01/　　
salt-minion01.contoso.com:
　　
    ----------
　　
    comment:
　　
        '/tmp/pfile/test' moved to '/tmp/salt01/'
　　
    result:
　　
        True
　　
salt-minion02.contoso.com:
　　
    ----------
　　
    comment:
　　
        '/tmp/pfile/test' moved to '/tmp/salt01/'
　　
    result:
　　
        True
　　20、file.remove
　　file.remove：删除文件。注意：该模块一次只能接受一个参数。
[root@salt-master ~]# salt '*' file.remove /tmp/dic1/　　
salt-minion02.contoso.com:
　　
    True
　　
salt-minion01.contoso.com:
　　
    True
　　
[root@salt-master ~]# salt '*' file.remove /tmp/test1/
　　
salt-minion02.contoso.com:
　　
    True
　　
salt-minion01.contoso.com:
　　
    True
　　21、file.rename
　　file.rename：重命名一个文件或目录。
[root@salt-master ~]# salt '*' file.rename /tmp/salt1 /tmp/salt01　　
salt-minion01.contoso.com:
　　
    True
　　
salt-minion02.contoso.com:
　　
    True
　　22、file.stats
　　file.stats：返回包含指定文件状态的词典。
[root@salt-master ~]# salt 'salt-minion01.contoso.com' file.stats /etc/passwd　　
salt-minion01.contoso.com:
　　
    ----------
　　
    atime:
　　
        1496464651.48
　　
    ctime:
　　
        1489237646.83
　　
    gid:
　　
        0
　　
    group:
　　
        root
　　
    inode:
　　
        394628
　　
    mode:
　　
        0644
　　
    mtime:
　　
        1489237646.82
　　
    size:
　　
        1465
　　
    target:
　　
        /etc/passwd
　　
    type:
　　
        file
　　
    uid:
　　
        0
　　
    user:
　　
        root
　　23、file.rmdir
　　file.rmdir：删除指定目录，如果目录不为空则返回失败。
[root@salt-master ~]# salt '*' file.rmdir /tmp/salt01　　
salt-minion02.contoso.com:
　　
    Directory not empty
　　
salt-minion01.contoso.com:
　　
    Directory not empty
　　
[root@salt-master ~]# salt '*' file.rmdir /tmp/salt
　　
salt-minion02.contoso.com:
　　
    True
　　
salt-minion01.contoso.com:
　　
    True
　　24、file.search
　　file.search：搜索pattern参数是否出现在指定文件中。
[root@salt-master ~]#  salt '*' file.search /etc/passwd 'nginx'　　
salt-minion02.contoso.com:
　　
    True
　　
salt-minion01.contoso.com:
　　
    True
　　
[root@salt-master ~]#  salt '*' file.search /etc/passwd 'test'
　　
salt-minion02.contoso.com:
　　
    False
　　
salt-minion01.contoso.com:
　　
    False
　　25、file.readdir
　　file.readdir：返回包含一个目录内容的列表。
[root@salt-master ~]# salt '*' file.readdir /tmp/pfile　　
salt-minion02.contoso.com:
　　
    - .
　　
    - ..
　　
    - test
　　
salt-minion01.contoso.com:
　　
    - .
　　
    - ..
　　
    - test