GitLab Runner v10.6.0（Ubuntu16.04）注册报错求助

我来帮你梳理注册GitLab Runner时可能遇到的问题，结合你给出的环境配置和命令片段，整理了针对性的排查步骤和完整解决方案：

你的环境与配置信息 #

• GitLab Runner版本：v10.6.0
• 操作系统：Ubuntu 16.04
• 已配置的环境变量：

SHELL_RUNNER_EXECUTOR=shell
SHELL_RUNNER_TAG_LIST=***,aws,shell,docker-builder
CI_SERVER_URL=https://gitlab.***.com/
DOCKER_MACHINE_RUNNER_TAG_LIST=***,aws,docker,runner
DOCKER_MACHINE_RUNNER_EXECUTOR=docker+machine
REGISTRATION_TOKEN=***
DOCKER_MACHINE_RUNNER_NAME=***-docker-runner

• 你提供的注册命令片段：

sudo gitlab-runner register \
  --non-interactive \
  -u $CI_SERVER_URL \
  -r $REGISTRATION_TOKEN \
  # 命令未完整，缺少executor、tag、name等关键参数

核心问题排查与解决 #

1. 补全注册命令的关键参数 #

你的命令片段缺少--executor、--tag-list、--name等必填参数，这是注册失败的最常见原因。下面是针对两种Executor的完整注册命令：

注册Shell类型Runner

sudo gitlab-runner register \
  --non-interactive \
  --url $CI_SERVER_URL \
  --registration-token $REGISTRATION_TOKEN \
  --executor $SHELL_RUNNER_EXECUTOR \
  --tag-list "$SHELL_RUNNER_TAG_LIST" \
  --name "shell-runner-$(hostname)" \
  --locked="false" \
  --run-untagged="false"

注册Docker+Machine类型Runner

sudo gitlab-runner register \
  --non-interactive \
  --url $CI_SERVER_URL \
  --registration-token $REGISTRATION_TOKEN \
  --executor $DOCKER_MACHINE_RUNNER_EXECUTOR \
  --tag-list "$DOCKER_MACHINE_RUNNER_TAG_LIST" \
  --name $DOCKER_MACHINE_RUNNER_NAME \
  --locked="false" \
  --run-untagged="false" \
  # 可选：添加Docker基础配置，按需调整
  --docker-image "docker:latest" \
  --docker-privileged="true"

2. 解决sudo环境变量读取问题 #

在Ubuntu 16.04中，直接用sudo执行命令可能无法读取当前用户的环境变量，导致变量替换失败。可以先导出变量再用sudo -E保留环境变量执行：

# 先导出所有配置变量
export SHELL_RUNNER_EXECUTOR=shell
export SHELL_RUNNER_TAG_LIST=***,aws,shell,docker-builder
export CI_SERVER_URL=https://gitlab.***.com/
export DOCKER_MACHINE_RUNNER_TAG_LIST=***,aws,docker,runner
export DOCKER_MACHINE_RUNNER_EXECUTOR=docker+machine
export REGISTRATION_TOKEN=***
export DOCKER_MACHINE_RUNNER_NAME=***-docker-runner

# 用sudo -E执行注册命令，保留当前环境变量
sudo -E gitlab-runner register \
  --non-interactive \
  --url $CI_SERVER_URL \
  --registration-token $REGISTRATION_TOKEN \
  --executor $SHELL_RUNNER_EXECUTOR \
  --tag-list "$SHELL_RUNNER_TAG_LIST" \
  --name "shell-runner-$(hostname)"

3. 版本兼容性与网络检查 #

• 版本匹配：GitLab Runner v10.6.0属于较旧版本，需确保你的GitLab服务器版本≥v10.6.0，否则会出现通信或兼容性错误。
• 网络连通：检查Runner服务器能否正常访问GitLab地址：

curl -I $CI_SERVER_URL

如果返回200/302状态码则网络正常，若超时或拒绝连接，需排查防火墙、代理或网络路由配置。

验证注册结果 #

注册完成后，用以下命令查看本地Runner列表：

sudo gitlab-runner list

同时登录GitLab服务器，在项目/群组的Settings → CI/CD → Runners页面确认Runner是否已成功注册并处于活跃状态。

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