linux gitlab怎么配置runner

下面以 Linux（Ubuntu/CentOS 等） 为例，说明如何配置 GitLab Runner。

一、准备工作

• 已安装 Git
• 有 GitLab 实例（官网 gitlab.com 或私有 GitLab）
• 具有项目或 Group 的 Maintainer/Owner 权限（用于获取注册 Token）

二、安装 GitLab Runner（Linux）

1️⃣ Ubuntu / Debian

# 安装依赖
sudo apt-get update
sudo apt-get install -y curl

# 添加 GitLab 官方源
curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash

# 安装
sudo apt-get install gitlab-runner

2️⃣ CentOS / RHEL

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

三、获取 Runner Token

项目级 Runner

GitLab 项目 → Settings → CI/CD → Runners → 复制 Registration Token

共享 Runner（管理员）

Admin → CI/CD → Runners

四、注册 Runner

执行：

sudo gitlab-runner register

按提示输入：

1. GitLab URL

https://gitlab.com

或

https://your-gitlab-domain.com

2. Registration Token

粘贴刚才复制的 Token

3. Runner 描述

my-linux-runner

4. Runner Tags

linux,build

（CI 中可通过 tags 指定使用）

5. Executor 常用：

• shell：直接在机器上跑（简单）
• docker：推荐，环境隔离
• docker+machine：自动伸缩

示例（docker）：

docker

6. 默认镜像（docker 时）

alpine:latest

五、启动并设置开机自启

# 重新加载
sudo gitlab-runner restart

# 开机自启（systemd）
sudo systemctl enable gitlab-runner
sudo systemctl start gitlab-runner

六、验证 Runner 状态

sudo gitlab-runner status

GitLab 页面中 Runner 应显示： ✅ online

七、常见问题

1️⃣ docker executor 报错

确保已安装 Docker：

sudo apt install docker.io
sudo usermod -aG docker gitlab-runner

2️⃣ shell executor 无权限

sudo visudo
gitlab-runner ALL=(ALL) NOPASSWD: ALL

3️⃣ 修改配置

sudo vim /etc/gitlab-runner/config.toml
sudo gitlab-runner restart

八、最小示例 .gitlab-ci.yml

stages:
  - build

job:
  tags:
    - linux
  script:
    - echo "Hello GitLab Runner"

如果你愿意，可以告诉我：

• GitLab 是 自建还是 gitlab.com
• 想用 shell 还是 docker
• 是否是 Kubernetes / ARM 机器

我可以给你更精确的配置示例。