模板 (Jinja2)

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

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

注意

模板模块使用的文件和数据必须使用 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 沟通指南