（必需）

path告诉Ansible你要操作的文件或目录的具体位置。

要管理的文件的路径。如果在默认位置/etc/ansible/下可以只写文件名。

absent：确保文件或目录不存在。如果文件或目录存在，则删除它们。

directory：确保目录存在。如果目录不存在，则创建它。如果目录已经存在，则不会执行任何操作。

file：确保文件存在。如果文件不存在，则创建它。如果文件已经存在，则不会执行任何操作。

hard：确保硬链接存在。如果硬链接不存在，则创建它。如果硬链接已经存在，则不会执行任何操作。

link：确保符号链接存在。如果符号链接不存在，则创建它。如果符号链接已经存在，则不会执行任何操作。

present：确保文件或目录存在。如果文件或目录不存在，则创建它们。如果文件或目录已经存在，则不会执行任何操作。这是默认值。

指定文件的权限。

前两位控制所有者权限，中间两位控制所属组权限，最后两位控制其他人权限。每一位可以是0、1、2、3、4、5、6、7，分别对应无权限、执行权限、写权限、写+执行权限、只读权限、读+执行权限、读+写权限、读+写+执行权限。

指定文件所有者。

注意事项

• 确保指定的用户名存在于系统中，否则Ansible会在执行时失败。
• 当使用sudo或become特性以提升权限执行Ansible任务时，必须确保有权限更改指定文件或目录的所有权。
• 如果同时需要改变组所有权，可以结合使用group选项。

指定文件所属用户组。

注意事项

• 确保指定的用户组名存在于系统中，否则Ansible执行任务时会遇到错误。
• 使用sudo或become提升权限执行Ansible任务时，需确保有权限修改文件或目录的组所有权。
• 可以与owner选项一起使用，以同时改变文件或目录的所有者和所属组。

文件绝对路径

默认路径在/etc/ansible/下

用途：指定要复制的源文件路径。

当使用state参数为link、hard、copy或template时，src参数是必需的。

它可以是一个本地文件路径或远程URL。

如果src参数是一个文件路径，则可以使用相对路径或绝对路径。

默认位置在/etc/ansible/下。

指定了文件  [  复制 |  或模板  ]  输出后在远程主机上的存放位置。

默认位置在/etc/ansible/下。

用途：指定文件复制或生成的目标路径。

当使用state参数为link、hard、copy、move、template或absent时，dest参数是必需的。

是看选用模块如copy所意思就是复制到远程主机的位置是哪里。

如果dest参数是一个文件路径，则可以使用相对路径或绝对路径。

覆盖写入，yes为覆盖，no不覆盖。

1. 在file模块中，直接使用force选项的场景较少见，因为该模块更多是用于改变文件或目录的基本属性，而非内容替换。对于文件内容的复制，通常会用到copy模块，而在该模块中，force参数更常见且实用。
2. 当使用copy或其他涉及文件内容操作的模块时，考虑是否真的需要强制覆盖现有文件，以避免不必要的数据丢失。

注意事项：

force参数用于指定是否强制覆盖目标文件或目录。

当force参数设置为true时，如果目标文件或目录已经存在，Ansible会强制覆盖它。如果目标文件或目录不存在，则会创建它。

当force参数设置为false时，如果目标文件或目录已经存在，Ansible不会进行任何更改。如果目标文件或目录不存在，则会创建它。

follow参数用于指定是否跟随符号链接。

• 作用：当设置为yes时，Ansible会跟随符号链接并对其指向的目标文件或目录执行操作。如果设置为no，Ansible则直接对符号链接本身进行操作，而不是它的目标。

参数用于设置或修改文件的访问时间。

access_time参数可以接受以下几种格式的值：

• Unix时间戳（以秒为单位）：可以使用整数值来表示特定的时间。
• 绝对日期和时间：可以使用ISO 8601格式（例如2022-01-01T12:00:00Z）或其他常用日期格式来指定时间。
• 相对时间：可以使用+或-符号来指定相对于当前时间的偏移量，例如+1h表示将访问时间设为当前时间后的1小时。

参数用于指定access_time参数值的日期和时间格式。access_time_format参数的值为"unix"，即将access_time参数值解释为Unix时间戳（以秒为单位）。

常见的access_time_format参数值及其对应的日期和时间格式：

• "iso8601"：使用ISO 8601格式表示日期和时间（例如"2022-01-01T12:00:00Z"）。
• "short"：使用短日期和时间格式表示（例如"2022-01-01"或"12:00:00"）。
• "long"：使用长日期和时间格式表示（例如"January 1, 2022"或"12:00:00 PM"）。

参数用于设置文件或目录的属性。

attributes参数的值应该是一个字符串，由以下字符组成：

• "a"表示只能追加写入文件。
• "b"表示将文件内容存储为二进制格式。
• "c"表示将文件内容压缩。
• "d"表示当访问到达文件结尾时，将其作为目录。
• "e"表示删除文件时不要将其关闭。
• "f"表示将文件视为固定长度记录。
• "i"表示文件内容不可修改。
• "l"表示文件为符号链接。
• "n"表示当写入文件时，文件指针不追加到文件末尾。
• "p"表示文件为FIFO（命名管道）。
• "r"表示文件可读取。
• "s"表示文件为套接字。
• "t"表示文件是字节流文本文件。
• "u"表示文件有未高速缓冲区的同步更新。
• "w"表示文件可写入。
• "x"表示文件可执行。

可以组合一起使用。

参数用于设置文件或目录的修改时间。

修改时间（modification time）指的是文件或目录最后一次被修改的时间戳。在Ansible中，modification_time参数可以用来设置文件或目录的修改时间。

modification_time参数的值可以是一个绝对时间戳，也可以是一个相对时间。绝对时间戳是一个特定的日期和时间，而相对时间是相对于当前时间的偏移量。

用于设置文件或目录修改时间的格式。

允许指定修改时间的格式，以便将时间字符串解析为正确的时间戳。它支持的格式与Python的strftime格式化字符串相同。

用于指定是否递归地处理目录。

当使用file模块操作目录时，可以通过设置recurse参数来控制是否递归地处理目录中的文件和子目录。recurse参数的取值为布尔类型，即True或False，默认为False。

当recurse参数设置为True时，file模块会递归地处理目录中的所有文件和子目录。这意味着，无论在操作文件还是目录时，都会对目录及其内容进行相应操作。

• selevel：设置SELinux安全级别的部分，如s0。
• serole：设置SELinux角色，如system_r。
• setype：设置SELinux类型，这是最具体的分类，如httpd_sys_content_t。
• seuser：设置SELinux用户上下文，如system_u。

用于指定SELinux安全策略的级别。

在SELinux中，每个文件和进程都有一个安全上下文（Security Context），用于控制其访问权限。selevel参数用于指定要应用的SELinux安全策略的级别。

selevel参数的取值可以是一个字符串，表示安全策略的级别，也可以是一个变量，根据需要动态设置安全策略级别。