16：将文件部署到受管主机-2 使用Jinja2模板部署自定义文件

type

status

date

slug

summary

1. Jinja2 模板简介

Jinja2 是一种用于生成模板文件的语法，通常与 Ansible 配合使用。通过它可以自动为受管主机生成自定义配置文件。这样可以减少出错几率，更便于集中管理配置文件。

变量引用：Jinja2 中的变量用 {{ }} 包裹。例如，{{ ansible_facts['default_ipv4']['address'] }} 可以获取主机的 IP 地址。

2. 模板文件示例

模板文件一般以 .j2 作为文件扩展名，便于识别。以下是一个 SSH 配置文件的模板示例：

3. 部署模板

使用 Ansible 的 ansible.builtin.template 模块可以将模板文件部署到目标主机。例如：

4. 控制结构

循环：可以使用 {% for %} 来遍历变量。例如：

条件判断：可以使用 {% if %} 添加条件判断。例如：

5. 过滤器

Jinja2 提供了过滤器功能，例如 to_json 可以将变量转换为 JSON 格式，to_yaml 将变量转换为 YAML 格式，方便生成不同格式的输出。

6. 模板管理

ansible_managed 可以添加注释以提醒其他管理员此文件是 Ansible 管理的，避免手动修改。例如：

7. 示例 Playbook

以下是一个部署 /etc/hosts 文件的示例 Playbook，它使用了 for 循环来生成所有主机的信息：

模板文件 hosts.j2 可能如下：

以上内容展示了如何在 Ansible 中利用 Jinja2 创建动态模板文件、使用条件和循环控制结构生成配置文件，从而简化配置管理的流程。

练习：

使用 Ansible 和 Jinja2 配置 MOTD 文件模板

我们将使用 Ansible 和 Jinja2 模板自动化配置受管主机的 /etc/motd 文件（Message of the Day）。Ansible 和 Jinja2 的结合可以轻松实现模板化的配置文件管理，提高配置的灵活性和可维护性。

1. 环境准备

我们将在 /home/student/file-template 目录下创建文件来配置和测试这个 Ansible 模板示例。

2. 定义 Inventory 文件

在 Ansible 中，inventory 文件用于定义目标主机，这样 Playbook 能够知道配置目标。

这里，我们将 servera.lab.example.com 添加到 webservers 组，而 workstation.lab.example.com 添加到 workstations 组。这样可以实现分组管理。

3. 创建 Jinja2 模板文件 (`motd.j2`)

接下来，我们创建一个 Jinja2 模板文件 motd.j2，这个文件包含我们希望在 /etc/motd 中显示的内容。使用 Jinja2 的模板语法可以动态填充主机信息。

模板中的 {{ ansible_facts['fqdn'] }} 和 {{ ansible_facts['distribution'] }} 等变量会自动替换成目标主机的实际信息，使模板更加灵活。

4. 编写 Ansible Playbook (`motd.yml`)

在 Ansible 中，Playbook 是任务的集合，用于定义要在主机上执行的操作。我们编写一个简单的 Playbook motd.yml，来渲染 motd.j2 模板，并将其部署到目标主机。

在 vars 部分定义了 system_owner 变量，这样可以在模板中引用 {{ system_owner }}，实现动态替换。tasks 部分中使用 ansible.builtin.template 模块将模板部署到 /etc/motd。

5. 执行和验证

在创建了 inventory、motd.j2 模板文件和 motd.yml Playbook 后，开始执行以下步骤。

(1) 语法检查

运行 --syntax-check 参数可以检查 Playbook 语法是否正确。

如果语法正确，Ansible 会显示通过检查的消息。

(2) 执行 Playbook

运行 Playbook 将模板渲染为配置文件并部署到目标主机。

(3) 验证配置

SSH 登录到目标主机，并检查 /etc/motd 文件内容是否符合预期。

输出内容应与模板文件一致，并包含自动填充的系统信息，例如完全限定域名、系统发行版及版本号等。

6. 总结

我们使用了 Ansible 和 Jinja2 创建并部署动态生成的 /etc/motd 文件。通过模板化的配置文件管理，不仅提升了自动化程度，还使配置文件更灵活。利用 Ansible 和 Jinja2 的强大组合，我们可以轻松管理和更新大量主机的配置文件，避免手动操作带来的错误和工作量。