如何在GitLab Runner中以前台模式启动应用程序？

核心原因 #

GitLab Runner默认以系统服务身份运行，没有绑定交互式桌面会话，导致启动的GUI程序无法关联到用户桌面，只能在后台执行。

Windows环境下的解决方案 #

1. 修改GitLab Runner运行模式 #

将Runner从服务模式改为用户模式运行，绑定当前登录用户的桌面会话：

• 停止Runner服务：

  gitlab-runner stop
  

• 卸载现有服务：

  gitlab-runner uninstall
  

• 以当前用户身份重新安装并启动：

  gitlab-runner install --user <你的用户名> --password <你的用户密码>
  gitlab-runner start
  

2. 调整subprocess.Popen()参数 #

调用命令时明确指定窗口属性，强制应用在前台显示：

import subprocess

# 针对控制台应用，强制创建新控制台窗口并等待退出
subprocess.Popen(
    ["start", "/WAIT", "/MAX", "你的应用路径.exe"],
    shell=True,
    creationflags=subprocess.CREATE_NEW_CONSOLE
)

• /WAIT：等待应用退出后再执行后续代码
• /MAX：启动时最大化窗口
• CREATE_NEW_CONSOLE：强制生成新的控制台窗口

如果是GUI应用，可改用以下参数：

subprocess.Popen(
    ["你的应用路径.exe"],
    shell=True,
    creationflags=subprocess.CREATE_NEW_PROCESS_GROUP | subprocess.DETACHED_PROCESS
)

3. 配置CI作业执行环境 #

在.gitlab-ci.yml中指定使用shell执行器（避免用docker类执行器，除非配置了桌面虚拟化）：

launch_app_job:
  script:
    - python your_script.py
  tags:
    - windows-runner
  executor: shell

Linux环境补充方案 #

如果是Linux Runner，需设置DISPLAY环境变量并确保Runner有桌面访问权限：

import subprocess
import os

# 绑定当前桌面会话
os.environ['DISPLAY'] = ':0'

subprocess.Popen(
    ["你的应用路径"],
    env=os.environ
)

同时临时放开X11访问权限：

xhost +local:gitlab-runner

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