模板 (Jinja2)

Ansible 使用 Jinja2 模板引擎实现动态表达式以及对变量和事实的访问。可以使用template 模块进行模板化。例如，可以为配置文件创建一个模板，然后将该配置文件部署到多个环境，并为每个环境提供正确的数据（IP 地址、主机名、版本）。也可以直接在剧本中使用模板化，对任务名称等进行模板化。可以使用 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 剧本

剧本简介

剧本技巧

剧本技巧和窍门

Jinja2 文档

Jinja2 文档，包括模板的语法和语义

沟通

有问题？需要帮助？想分享你的想法？请访问 Ansible 沟通指南