如何将本地Windows PC集成到GitLab CI/CD流水线作为Runner？

一、安装GitLab Runner到本地Windows 11 #

• 下载适配Windows系统的GitLab Runner安装包（x86或x64版本，根据你的系统选择）
• 右键以管理员身份打开PowerShell，切换到安装包所在目录，执行安装命令：

  .\gitlab-runner.exe install --user "你的Windows系统用户名" --password "对应用户密码"
  

  注意：这里的用户和密码要填你Windows机器上有足够权限的账号，确保Runner能正常访问所需软件和目录
• 启动Runner服务：

  .\gitlab-runner.exe start
  

二、注册Runner（核心：使用Shell执行器） #

• 打开GitLab项目或群组的「设置」→「CI/CD」→「Runners」页面，复制页面上的GitLab实例URL和注册令牌
• 回到PowerShell窗口，执行注册命令：

  .\gitlab-runner.exe register
  

• 按照提示依次输入信息：
  1. 粘贴之前复制的GitLab实例URL
  2. 粘贴注册令牌
  3. 输入Runner的自定义描述（比如「Windows 11 本地构建机器」）
  4. 设置Runner标签（比如windows11-local，后续流水线会通过这个标签指定使用该Runner）
  5. 选择执行器：输入shell——这是重点！不要选Docker，这样才能直接使用本地Windows 11的完整环境和已安装软件
  6. 确认配置完成注册

三、在流水线中指定使用该Runner #

• 在项目根目录创建或修改.gitlab-ci.yml文件，通过tags字段绑定到你注册的本地Runner：

  stages:
    - build
  
  windows-build:
    stage: build
    tags:
      - windows11-local  # 必须和注册时设置的标签完全一致
    script:
      - echo "开始在本地Windows 11机器执行任务"
      - # 在这里添加你的实际任务命令，比如调用专属软件的启动脚本
  

• 提交.gitlab-ci.yml到仓库，触发流水线后，任务就会自动分配到你的本地Windows 11机器上运行

四、关键注意事项 #

• 确保Windows 11机器和GitLab实例网络互通：如果是本地GitLab，两者要在同一局域网；如果是云端GitLab，机器要能正常访问GitLab的公网地址
• 给Runner服务的用户足够权限：比如能访问你的软件安装路径、项目代码存储目录，避免权限不足导致任务失败
• 如果需要运行GUI类软件，要在Runner服务的属性中开启「允许服务与桌面交互」（在服务管理器中找到gitlab-runner服务，右键属性→登录→勾选对应选项）
• 定期更新GitLab Runner到最新版本，避免出现兼容性问题

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