如何在Ansible中加载.zshenv并在其他任务中使用环境变量

我目前需要在Ansible任务里加载.zshenv文件中的环境变量，之后在其他任务中使用这些变量。以下是我当前的实现方式，希望能得到更简洁高效的解决方案。

当前实现方案 #

文件结构 #

.
├── ansible.cfg
├── hosts.yaml
├── profiles
│   └── macos.yaml
├── roles
│   └── base
│       ├── tasks
│       │   ├── git.yaml
│       │   └── main.yaml
│       └── vars
└── tools
    └── zsh
        └── .zshenv

./ansible.cfg #

[defaults]
inventory = ./hosts.yaml
roles_path = ./roles/
stdout_callback = yaml

./hosts.yaml #

---
all:
  hosts:
    localhost

./profiles/macos.yaml #

---

# run MacOS configs

# - hosts: localhost
#   connection: local
#   tags: macos
#   roles:
#     - macos
#     # when: ansible_distribution == "MacOSX"

- hosts: localhost
  connection: local
  tags: base
  roles:
    - base

./roles/base/main.yaml #

---

- import_tasks: tasks/git.yaml

./roles/base/git.yaml #

---

- name: source zshenv
  shell:
    cmd: source ../tools/zsh/.zshenv; echo $GIT_CONFIG_PATH
  register: gitConfigPath

- name: Link gitconfig file
  file:
    # PWD: ./profiles
    src: "{{ ansible_env.PWD }}/../tools/git/.gitconfig"
    dest: "{{ gitConfigPath.stdout }}"
    state: link

# - name: print ansible_env
#   debug:
#     msg: "{{ ansible_env }}"
#
# - name: print gitConfigPath
#   debug:
#     msg: "{{ gitConfigPath.stdout }}"
#

./tools/zsh/.zshenv #

export XDG_CONFIG_HOME="$HOME/.config"
export GIT_CONFIG_PATH="$XDG_CONFIG_HOME/git/config"

运行命令 #

ansible-playbook profiles/macos.yaml -v

期望的便捷执行方式 #

我希望能像这样直接加载变量再运行playbook：

source tools/zsh/.zshenv && ansible-playbook profiles/macos.yaml -v

优化方案 #

方法1：让Ansible进程直接继承环境变量（最便捷） #

直接用你期望的命令执行，.zshenv里的变量会被加载到当前shell环境，Ansible进程会自动继承这些变量。此时可以直接在任务中通过lookup('env', '变量名')或者ansible_env.变量名调用，不需要额外的shell任务：

修改roles/base/git.yaml：

---
- name: Link gitconfig file
  file:
    src: "{{ ansible_env.PWD }}/../tools/git/.gitconfig"
    dest: "{{ lookup('env', 'GIT_CONFIG_PATH') }}"
    state: link

这种方式完全省去了在playbook内source文件的步骤，简洁高效，适合本地执行的场景。

方法2：在Ansible内部解析.zshenv提取变量 #

如果不想依赖外部shell的环境加载，可以在playbook内写任务解析.zshenv文件，提取其中的export变量并设置为Ansible可用的变量：

---
- name: 解析.zshenv提取环境变量
  shell: grep '^export' ../tools/zsh/.zshenv | sed 's/export //;s/=.*//' | while read var; do echo "$var=${!var}"; done
  register: zshenv_vars
  changed_when: false  # 标记此任务不会改变系统状态

- name: 将提取的变量设置为Ansible facts
  set_fact:
    "{{ item.split('=')[0] }}": "{{ item.split('=')[1] }}"
  loop: "{{ zshenv_vars.stdout_lines }}"

- name: Link gitconfig file
  file:
    src: "{{ ansible_env.PWD }}/../tools/git/.gitconfig"
    dest: "{{ GIT_CONFIG_PATH }}"
    state: link

这种方法不需要在外部操作，所有逻辑都在playbook内完成，适合需要动态加载配置的场景。

方法3：将变量迁移到Ansible vars文件（最佳实践） #

把.zshenv里的变量定义复制到Ansible角色的vars文件中，让Ansible直接读取管理这些变量，完全脱离shell环境的依赖：

创建roles/base/vars/main.yaml：

XDG_CONFIG_HOME: "{{ ansible_env.HOME }}/.config"
GIT_CONFIG_PATH: "{{ XDG_CONFIG_HOME }}/git/config"

然后修改roles/base/git.yaml：

---
- name: Link gitconfig file
  file:
    src: "{{ ansible_env.PWD }}/../tools/git/.gitconfig"
    dest: "{{ GIT_CONFIG_PATH }}"
    state: link

这种方式符合Ansible的变量管理最佳实践，变量集中可控，避免了shell环境带来的不确定性。唯一需要注意的是，如果.zshenv里的变量更新，需要同步更新Ansible vars文件。

内容的提问来源于stack exchange，提问作者Clumsy-Coder