### 在 Ansible 的 Jinja2 模板中使用列表变量 #### 列表变量的定义与应用 在 Ansible 中，可以通过 `vars` 定义一个列表类型的变量，并在 Jinja2 模板中对其进行操作。以下是具体的实现方式： 1. **定义列表变量** 在 Playbook 中定义一个包含多个元素的列表变量，例如服务端口列表或用户组列表： ```yaml --- - name: Example of using list variables in Jinja2 templates hosts: localhost vars: service_ports: [80, 443, 8080] user_groups: ["admin", "developer", "guest"] tasks: - name: Render a configuration file with list variables template: src: config_list.j2 dest: /tmp/config_with_lists.conf ``` 上述 Playbook 定义了两个列表变量：`service_ports` 和 `user_groups`[^1]。 2. **在 Jinja2 模板中遍历列表** 创建一个名为 `config_list.j2` 的模板文件，展示如何通过 `{% for %}` 循环结构处理这些列表变量： ```jinja Service Ports Configuration: {% for port in service_ports %} Port {{ loop.index }}: {{ port }} {% endfor %} User Groups Configuration: {% for group in user_groups %} Group {{ loop.index }}: {{ group }} {% endfor %} Total Number of Services: {{ service_ports | length }} Total Number of User Groups: {{ user_groups | length }} ``` 在此模板中： - 使用 `{% for ... %}` 结构逐一遍历列表中的每一项。 - 借助 `loop.index` 获取当前循环索引（从 1 开始计数）。 - 应用内置过滤器 `length` 计算列表长度[^4]。 3. **执行 Playbook 并查看结果** 执行以下命令以渲染模板并生成目标配置文件： ```bash ansible-playbook playbook.yml ``` 渲染后的 `/tmp/config_with_lists.conf` 文件可能如下所示： ``` Service Ports Configuration: Port 1: 80 Port 2: 443 Port 3: 8080 User Groups Configuration: Group 1: admin Group 2: developer Group 3: guest Total Number of Services: 3 Total Number of User Groups: 3 ``` --- #### 复杂场景下的列表操作 除了简单的遍历外，还可以结合条件判断或其他高级功能对列表进行筛选或转换。例如： ```jinja Allowed Ports (greater than 100): {% for port in service_ports if port > 100 %} Port {{ loop.index }}: {{ port }} {% endfor %} ``` 这段代码仅显示大于 100 的端口号[^3]。 或者将列表转为逗号分隔字符串： ```jinja Service Ports as CSV: {{ service_ports | join(", ") }} ``` 最终输出可能是这样的： ``` Service Ports as CSV: 80, 443, 8080 ``` --- ### 示例总结 通过上述示例可以看到，在 Jinja2 模板中使用列表变量非常灵活，支持多种操作如遍历、条件过滤以及格式化输出等。这使得动态生成复杂配置文件变得更加高效和便捷。 ---