基础设施即代码 / 系统课时

管理文件、目录与权限

管理文件、目录与权限

这节课把 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 对关键结果做机器可判定的验收。

yaml
---
- 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:

bash
ansible-playbook -i inventory.ini host-files.yml --diff

预期输出:

text
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 之间的所有权冲突。先确定“谁是这个文件的唯一配置来源”,再让自动化持续维护它,才能真正获得可预测的幂等结果。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

管理文件、目录与权限

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通