基础设施即代码 / 系统课时
管理文件、目录与权限
管理文件、目录与权限
这节课把 Linux 路径管理从零散的 mkdir、chmod、ln 和复制命令,转换成可重复执行的 Ansible 状态声明。完成后,你能统一维护目录、文件内容、所有者、权限、符号链接和废弃路径,并用断言验证结果。
学习目标
- 使用
ansible.builtin.file管理目录、链接、权限和路径删除 - 使用
ansible.builtin.copy部署静态文件并同时约束元数据 - 通过
stat与assert验证文件状态是否符合预期
把路径描述成目标状态
ansible.builtin.file 负责文件系统对象及其属性,常见的 state 包括 directory、link、touch 和 absent。它适合创建目录、建立符号链接、修改已有路径的所有者与权限,以及删除不应继续存在的路径。
部署静态文件时使用 ansible.builtin.copy 更直接,因为内容与 owner、group、mode 可以在同一个任务中收敛。需要根据变量渲染文件内容时,应改用 ansible.builtin.template,不要先用 Shell 拼接文本再复制。
权限建议始终写成带引号的字符串,例如 "0644" 和 "0755"。这样既清楚表达 Unix 权限位,也避免 YAML 数值解析带来的歧义。
一次收敛目录、文件与符号链接
下面的 Playbook 创建应用目录和发布目录,部署一个静态配置文件,把 current 链接指向当前发布版本,并删除旧配置。最后用 stat 和 assert 对关键结果做机器可判定的验收。
---
- name: Standardize application paths
hosts: linux_hosts
become: true
gather_facts: false
vars:
app_root: /opt/example-app
release_dir: /opt/example-app/releases/v1
tasks:
- name: Ensure application root exists
ansible.builtin.file:
path: "{{ app_root }}"
state: directory
owner: root
group: root
mode: "0755"
- name: Ensure release directory exists
ansible.builtin.file:
path: "{{ release_dir }}"
state: directory
owner: root
group: root
mode: "0755"
- name: Deploy static application config
ansible.builtin.copy:
dest: /etc/example-app.conf
owner: root
group: root
mode: "0644"
content: |
app_name=example-app
log_dir=/var/log/example-app
- name: Point current link at the active release
ansible.builtin.file:
src: "{{ release_dir }}"
dest: "{{ app_root }}/current"
state: link
- name: Remove obsolete configuration
ansible.builtin.file:
path: /etc/example-app.conf.old
state: absent
- name: Read deployed config metadata
ansible.builtin.stat:
path: /etc/example-app.conf
register: app_config
- name: Verify deployed config
ansible.builtin.assert:
that:
- app_config.stat.exists
- app_config.stat.mode == "0644"
- app_config.stat.pw_name == "root"
- app_config.stat.gr_name == "root"配置文件是静态内容,因此这里使用 copy.content。如果文件包含环境名、端口或主机列表等变量,应把内容移入 Jinja2 模板并使用 template 模块,以便把渲染逻辑与任务定义分开。
执行 Playbook:
ansible-playbook -i inventory.ini host-files.yml --diff预期输出:
PLAY RECAP *********************************************************************
<HOST> : ok=<VALUE> changed=<VALUE> unreachable=0 failed=0 skipped=0实际主机名和计数可能不同。只要断言通过,failed=0;第一次执行可能创建或修改路径,再次以相同输入执行时通常应收敛到 changed=0。
谨慎处理递归权限和删除
目录权限最容易出现“修过头”的问题。对目录使用 recurse: true 会把属性递归应用到已有内容,若目录里同时包含可执行文件、普通数据文件和密钥,统一设置同一个 mode 往往会破坏原本合理的权限差异。更安全的方式是分别声明关键目录和关键文件的状态,只在你确定整棵目录树应该共享属性时才递归修改。
state: absent 对目录同样具有破坏性:目标是目录时会移除其中内容。删除任务应使用明确、稳定的绝对路径,路径值来自变量时先检查变量来源,避免空值、拼接错误或环境变量串线。
选择 file、copy 还是 template
当你只关心路径是否存在、类型是否正确以及权限归属时,用 file;当你要把控制节点上的静态文件或固定内容部署到目标机时,用 copy;当文件内容依赖 Ansible 变量时,用 template。三者都能管理部分元数据,但职责不同,按内容来源选择模块会让 Playbook 更容易审查和复用。
如果某个文件由软件包管理器维护,不要同时用 copy 强行覆盖,除非你明确接受包升级与 Ansible 之间的所有权冲突。先确定“谁是这个文件的唯一配置来源”,再让自动化持续维护它,才能真正获得可预测的幂等结果。