模板 (Jinja2)

Ansible 使用 Jinja2 模板引擎来启用动态表达式并访问变量 和facts。您可以使用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 沟通指南