Windows10系统安装GitLab Runner后无法启动问题求助

GitLab Runner Windows 10 启动报错解决步骤 #

我遇到过多次同类Windows环境下的GitLab Runner启动异常问题，可按以下优先级排查解决：

• 优先确认运行权限：右键点击PowerShell/CMD，选择以管理员身份运行后，再执行启动命令gitlab-runner start，Windows环境下服务类应用启动默认需要管理员权限，这是最高发的报错原因。
• 验证配置合法性：执行gitlab-runner verify命令，检查注册生成的config.toml文件是否合法、和GitLab服务端的连接是否正常，注册时填写的服务端URL、token错误都会导致启动失败。
• 排查端口占用：Runner默认监听9252端口，执行netstat -ano | findstr 9252检查是否有其他进程占用对应端口，存在占用的话可以结束占用进程，或者修改config.toml中listen_address参数更换为空闲端口。
• 检查服务运行身份权限：如果安装时指定了特定用户运行Runner服务，确认该用户密码未过期、对Runner工作目录拥有完整读写权限，权限不足或者密码过期也会触发启动报错。
• 查看详细日志定位：以上步骤都无法解决的话，执行gitlab-runner --debug run启动debug模式，控制台会输出完整的报错栈信息，根据具体错误内容再针对性排查即可。

内容的提问来源于stack exchange，提问作者Mert Özoğul