模板引擎 (Jinja2)

Ansible 使用 Jinja2 模板引擎实现动态表达式，并访问变量和事实。您可以使用template 模块进行模板化。例如，您可以为配置文件创建模板，然后将该配置文件部署到多个环境，并为每个环境提供正确的数据（IP 地址、主机名、版本）。您也可以直接在 playbook 中使用模板，例如对任务名称进行模板化等等。您可以使用Jinja2中包含的所有标准过滤器和测试。Ansible 包含其他专门用于选择和转换数据的过滤器、用于评估模板表达式的测试以及查找插件，用于从外部来源（例如文件、API 和数据库）检索数据以用于模板化。

所有模板化操作都在 Ansible 控制节点上完成，在任务发送到目标机器并执行**之前**。这种方法最大限度地减少了对目标机器的包要求（只有控制节点需要 jinja2）。它还限制了 Ansible 传递到目标机器的数据量。Ansible 在控制节点上解析模板，并且只将每个任务所需的信息传递到目标机器，而不是将控制节点上的所有数据都传递过去并在目标机器上进行解析。

注意

template 模块使用的文件和数据必须使用 utf-8 编码。

Jinja2 示例

在这个例子中，我们想将服务器主机名写入其 /tmp/hostname。

我们的目录如下所示

├── hostname.yml
├── templates
    └── test.j2

我们的 hostname.yml

---
- name: Write hostname
  hosts: all
  tasks:
  - name: write hostname using jinja2
    ansible.builtin.template:
       src: templates/test.j2
       dest: /tmp/hostname

我们的 test.j2

My name is {{ ansible_facts['hostname'] }}

另见

Ansible playbook: Playbook 简介
Playbook 提示: Playbook 提示和技巧
Jinja2 文档: Jinja2 文档，包括模板的语法和语义
沟通: 有问题？需要帮助？想分享你的想法？请访问 Ansible 沟通指南