centos gitlab怎么加runner

在 CentOS 上给 GitLab 添加 Runner，一般分为「安装 GitLab Runner → 注册到 GitLab → 启动并验证」三步。下面以 Shell Runner 为例（最常用，也最直观）。

一、安装 GitLab Runner（CentOS）

1. 添加 GitLab 官方仓库

curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash

2. 安装 gitlab-runner

sudo yum install gitlab-runner -y

安装完成后，会创建一个 gitlab-runner 系统用户。

二、获取 GitLab 的注册信息

进入 GitLab：

• 项目级 Runner：
  项目 → Settings → CI/CD → Runners
• 共享 Runner（管理员）：
  Admin → Overview → Runners

你会看到：

• GitLab URL
• Registration Token

示例：

URL: https://gitlab.com/
Token: xxxxxxxx

三、注册 Runner

在 CentOS 上执行：

sudo gitlab-runner register

按提示输入：

Enter the GitLab instance URL:
https://gitlab.com/

Enter the registration token:
xxxxxx

Enter a description for the runner:
centos-runner

Enter tags for the runner (comma-separated):
build,centos

Enter an executor:
shell

✅ 推荐使用 shell（适合 CentOS 服务器直接执行命令）

四、启动并设置为开机自启

sudo systemctl enable gitlab-runner
sudo systemctl start gitlab-runner

查看状态：

sudo systemctl status gitlab-runner

五、验证 Runner 是否生效

回到 GitLab：

• Settings → CI/CD → Runners
• 应该能看到你刚添加的 centos-runner
• 状态为 ✅ online

六、（可选）常见问题

1. runner 不在线

sudo gitlab-runner verify
sudo gitlab-runner restart

2. 权限问题（Shell Runner）

CI 中执行命令默认是 gitlab-runner 用户：

sudo usermod -aG docker gitlab-runner
sudo chmod 666 /var/run/docker.sock

3. 防火墙 / 网络

确保 CentOS 能访问 GitLab：

curl https://gitlab.com

七、示例 .gitlab-ci.yml

stages:
  - build

job:
  stage: build
  tags:
    - centos
  script:
    - echo "Hello from CentOS Runner"
    - hostname

如果你用的是：

• Docker Runner
• GitLab 私有化部署（自建）
• Kubernetes Runner

可以告诉我，我给你对应版本的配置。