如何避免Ansible对含{{的变量强制使用Jinja2模板渲染？

问题场景 #

当通过set_fact设置包含{{子串的变量后，变量本身能正常生成，但在debug任务的when条件中使用toto == toto这类表达式时，会触发Jinja2模板渲染错误——Jinja2会尝试解析变量中的{{标记，即使变量值已经是固定字符串。

直接赋值时用!unsafe指令可以解决问题，但通过lookup从文件读取内容时，直接在!unsafe后包裹lookup会导致变量值变成lookup('file', 'xxx')字符串，而非文件实际内容。

解决方案 #

方法1：利用set_fact的unsafe参数（推荐） #

Ansible 2.9及以上版本的set_fact模块支持unsafe参数，可直接将变量标记为“无需二次渲染”，同时不影响lookup的执行逻辑：

- hosts: localhost
  tasks:
    - set_fact:
        toto: "{{ lookup('file', 'test.txt') }}"
        unsafe: yes
    - debug:
        msg: "toto的值是 {{ toto }}"
      when: toto == toto

该参数会把lookup获取的文件内容直接标记为不安全字符串，避免Jinja2在when条件中对其进行二次解析，既保留了原始的{{子串，又不会触发渲染错误。

方法2：临时启用jinja2_native配置 #

在Playbook级别临时开启jinja2_native，让Jinja2使用原生Python类型处理变量，避免对已存储的字符串进行自动解析：

- hosts: localhost
  vars:
    ansible_jinja2_native: yes
  tasks:
    - set_fact:
        toto: "{{ lookup('file', 'test.txt') }}"
    - debug:
        msg: "toto的值是 {{ toto }}"
      when: toto == toto

注意：此配置会改变整个Play的Jinja2行为，若其他任务依赖默认渲染逻辑，需谨慎使用。

方法3：用quote过滤器转义内容（仅适用于无需保留原始{{的场景） #

如果不需要保留变量中的{{子串，可通过quote过滤器转义特殊字符，避免渲染错误：

- hosts: localhost
  tasks:
    - set_fact:
        toto: "{{ lookup('file', 'test.txt') | quote }}"
    - debug:
        msg: "toto的值是 {{ toto }}"
      when: toto == toto

此方法会将{{转义为{{，若业务需要保留原始的{{标记，不建议使用。

内容的提问来源于stack exchange，提问作者Orabïg