如何在Ansible中持久化环境变量供后续任务/剧本使用？

你当前的写法存在两个核心问题：

1. Ansible的每个shell/command任务都是独立的子shell，source ~/.bashrc仅在当前任务的子shell中生效，任务结束后变量就会消失。
2. ~/.bashrc默认仅在交互式登录shell中加载，而Ansible的任务默认以非交互式非登录shell执行，即使写入~/.bashrc，后续Ansible任务也不会自动加载这些变量。

下面给出实现持久化系统环境变量+后续Play可调用的完整方案：

一、实现环境变量持久化 #

方案1：系统级持久化（所有用户生效） #

写入/etc/profile.d/目录下的自定义脚本（推荐），该目录下的.sh文件会被所有bash会话（包括登录/非登录shell）自动加载：

- name: 设置系统级持久化环境变量
  hosts: 127.0.0.1
  connection: local
  vars:
    env_vars_file: /opt/env_vars.yml
    system_env_script: /etc/profile.d/my_custom_env.sh
  tasks:
    # 第一步：加载环境变量配置文件
    - name: 读取环境变量定义
      include_vars:
        file: "{{ env_vars_file }}"
        name: env_vars_dict

    # 第二步：生成系统级环境变量脚本
    - name: 写入环境变量脚本
      copy:
        content: |
          {% for key, value in env_vars_dict.items() %}
          export {{ key }}="{{ value }}"
          {% endfor %}
        dest: "{{ system_env_script }}"
        mode: '0644'
      become: yes

方案2：用户级持久化（仅当前用户生效） #

如果只需要当前用户生效，可继续写入~/.bashrc，但需注意后续任务要显式加载：

- name: 设置用户级持久化环境变量
  hosts: 127.0.0.1
  connection: local
  vars:
    env_vars_file: /opt/env_vars.yml
    user_env_file: ~/.bashrc
  tasks:
    - name: 读取环境变量定义
      include_vars:
        file: "{{ env_vars_file }}"
        name: env_vars_dict

    - name: 写入用户.bashrc
      lineinfile:
        path: "{{ user_env_file }}"
        state: present
        regexp: "^{{ item.key }}="
        line: "export {{ item.key }}={{ item.value }}"
      with_dict: "{{ env_vars_dict }}"
      become: yes

二、让后续任务/Play立即调用变量 #

写入环境变量文件后，需将变量同步到Ansible的全局facts中，这样同一Play的后续任务和其他Play都能直接调用：

# 接上面的系统级持久化任务
- name: 加载新环境变量并注册为全局facts
  shell: source "{{ system_env_script }}" && echo "{{ item.key }}=$${{ item.key }}"
  with_dict: "{{ env_vars_dict }}"
  register: new_env_vars
  changed_when: false

- name: 设置全局可访问的facts
  set_fact:
    "{{ item.stdout.split('=')[0] }}": "{{ item.stdout.split('=')[1] }}"
  loop: "{{ new_env_vars.results }}"

# 测试：当前Play中直接调用变量
- name: 验证变量可用性
  debug:
    msg: "{{ item.key }} 的值是 {{ lookup('vars', item.key) }}"
  with_dict: "{{ env_vars_dict }}"

后续Play调用方式 #

在其他Play中，无需额外操作，直接通过变量名调用即可：

- name: 后续Play调用环境变量
  hosts: 127.0.0.1
  connection: local
  tasks:
    - name: 使用之前设置的变量
      debug:
        msg: "获取到的变量值：{{ MY_CUSTOM_VAR }}"

关于ansible.builtin.env lookup的说明 #

ansible.builtin.env lookup是读取运行Ansible的控制节点的环境变量，而非目标主机（这里是localhost）的环境变量。如果要获取目标主机的环境变量，直接使用上述注册的facts，或通过shell任务读取：

- name: 获取目标主机环境变量
  shell: echo $MY_CUSTOM_VAR
  register: var_value
- debug:
    msg: "目标主机的变量值：{{ var_value.stdout }}"

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