本地Windows机器通过gitlab-runner执行powershell脚本异常相关咨询

• 权限差异：GitLab Runner默认以Local System系统服务账户运行，和你本地登录的用户账户权限不一致，可能缺少应用运行所需的文件访问权限、注册表访问权限、网络权限等。
• 会话隔离：Windows系统中服务默认运行在会话0，普通用户登录后运行的程序在会话1及以上，依赖用户会话、带有UI组件的应用无法在会话0环境正常运行，会进入假死状态。
• 环境变量缺失：Runner执行任务时不会完全加载当前用户的环境变量配置，应用依赖的路径、密钥等参数无法正常读取，导致运行卡住。
• 流阻塞：应用如果默认等待控制台输入，或者输出流没有被正确接收，在Runner非交互式的执行环境下会直接挂死，不会主动退出。

完全可以通过GitLab Runner运行PowerShell脚本，两种常用场景的写法如下：

2.1 在.gitlab-ci.yml中配置调用 #

your_job_name:
  tags:
    - your_windows_runner_tag # 替换为你自己的Runner标签
  script:
    # ExecutionPolicy Bypass用于绕开系统默认的PowerShell脚本执行限制
    - powershell -ExecutionPolicy Bypass -File "C:\absolute\path\to\your\script.ps1"

2.2 本地用exec命令测试运行 #

gitlab-runner exec shell your_job_name --shell powershell

• 调整脚本中应用启动的参数，用Start-Process强制前台等待运行，所有输出会直接打印到Runner日志中：

Start-Process -FilePath "C:\path\to\your\app.exe" -ArgumentList "你的运行参数" -Wait -NoNewWindow -PassThru

• 把应用的标准输出、错误输出重定向到本地日志文件，执行完成后直接查看日志即可：

.\app.exe > C:\log\app_run.log 2>&1

• 临时将Runner从服务模式切换为前台运行：先在服务管理中停止GitLab Runner服务，打开CMD执行gitlab-runner run，此时所有执行日志会直接输出到当前控制台，可直观看到应用运行状态。

• 优先修改Runner的运行账户：打开服务管理（services.msc），找到GitLab Runner对应的服务，右键属性->登录选项卡，选择「此账户」，填入你本地运行脚本正常的用户账号密码，重启服务后重试，可解决绝大多数权限、环境变量问题。
• 如果应用必须依赖UI交互，不要将Runner安装为系统服务，改为用户登录后手动前台运行gitlab-runner run的方式保持Runner在线。
• 脚本开头可增加whoami、echo $env:PATH等调试命令，对比本地执行的输出结果，快速定位运行环境差异。
• 所有脚本、应用、日志路径统一使用绝对路径，避免Runner执行时工作目录不匹配的问题。
• 脚本末尾明确添加exit语句并传入对应错误码，告知Runner脚本执行结果，避免Runner无限制等待进程退出。

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