当前位置：首页 > news >正文

如何安装和注册 GitLab Runner

news 来源：原创 2024/9/20 12:39:30

如何安装和注册 GitLab Runner

GitLab Runner 是一个用于运行 GitLab CI/CD (Continuous Integration/Continuous Deployment) 作业。它是一个与 GitLab 配合使用的应用程序，可以在本地或云中运行。Runner 可以执行不同类型的作业，例如编译代码、运行测试、部署应用程序等。它支持多种执行器，包括 Shell、Docker、Kubernetes 等，以便灵活地运行作业。

1. GitLab Runner 的安装

在开始安装 GitLab Runner 之前，首先需要确认你的服务器上已经安装了 Git 和 Docker（如果你打算使用 Docker executor）。下面将展示在不同操作系统上安装 GitLab Runner 的方法。

1.1 在 Linux 上安装 GitLab Runner

打开终端，下载 GitLab Runner 的二进制文件：

curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64

为二进制文件添加执行权限：
```
chmod +x /usr/local/bin/gitlab-runner
```

安装并启动 GitLab Runner 服务：

gitlab-runner install
gitlab-runner start

1.2 在 macOS 上安装 GitLab Runner

使用 Homebrew 安装 GitLab Runner：
```
brew install gitlab-runner
```
安装后，启动 GitLab Runner：
```
gitlab-runner start
```

1.3 在 Windows 上安装 GitLab Runner

下载 Windows 版本的 GitLab Runner 安装包，网址：GitLab Runner 下载
将下载的文件重命名为 gitlab-runner.exe，并将其移动到一个可执行路径中，例如 C:\GitLab-Runner。

在命令提示符中安装 GitLab Runner 服务：

gitlab-runner.exe install
gitlab-runner.exe start

1.4 在 Ubuntu 上安装 GitLab Runner

添加 GitLab Runner 官方仓库

首先，添加 GitLab Runner 的官方仓库并导入 GPG 密钥。

# 安装必要的依赖
sudo apt-get install -y curl# 添加 GitLab 官方 GPG 密钥
curl -fsSL https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash

安装 GitLab Runner

现在使用 apt 包管理器来安装 GitLab Runner。

sudo apt-get install gitlab-runner

启动 GitLab Runner

在 Ubuntu 系统上，GitLab Runner 会作为系统服务运行。可以使用以下命令启动并启用 GitLab Runner 服务，以便在系统启动时自动运行：

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

2. 注册 GitLab Runner

安装完 GitLab Runner 后，需要将其注册到你的 GitLab 实例中，这样它才能运行特定项目的任务。

2.1 获取注册令牌

登录到你的 GitLab 实例。
导航到你想要注册 Runner 的项目。
进入 Settings -> CI / CD，在 Runners 部分找到 Set up a specific Runner manually。
复制项目的注册令牌。

2.2 运行注册命令

在你的服务器上运行以下命令开始注册：

gitlab-runner register

然后按照提示完成注册：

输入 GitLab 实例的 URL，例如 https://gitlab.com/。
输入上一步获取的注册令牌。
输入描述信息和标记（tags），用于标识 Runner，多个标签用逗号分隔。
选择 Runner 执行器（executor），例如 docker、shell、virtualbox 等。通常推荐选择 docker 以便于隔离和管理。

2.3 配置 Runner

完成注册后，可以通过编辑 config.toml 文件进一步配置 Runner。此文件通常位于 Runner 安装路径下的 ~/.gitlab-runner/ 目录中。根据安装环境的不同，该文件可能也位于 /etc/gitlab-runner/ 目录中。config.toml 文件用于定义 Runner 的行为和特性，如使用的执行器、环境变量、缓存设置等。

可以使用以下配置示例对 config.toml 进行修改：

[[runners]]name = "my-runner"url = "https://gitlab.com/"token = "xxxxxxxxxxxxxxxxxxxx"executor = "docker"[runners.custom_build_dir][runners.docker]tls_verify = falseimage = "alpine:latest"privileged = truedisable_entrypoint_overwrite = falseoom_kill_disable = falsedisable_cache = falsevolumes = ["/cache"]shm_size = 0[runners.cache]