目录

参数总结

返回值

基础语法

常见的命令行示例

示例1：检查文件是否存在

示例2：获取文件详细信息

示例3：检查目录是否存在

示例4：获取文件的 MD5 校验和

示例5：获取文件的 MIME 类型

高级使用

示例6：获取文件的 SHA256 校验和

带环境变量和特权操作

示例7：使用用户特权并设置环境变量

Playbook示例 

示例1：检查文件是否存在

示例2：检查目录是否存在

示例3：获取文件详细信息

示例4：条件任务执行

示例5：获取文件的 MD5 校验和

示例6：获取文件的 MIME 类型

示例7：获取文件的 SHA256 校验和

综合示例

---

 

Ansible 的 stat 模块用于获取文件或目录的状态信息。在执行任务之前检查文件或目录是否存在、获取文件的属性（如权限、所有者、大小、修改时间等）、验证路径是文件还是目录等方面非常有用。它可以用于条件检查、错误处理、决策分支等。

参数总结

1. path:

   • 描述：要获取状态信息的文件或目录的路径。
   • 类型：字符串
   • 必需：是

2. follow:

   • 描述：如果为 yes，则跟随符号链接。
   • 类型：布尔值
   • 默认值：no

3. get_md5:

   • 描述：如果为 yes，则计算文件的 MD5 校验和（仅适用于文件）。
   • 类型：布尔值
   • 默认值：no

4. checksum_algorithm:

   • 描述：指定用于计算校验和的算法（如果 get_checksum 为 yes）。
   • 可选值：md5、sha1、sha256
   • 类型：字符串
   • 默认值：sha1

5. get_checksum:

   • 描述：如果为 yes，则计算文件的校验和（默认算法为 sha1）。
   • 类型：布尔值
   • 默认值：no

6. checksum:

   • 描述：指定要使用的校验和算法的别名（仅适用于 md5 和 sha1），等价于 checksum_algorithm。
   • 类型：字符串
   • 默认值：无

返回值

stat 模块返回的结果是一个字典，包含了指定文件或目录的状态信息。常见的返回值包括：

• exists：如果文件或目录存在，则为 true，否则为 false。
• isdir：如果指定路径是目录，则为 true，否则为 false。
• isfile：如果指定路径是文件，则为 true，否则为 false。
• uid：文件或目录的所有者的用户 ID。
• gid：文件或目录的所有者的组 ID。
• size：文件大小（以字节为单位）。
• mtime：文件或目录的修改时间（时间戳）。
• atime：文件或目录的访问时间（时间戳）。
• ctime：文件或目录的创建时间（时间戳）。
• inode：文件或目录的 inode 号。
• device：文件或目录所在的设备号。

 

基础语法

ansible <hostname or group> -m stat -a "path=<file_or_directory_path> <additional_arguments>" [options]

常见的命令行示例

示例1：检查文件是否存在

ansible all -m stat -a "path=/tmp/sample.txt" --become

上述命令会检查 /tmp/sample.txt 文件是否存在，--become 选项用于以特权执行。

示例2：获取文件详细信息

ansible all -m stat -a "path=/tmp/sample.txt" -v

-v 选项用于启用详细输出，以显示文件的详细状态信息。

示例3：检查目录是否存在

ansible all -m stat -a "path=/tmp/sample_dir" --become

此命令会检查 /tmp/sample_dir 目录是否存在。

示例4：获取文件的 MD5 校验和

ansible all -m stat -a "path=/tmp/sample.txt get_md5=yes" --become

此命令会获取 /tmp/sample.txt 文件的 MD5 校验和。

示例5：获取文件的 MIME 类型

ansible all -m stat -a "path=/tmp/sample.txt get_mime=yes" --become

此命令会获取 /tmp/sample.txt 文件的 MIME 类型信息。

高级使用

结合多个参数完成更复杂的操作：

示例6：获取文件的 SHA256 校验和

ansible all -m stat -a "path=/tmp/sample.txt checksum_algorithm=sha256" --become

此命令会获取 /tmp/sample.txt 文件的 SHA256 校验和。

带环境变量和特权操作

示例7：使用用户特权并设置环境变量

ansible all -m stat -a "path=/tmp/sample.txt" --become --extra-vars "ansible_user=your_user ansible_password=your_password"

 

Playbook示例 

示例1：检查文件是否存在

---
- name: Check if a file existshosts: alltasks:- name: Check file existencestat:path: /tmp/sample.txtregister: file_stat- name: Display file existencedebug:msg: "File exists: {{ file_stat.stat.exists }}"

示例2：检查目录是否存在

---
- name: Check if a directory existshosts: alltasks:- name: Check directory existencestat:path: /tmp/sample_dirregister: dir_stat- name: Display directory existencedebug:msg: "Directory exists: {{ dir_stat.stat.isdir }}"

示例3：获取文件详细信息

---
- name: Get file detailed informationhosts: alltasks:- name: Get file statusstat:path: /tmp/sample.txtregister: file_stat- name: Display file detailsdebug:var: file_stat.stat

示例4：条件任务执行

根据文件的存在性执行条件任务：

---
- name: Conditional tasks based on file existencehosts: alltasks:- name: Check if a file existsstat:path: /tmp/sample.txtregister: file_stat- name: Create file if not existsfile:path: /tmp/sample.txtstate: touchwhen: not file_stat.stat.exists

示例5：获取文件的 MD5 校验和

---
- name: Get file MD5 checksumhosts: alltasks:- name: Check file status with MD5stat:path: /tmp/sample.txtget_md5: yesregister: file_stat- name: Display MD5 checksumdebug:msg: "File MD5 checksum: {{ file_stat.stat.md5 }}"

示例6：获取文件的 MIME 类型

---
- name: Get file MIME typehosts: alltasks:- name: Get file status with MIME typestat:path: /tmp/sample.txtget_mime: yesregister: file_stat- name: Display MIME typedebug:msg: "File MIME type: {{ file_stat.stat.mime_type }}"

示例7：获取文件的 SHA256 校验和

---
- name: Get file SHA256 checksumhosts: alltasks:- name: Check file status with SHA256 checksumstat:path: /tmp/sample.txtchecksum_algorithm: sha256register: file_stat- name: Display SHA256 checksumdebug:msg: "File SHA256 checksum: {{ file_stat.stat.checksum }}"

综合示例

结合多个参数和任务的示例：

---
- name: Comprehensive example of stat usagehosts: alltasks:- name: Check if a file exists and get detailsstat:path: /tmp/sample.txtget_md5: yesget_mime: yeschecksum_algorithm: sha256register: file_stat- name: Display file detailsdebug:var: file_stat.stat- name: Create file if not existsfile:path: /tmp/sample.txtstate: touchwhen: not file_stat.stat.exists- name: Display MD5 checksum if file existsdebug:msg: "File MD5 checksum: {{ file_stat.stat.md5 }}"when: file_stat.stat.exists- name: Display MIME type if file existsdebug:msg: "File MIME type: {{ file_stat.stat.mime_type }}"when: file_stat.stat.exists- name: Display SHA256 checksum if file existsdebug:msg: "File SHA256 checksum: {{ file_stat.stat.checksum }}"when: file_stat.stat.exists