GitLab CI Shell执行器无法获取用户环境变量问题求助

问题场景 #

config.toml 配置 #

[[runners]]
    name = ...
    url = ...
    ...
    executor = shell
    shell = "powershell"
    ....

.gitlab-ci.yml 配置 #

test-job:
   tags:
      - test-runner
   script:
      - echo $env:windir
      - echo $env:OneDrive

执行输出 #

Running with gitlab-runner 15.2.1
...
...
Executing "step_script" stage of the job script
...
...
...
$ echo $env:windir
C:\Windows
$ echo $env:OneDrive
Job succeeded

系统环境变量$env:windir可正常输出，但用户环境变量$env:OneDrive无输出。

原因分析 #

GitLab Runner的Shell执行器（PowerShell）默认以系统账户运行，而OneDrive属于特定登录用户的用户级环境变量，系统账户无法直接读取普通用户的环境变量。

解决方法 #

1. 切换GitLab Runner运行账户为目标用户 #

• 打开服务管理器（运行services.msc），找到GitLab Runner服务
• 右键选择「属性」，切换到「登录」选项卡
• 选择「此账户」，输入需要读取环境变量的用户账户和密码，点击确定后重启服务

2. 在CI脚本中手动加载用户环境变量 #

如果不想切换运行账户，可在.gitlab-ci.yml的script中添加以下命令，手动读取目标用户的环境变量到当前进程：

# 替换为你的目标用户名
$targetUser = "你的用户名"
# 获取目标用户的SID并定位注册表路径
$userSID = (Get-WmiObject -Class Win32_UserAccount -Filter "Name='$targetUser'").SID
$userEnvPath = "Registry::HKEY_USERS\$userSID\Environment"
$userEnv = Get-ItemProperty $userEnvPath -ErrorAction SilentlyContinue

if ($userEnv) {
    # 将用户环境变量注入当前进程
    foreach ($prop in $userEnv.PSObject.Properties) {
        $excludedProps = @("PSPath", "PSParentPath", "PSChildName", "PSDrive", "PSProvider")
        if ($excludedProps -notcontains $prop.Name) {
            [Environment]::SetEnvironmentVariable($prop.Name, $prop.Value, "Process")
        }
    }
}

# 验证变量读取
echo $env:OneDrive

注意：此方法要求GitLab Runner运行的账户具备访问目标用户注册表的权限。

3. 将用户环境变量提升为系统环境变量 #

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在「系统变量」区域点击「新建」，添加变量名OneDrive，值设置为目标用户的OneDrive路径
• 重启GitLab Runner服务后，CI脚本即可读取到该变量

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