• 语法格式：

template:
  src: 模板文件路径
  dest: 目标文件路径
  owner: 文件所有者
  group: 文件所属组
  mode: 文件权限
  backup: 是否备份原文件

• 标准目录结构：

project/
├── playbook.yml          # Playbook文件
├── templates/            # 模板目录（必须）
│   └── nginx.conf.j2     # 模板文件（.j2后缀）
└── inventory             # 主机清单

• Playbook加载：Ansible加载并解析Playbook文件，识别所有任务
• 模板任务识别：发现template类型的任务
• 模板文件读取：从templates目录读取指定的.j2模板文件
• Jinja2语法解析：解析模板中的Jinja2语法结构
• 变量替换：将模板中的变量占位符替换为实际值
• 配置文件生成：生成最终的配置文件内容
• 文件比较：比较生成的配置与目标主机上的文件内容
• 备份决策：根据backup参数决定是否备份原文件
• 文件复制：将生成的配置文件复制到目标路径
• 属性设置：设置文件所有者、组、权限等属性
• Handler触发：如果配置文件发生变更，触发关联的Handler
• 结果收集：收集所有任务的执行结果
• 报告生成：生成详细的执行报告

• 相对路径：

- name: 使用相对路径
  template: 
    src: nginx.conf.j2 
    dest: /etc/nginx/nginx.conf

• 绝对路径：

- name: 使用绝对路径
  template: 
    src: /path/to/templates/nginx.conf.j2 
    dest: /etc/nginx/nginx.conf

• 权限设置：

- name: 设置文件权限
  template: 
    src: config.j2 
    dest: /etc/app/config
    mode: '0600'          # 所有者读写
    owner: root
    group: root

• 备份策略：

- name: 备份原文件
  template: 
    src: config.j2 
    dest: /etc/app/config
    backup: yes           # 创建备份文件
    backup_file: config.bak  # 自定义备份文件名

• 基于条件渲染：

- name: 条件渲染模板
  template: 
    src: "{{ template_file }}" 
    dest: /etc/app/config
  vars:
    template_file: "config_{{ env }}.j2"

• 模板继承：

<!-- base_config.j2 -->
server {
    listen {{ http_port }};
    server_name {{ server_name }};
    
    {% block content %}
    <!-- 默认内容 -->
    {% endblock %}
}

<!-- production_config.j2 -->
{% extends "base_config.j2" %}

{% block content %}
    location / {
        proxy_pass http://backend;
    }
{% endblock %}

• 模板包含：

<!-- main_config.j2 -->
server {
    include /etc/nginx/conf.d/*.conf;
}

<!-- vhost.conf -->
location /app {
    proxy_pass http://app_backend;
}

• 模块化设计：

<!-- 将通用配置抽取为公共模板 -->
{% include "common_headers.conf" %}
{% include "common_logging.conf" %}

• 变量组织：

<!-- 使用清晰的变量命名 -->
{{ nginx_http_port }}
{{ nginx_worker_processes }}
{{ nginx_max_connections }}

• 注释规范：

<!-- 添加模板说明 -->
{# 
  Template: nginx_vhost.conf.j2
  Purpose: 生成Nginx虚拟主机配置
  Variables: server_name, port, root_path
#}

• 减少模板复杂度：

<!-- 避免过深的嵌套 -->
{% if condition1 %}
  {% if condition2 %}
    {% if condition3 %}
      content
    {% endif %}
  {% endif %}
{% endif %}

<!-- 使用逻辑运算符简化 -->
{% if condition1 and condition2 and condition3 %}
  content
{% endif %}

• 合理使用缓存：

- name: 使用模板缓存
  template: 
    src: config.j2 
    dest: /etc/app/config
    validate: nginx -t -c %s  # 验证配置

• 文件权限控制：

- name: 设置安全权限
  template: 
    src: sensitive_config.j2 
    dest: /etc/app/sensitive.conf
    mode: '0600'          # 仅所有者可读写
    owner: root
    group: root

• 敏感信息处理：

<!-- 使用Ansible Vault加密敏感变量 -->
database_password: "{{ vault_db_password }}"

<!-- 在模板中安全使用 -->
password: {{ database_password | default('') }}