Ansible角色中静态资源必须统一存于files/目录，仅支持扁平结构，通过copy模块引用；禁止混放templates/、tasks/等目录或使用绝对路径。

在 Ansible 角色中规范化静态资源目录，核心是严格遵循 roles 目录约定，把静态文件统一放在 files/ 子目录下，并通过 copy 或 template 模块引用——不能直接写绝对路径或混放其他位置。

files/ 是唯一存放静态资源的合法目录

Ansible 明确规定：所有无需渲染、原样复制到目标主机的文件（如二进制包、配置样例、脚本、证书、图片等），必须放入角色根目录下的 files/ 子目录。该目录下不支持子目录嵌套（除非你手动在任务里指定相对路径），结构应扁平清晰：

• roles/myapp/files/nginx.conf
• roles/myapp/files/app.jar
• roles/myapp/files/start.sh

调用时直接写文件名，Ansible 会自动从 files/ 下查找：

- name: Copy startup script
  copy:
    src: start.sh
    dest: /opt/myapp/start.sh

避免常见错位操作

静态资源绝不能放在以下位置，否则无法被正确识别：

Obsidian (Linux)

操作 Obsidian 库（纯 Markdown 笔记），并通过 notesmd-cli 实现自动化。

下载

• ❌ 放在 templates/：那是给 .j2 模板用的，用于变量替换；放普通文件会导致报错或内容被错误解析
• ❌ 放在 tasks/ 或 vars/：这些目录只接受 YAML 文件，放二进制或文本会破坏语法或引发读取失败
• ❌ 放在角色外的任意路径（如 ./static/）：Ansible 不会跨角色搜索，src 路径不支持向上跳转（如 ../static/app.jar）

配合 inventory 和权限做适配

若不同环境需要不同版本的静态文件（如测试用 demo.jar、生产用 release.jar），不要靠改文件名硬编码，而是用变量区分：

• 在 vars/main.yml 或 group_vars/ 中定义：
  app_jar_name: "{{ 'demo.jar' if env == 'test' else 'release.jar' }}"
• 任务中引用：
  src: "{{ app_jar_name }}"

同时注意目标路径权限：静态文件复制后常需设置属主和执行权限，建议在 copy 任务中一并声明：

- name: Deploy executable script
  copy:
    src: start.sh
    dest: /opt/myapp/
    owner: appuser
    group: appgroup
    mode: '0755'

验证是否生效的快捷方式

执行前可用 ansible-playbook --list-tasks 确认任务是否加载成功；执行时加 -v 查看 src 实际解析路径；若报 file not found，90% 是因为文件没放对位置或拼写大小写错误（Linux 区分大小写）。