ansible之file模块

22343213 · 发表于 2016-5-3 09:14:03

file用法选项

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

[iyunv@ansible ~]# ansible-doc -s file
less 436
Copyright (C) 1984-2009 Mark Nudelman
less comes with NO WARRANTY, to the extent permitted by law.
For information about the terms of redistribution,
see the file named README in the less distribution.
Homepage: http://www.greenwoodsoftware.com/less
- name: Sets attributes of files
  action: file
   follow                # This flag indicates that filesystem links, if they exist, should be followed.
   force                # force the creation of the symlinks in two cases: the source file does not exist (but will appear
                           later); the destination exists and is a file (so, we need to
                           unlink the "path" file and create symlink to the "src" file in
                           place of it).
   group                # name of the group that should own the file/directory, as would be fed to `chown'
   mode                # mode the file or directory should be. For those used to `/usr/bin/chmod' remember that modes are
                           actually octal numbers (like 0644). Leaving off the leading zero
                           will likely have unexpected results. As of version 1.8, the mode
                           may be specified as a symbolic mode (for example, `u+rwx' or
                           `u=rw,g=r,o=r').
   owner                # name of the user that should own the file/directory, as would be fed to `chown'
   path=                # path to the file being managed.  Aliases: `dest', `name'
   recurse             # recursively set the specified file attributes (applies only to state=directory)
   selevel             # level part of the SELinux file context. This is the MLS/MCS attribute, sometimes known as the
                           `range'. `_default' feature works as for `seuser'.
   serole                # role part of SELinux file context, `_default' feature works as for `seuser'.
   setype                # type part of SELinux file context, `_default' feature works as for `seuser'.
   seuser                # user part of SELinux file context. Will default to system policy, if applicable. If set to
                           `_default', it will use the `user' portion of the policy if
                           available
   src                   # path of the file to link to (applies only to `state=link'). Will accept absolute, relative and
                           nonexisting paths. Relative paths are not expanded.
   state                # If `directory', all immediate subdirectories will be created if they do not exist, since 1.7 they
                           will be created with the supplied permissions. If `file', the file
                           will NOT be created if it does not exist, see the [copy] or
                           [template] module if you want that behavior.  If `link', the
                           symbolic link will be created or changed. Use `hard' for
                           hardlinks. If `absent', directories will be recursively deleted,
                           and files or symlinks will be unlinked. If `touch' (new in 1.4),
                           an empty file will be created if the `path' does not exist, while
                           an existing file or directory will receive updated file access and
                           modification times (similar to the way `touch` works from the
                           command line).

模块选项

force：需要在两种情况下强制创建软链接，一种是源文件不存在但之后会建立的情况下；另一种是目标软链接已存在,需要先取消之前的软链，然后创建新的软链，有两个选项：yes|no

group：定义文件/目录的属组

mode：定义文件/目录的权限

owner：定义文件/目录的属主

path：必选项，定义文件/目录的路径

recurse：递归的设置文件的属性，只对目录有效

src：要被链接的源文件的路径，只应用于state=link的情况

dest：被链接到的路径，只应用于state=link的情况

state：

directory：如果目录不存在，创建目录

file：即使文件不存在，也不会被创建