如何在Ansible Playbook中识别环境变量是否未设置

方法一：利用ansible_env事实变量 #

Ansible默认会收集目标主机的环境变量到ansible_env字典中，这个字典仅包含实际已设置的环境变量。如果环境变量未被设置，它不会出现在ansible_env的键列表里；如果被设置为空字符串，则会存在于字典中且值为空。

使用这个特性可以准确判断变量是否未设置：

- name: 检测FOO是否未设置
  ansible.builtin.debug:
    msg: "FOO is unset!"
  when: "'FOO' not in ansible_env"

方法二：通过Python lookup直接查询 #

如果你的Playbook禁用了事实收集，可以直接调用Python的os.environ来判断，因为os.environ仅包含已存在的环境变量：

- name: 检测FOO是否未设置（无需事实收集）
  ansible.builtin.debug:
    msg: "FOO is unset!"
  when: >
    q('python', 'import os; print("UNSET" if "FOO" not in os.environ else "SET")') == "UNSET"

为什么之前的尝试失败？ #

你尝试用default=None的方式在Jinja模板中无法生效，因为Jinja不识别Python的None关键字。而设置default=Undefined会触发Playbook报错，因为Ansible不允许将未定义值作为lookup的返回结果。上述两种方法则可以完美区分「变量未设置」和「变量被设为空字符串」的场景。

内容的提问来源于stack exchange，提问作者Roddy of the Frozen Peas