### Ansible Template 模块使用示例 在 Ansible 中，`template` 模块用于将模板文件部署到远程主机，并通过 Jinja2 模板语言动态生成配置文件[^2]。以下是 `template` 模块的使用方法及示例。 #### 基本语法 ```yaml - name: 使用 template 模块生成配置文件 template: src: 源模板文件路径.j2 dest: 目标文件路径 owner: 文件所有者 group: 文件所属组 mode: 文件权限 ``` - **src**: 指定本地模板文件路径，通常为 `.j2` 后缀。 - **dest**: 指定远程主机上生成的目标文件路径。 - **owner**, **group**, **mode**: 可选参数，用于设置目标文件的所有者、组和权限。 #### 示例：动态生成 Nginx 配置文件 假设需要根据变量动态生成 Nginx 的配置文件，以下是一个完整的示例。 **1. 创建模板文件 `nginx.conf.j2`** ```nginx server { listen {{ nginx_port }}; server_name {{ server_name }}; location / { root {{ document_root }}; index index.html index.htm; } } ``` **2. 编写 Playbook** ```yaml --- - name: 动态生成 Nginx 配置文件 hosts: webservers vars: nginx_port: 80 server_name: example.com document_root: /var/www/html tasks: - name: 使用 template 模块生成 Nginx 配置 template: src: nginx.conf.j2 dest: /etc/nginx/nginx.conf owner: root group: root mode: '0644' ``` **3. 执行 Playbook** 运行以下命令以应用配置： ```bash ansible-playbook nginx_config.yml ``` 执行后，Ansible 将根据模板中的变量值动态生成 `/etc/nginx/nginx.conf` 文件。 #### 示例：条件判断与循环 Jinja2 支持条件判断和循环语句，增强模板的灵活性。以下是一个包含条件和循环的模板示例。 **模板文件 `example.conf.j2`** ```ini [settings] debug = {{ debug_mode | default('false') }} {% for user in users %} [user_{{ user.name }}] name = {{ user.name }} age = {{ user.age }} {% endfor %} ``` **Playbook** ```yaml --- - name: 动态生成配置文件 hosts: all vars: debug_mode: true users: - name: alice age: 25 - name: bob age: 30 tasks: - name: 使用 template 模块生成配置文件 template: src: example.conf.j2 dest: /etc/example.conf owner: root group: root mode: '0644' ``` 执行后生成的配置文件内容如下： ```ini [settings] debug = true [user_alice] name = alice age = 25 [user_bob] name = bob age = 30 ``` ### 注意事项 - 确保模板文件路径正确，并且文件扩展名为 `.j2`[^1]。 - 在模板中使用 Jinja2 语法时，注意变量名与 Playbook 中定义的变量一致[^2]。