Ansible任务环境变量引用问题：命令内调用失败原因排查

在Ansible任务中引用环境变量时遇到如下问题：

• 通过lookup('env', 'ARCHIVE_NAME')定义的变量，能在ansible.builtin.git模块的archive参数正常使用；
• 但直接使用ansible_env.ARCHIVE_NAME时则无效；
• 在command模块的scp命令中直接引用ansible_env.ARCHIVE_NAME也存在同样问题，疑惑这是否为语法或格式问题。

相关playbook示例：

- name: Test env variables
  hosts: my-host
  vars:
    archive_name: "{{ lookup('env', 'ARCHIVE_NAME') }}"
    
  tasks:
    - name: Clone Git repository
      ansible.builtin.git:
        repo: git@github.com:myproject/myrepo.git
        dest: sources
        archive: "{{ archive_name }}" # <- 这个有效
        #archive: "{{ ansible_env.ARCHIVE_NAME }}" # <- 这个无效

另一命令示例：

- name: Copy artifact to build server
  command: scp sources/{{ ansible_env.ARCHIVE_NAME }} root@{{ groups['my-host-5'][0] }}:/root/sources/{{ ansible_env.ARCHIVE_NAME }}

核心区别 #

ansible_env和lookup('env')读取的环境变量来源完全不同：

• ansible_env：存储的是目标主机上的环境变量集合，Ansible在执行任务前会收集目标主机的环境信息并生成这个变量；
• lookup('env', 'VAR_NAME')：直接读取**控制节点（运行Ansible的本地机器）**上的环境变量。

你的场景里，ARCHIVE_NAME是控制节点的环境变量，所以用ansible_env.ARCHIVE_NAME会去目标主机找这个变量，自然读不到，而lookup('env')能正确获取到控制节点的变量。

解决方法 #

1. 推荐方式：继续使用lookup('env')
   可以直接在模块参数里引用，无需提前定义变量：

   - name: Clone Git repository
     ansible.builtin.git:
       repo: git@github.com:myproject/myrepo.git
       dest: sources
       archive: "{{ lookup('env', 'ARCHIVE_NAME') }}"
   

   对于command模块的scp命令，同样修改为：

   - name: Copy artifact to build server
     command: scp sources/{{ lookup('env', 'ARCHIVE_NAME') }} root@{{ groups['my-host-5'][0] }}:/root/sources/{{ lookup('env', 'ARCHIVE_NAME') }}
   

2. 若坚持使用ansible_env（不推荐）
   需要在目标主机上预先设置ARCHIVE_NAME环境变量，比如通过shell模块临时导出，或者在目标主机的系统配置中永久设置，但这通常不符合你想复用控制节点变量的需求。

内容的提问来源于stack exchange，提问作者Tim