极狐GitLab 是 GitLab 在中国的发行版，专门面向中国程序员和企业提供企业级一体化 DevOps 平台，用来帮助用户实现需求管理、源代码托管、CI/CD、安全合规，而且所有的操作都是在一个平台上进行，省事省心省钱。可以一键安装极狐GitLab，详情可以参考极狐GitLab 下载安装官网。
GitLab 中文版学习资料
- 驭码CodeRider 官网：https://coderider.gitlab.cn/
- GitLab 中文版官网：https://gitlab.cn
- GitLab 中文文档：https://docs.gitlab.cn
- GitLab 中文下载安装：https://gitlab.cn/install
前言
极狐GitLab 是一个一体化的 DevOps 平台，CI/CD 是内置的功能，这也就是常说的极狐GitLab CI 要做的工作。而实现极狐GitLab CI 的核心组件是极狐GitLab Runner ------ 一个轻量级、高扩展的代理，用来运行你的 CI/CD 作业并且将结果发送回极狐GitLab 实例。极狐GitLab Runner 和极狐GitLab CI/CD 绑定在一起。
极狐GitLab Runner 支持多种操作系统：
- CentOS
- Debian
- Ubuntu
- RHEL
- Fedora
- Mint
- Oracle
- Amazon
也支持多种 CPU 架构：
- x86
- AMD64
- ARM64
- ARM
- s390x
- ppc64le
而且也支持多种安装方式：源码、软件包、二进制文件以及容器安装。
本文演示在 Debian 12 上安装配置极狐GitLab 的两种方式：二进制安装 & 容器化安装。
软件包安装
下载安装包并安装
使用如下命令下载 Runner 安装包并查看：
$ curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/deb/gitlab-runner_${arch}.deb"
$ ls -ltr
-rw-r--r-- 1 root root 491857186 Mar 26 11:35 gitlab-runner_amd64.deb
执行如下命令即可完成安装：
$ dpkg -i gitlab-runner_amd64.deb
Selecting previously unselected package gitlab-runner.
(Reading database ... 64318 files and directories currently installed.)
Preparing to unpack gitlab-runner_amd64.deb ...
Unpacking gitlab-runner (16.10.0-1) ...
Setting up gitlab-runner (16.10.0-1) ...
GitLab Runner: creating gitlab-runner...
Home directory skeleton not used
Runtime platform arch=amd64 os=linux pid=226784 revision=81ab07f6 version=16.10.0
gitlab-runner: the service is not installed
Runtime platform arch=amd64 os=linux pid=226796 revision=81ab07f6 version=16.10.0
gitlab-ci-multi-runner: the service is not installed
Runtime platform arch=amd64 os=linux pid=226830 revision=81ab07f6 version=16.10.0
Runtime platform arch=amd64 os=linux pid=226876 revision=81ab07f6 version=16.10.0
Check and remove all unused containers (both dangling and unreferenced) including volumes.
------------------------------------------------------------------------------------------
Total reclaimed space: 0B
通过 --version查看安装是否成功：
$ gitlab-runner --version
Version: 16.10.0
Git revision: 81ab07f6
Git branch: 16-10-stable
GO version: go1.21.7
Built: 2024-03-21T19:43:25+0000
OS/Arch: linux/amd64
注册 Runner
在极狐GitLab 上选定项目，在设置 --> CI/CD --> --> Runner中在项目 Runner 中选择新建项目 Runner：
点击新建项目 Runner ，填写所需的信息，然后点击创建 runner：
在出现的界面中会给出 Runner 注册的命令（同时也会包含 Runner 注册的 token，此 token 需要好好保存）：
copy 上面的命令注册 Runner：
$ gitlab-runner register --url https://jihulab.com --token glrt-SYhzxxxxx5KDhZU
Enter the GitLab instance URL (for example, https://gitlab.com/):
[https://jihulab.com]: https://jihulab.com
Verifying runner... is valid runner=SYhzyjbEb
Enter a name for the runner. This is stored only in the local config.toml file:
[VM-20-9-debian]: debian-runner
Enter an executor: parallels, docker-autoscaler, docker+machine, kubernetes, custom, shell, ssh, virtualbox, docker, docker-windows, instance:
shell
Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!
Configuration (with the authentication token) was saved in "/etc/gitlab-runner/config.toml"
输入必要的信息即可完成 Runner 注册。
参数说明：
-
--url：极狐GitLab 实例的地址，可以是私有化部署实例的地址，也可以是 SaaS 地址（https://jihulab.com）
-
--token：runner 的注册 token。
这时候就可以在项目 --> 设置 --> CI/CD --Runner 页面看到注册成功的 Runner 了：
测试 Runner
选择一个需要构建 CI/CD 的极狐GitLab 项目，创建一个 .gitlab-ci.yml文件，选择一个内置的 bash模版：
在 stage中用 tags使用刚注册成功 Runner：
tags:
- debian
提交变更即可触发 CI/CD 流水线：
可以看到流水线构建成功，查看作业的构建日志：
从日志可以看出作业就是刚才注册成功的 Runner 上执行的，因为注册时候给 Runner 取名为 debian-runner。
下一篇文章介绍用 docker 来安装 Runner。