配置SSH executor的GitLab runner运行CI/CD pipeline失败如何排查？

• 优先修正配置错误：你当前config.toml中[runners.ssh]下的host = "gitlab.com"为错误配置。SSH执行器的host参数需要填写你计划运行CI任务的目标服务器IP/域名，而非GitLab站点地址。gitlab.com的22端口仅提供Git代码推拉的SSH服务，没有对外开放可供runner登录执行任务的权限，这是最可能的报错根源。
• 修正配置后验证SSH连通性：在runner所在的Ubuntu服务器上，切换到gitlab-runner用户手动登录目标服务器，执行命令su - gitlab-runner -c "ssh -p <目标服务器SSH端口> <目标服务器登录用户名>@<目标服务器IP>"，确认无需输入密码即可正常登录，排查以下常见连通性问题：
  • 确认runner服务器上/home/gitlab-runner/.ssh/id_rsa权限为600，所属用户组为gitlab-runner:gitlab-runner
  • 确认目标服务器上对应用户的~/.ssh/authorized_keys文件中已添加runner的公钥内容，文件权限为600，.ssh目录权限为700
• 检查目标服务器依赖：确认目标服务器已安装你CI流水线需要的所有工具（如git、构建工具、运行时环境等），确保SSH登录后可直接调用对应命令。
• 验证runner注册状态：在runner所在服务器执行gitlab-runner verify，确认输出显示runner处于alive状态，无连接GitLab的报错。
• 排查runner运行日志：执行journalctl -u gitlab-runner -f可实时查看runner运行日志，结合你已开启的debug日志级别，可以快速定位SSH连接、命令执行等环节的具体错误。

内容的提问来源于stack exchange，提问作者igor.k