解决 Gitlab Runner 连接超时问题

53次阅读

问题描述

在使用 Gitlab Runner 时遇到了连接超时的问题。他的 Gitlab Runner 使用 Docker 作为执行器（executor），默认镜像为 docker:latest。虽然 Runner 已连接到项目并能够运行流水线，但在某个阶段卡住了，显示如下错误信息：

Reinitialized existing Git repository in /builds/sachith/omy-project/.git/
fatal: unable to access 'https://gitlab.myhost.com:1234/sachith/omy-project.git/': Failed to connect to gitlab.myhost.com port 1234: Operation timed out

用户尝试在运行 Gitlab Runner 的服务器上以 gitlab-runner 用户身份手动克隆项目，发现可以正常工作。用户想知道为什么会出现这个错误。

解决方案

请注意以下操作可能存在版本差异，操作前务必做好备份。

方案1

这个问题可能是由于防火墙或其他安全规则导致请求在到达 GitLab 主机之前被拦截造成的。请确认以下几点，以确保连接问题不是由于网络安全配置引起的：

检查端口是否开放：确保服务器上的 1234 端口是开放的，以便可以从 Runner 访问 GitLab 主机。你可以使用以下命令检查端口是否开放：
sudo ufw status
如果端口被阻止，请使用以下命令开放端口（假设你的端口号为 1234）：
sudo ufw allow 1234
防火墙规则：检查防火墙配置，确保没有规则阻止来自 GitLab 主机的流量。你可能需要联系网络管理员或云服务提供商，以确认没有特殊的网络规则导致连接问题。

方案2

这个解决方案由用户投票选为最佳回答。

在某些情况下，Gitlab Runner 可能需要特定的权限才能正常访问网络资源。这可能与 Runner 的注册方式有关。你可能需要以超级用户（sudo）权限注册 Gitlab Runner，以确保它拥有足够的权限进行网络访问。

你可以按照以下步骤重新注册 Gitlab Runner：

打开终端并以超级用户身份登录（使用 sudo）。
运行以下命令注册 Gitlab Runner（请将 [option] 替换为实际的选项）：
bash sudo gitlab-runner register [option]
注册成功后，重新启动 Gitlab Runner 服务。

方案3

使用这种方法可能会增加复杂性，只在必要时考虑。

你也可以尝试手动控制 Gitlab Runner 的克隆和执行顺序，以确保克隆在合适的时机发生。以下是一个示例脚本，它在 Runner 启动后等待 Git 仓库完全克隆完成后再继续执行后续操作：

#!/bin/bash
# 启动 Gitlab Runner
sudo gitlab-runner start
# 等待 Git 仓库克隆完成
while [ ! -d "/builds/sachith/omy-project/.git/" ]; do
  sleep 1
done
# 执行后续操作
# ...

在这个示例中，我们首先使用 sudo 权限启动 Gitlab Runner 服务。然后，使用一个循环来等待 Git 仓库目录出现（表示克隆完成）。一旦目录出现，就可以继续执行后续操作。