GitLab CI/CD学习教程（第二章Runner）

已于 2025-03-19 11:21:30 修改
阅读量1.4k 收藏 16
点赞数 20
分类专栏： GitLab CI/CD 文章标签： gitlab ci/cd 学习
于 2025-03-18 10:20:47 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_41898196/article/details/146020889
版权

GitLab CI/CD学习教程（第二章Runner）


🚀从零开始，结合具体场景和示例，让你彻底掌握 GitLab CI/CD 的配置！

icon

目录

1 原理


⭐ 组件交互流程

GitLab Instance Runner Executor 1. 推送CI作业（通过轮询/Webhook 2. 创建执行环境（Docker/K8s/VM等） 3. 拉取代码并执行脚本 4. 实时返回日志和结果 GitLab Instance Runner Executor

🧾 流程图说明

执行器类型Executor：

  • Docker：默认推荐，隔离性高
  • Shell：直接使用宿主机环境，适合简单任务
  • Kubernetes：动态创建 Pod 执行任务
  • VirtualBox/Parallels：虚拟机级别隔离
  • SSH：远程服务器执行
  • 自定义执行器：通过 API 扩展功能

2 安装


📕 参考官方文档

2.1 Windows 系统安装

📔官方文档

  1. 下载 64位或者32位

  2. 在系统中的某个位置创建一个文件夹，例如 .C:\GitLab-Runner

  3. 注册(详情请看3 注册)

  4. 将 GitLab Runner 安装为服务并启动它。您可以运行 Service 使用内置系统帐户 （推荐） 或使用用户帐户：

    • 使用内置系统帐户运行服务 （在步骤2中创建的示例目录下，C:\GitLab-Runner)
    cd C:\GitLab-Runner
.\gitlab-runner.exe install
.\gitlab-runner.exe start
    • 使用用户账户运行服务 （在步骤2中创建的示例目录下，C:\GitLab-Runner)

    您必须为当前用户帐户输入有效的密码，因为 需要通过 Windows 启动服务：

    cd C:\GitLab-Runner
.\gitlab-runner.exe install --user ENTER-YOUR-USERNAME --password ENTER-YOUR-PASSWORD
.\gitlab-runner.exe start

2.2 Linux 系统安装

📔官方文档

  1. 添加官方 GitLab 仓库：
    # RHEL/CentOS/Fedora/Amazon Linux
curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh" | sudo bash

# Debian/Ubuntu/Mint
curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash

# 源码编译安装（自定义功能）
go get -u gitlab.com/gitlab-org/gitlab-runner
cd $GOPATH/src/gitlab.com/gitlab-org/gitlab-runner
make deps && make
  2. 安装最新版本的 GitLab Runner，或跳至下一步 安装特定版本：
    # RHEL/CentOS/Fedora/Amazon Linux
sudo yum install gitlab-runner

# Debian/Ubuntu/Mint
sudo apt-get install gitlab-runner
  3. 要安装特定版本的 GitLab Runner：
    # RHEL/CentOS/Fedora/Amazon Linux 
yum list gitlab-runner --showduplicates | sort -r
sudo yum install gitlab-runner-17.2.0-1

# Debian/Ubuntu/Mint
apt-cache madison gitlab-runner
sudo apt install gitlab-runner=17.7.1-1 gitlab-runner-helper-images=17.7.1-1

2.3 Docker 安装

自行参阅：📔官方文档


3 注册

📔官方文档

💾 获取Token和URL：

获取项目的注册令牌（为该项目指定Runner）：

  1. 进入 GitLab 项目 → Settings → CI/CD → Runners → Expand
  2. 复制 注册令牌（Registration Token）
    在这里插入图片描述

获取群组的注册令牌（群组里面的所有项目共享Runner）:

  1. 需要群组的权限
  2. 进入 GitLab 群组 → Settings → CI/CD → Runners → Expand*
  3. 复制 注册令牌（Registration Token） 和URL
    在这里插入图片描述

📥 完整流程 （以Windows为示例）：

⏰ 如果你想多个项目共用一个Runner，有两种方案：

  • 注册群组Token, 那群组里面的所有项目均共享
  • 为各个项目分别进行注册，重复该注册流程

  1. 以管理员身份打开 PowerShell：

    cd "D:\GitLab-Runner"
.\gitlab-runner-windows-amd64.exe register

  2. 按提示输入信息：

    关键参数说明：

    • URL: GitLab 实例地址（默认 https://gitlab.com）。
    • Token: 粘贴复制的群组注册令牌或者项目注册令牌。
    • Description: 自定义 Runner 名称（如 HULU 测试）。
    • Tags: 输入逗号分隔的标签（如 dev, docker）。
    • Executor: 选择执行器（推荐 docker 或 shell）。在这里插入图片描述

  3. 注册成功后可以在程序的同级目录下看到生成的config.toml文件
    文件内容如下：

    concurrent = 1
check_interval = 0
shutdown_timeout = 0

[session_server]
	session_timeout = 1800

[[runners]]
	name = "HULU 测试"
	url = "http://gitlab.com/"
	id = 106
	token = "xxxxxxxxxxx"
	token_obtained_at = 2025-03-06T10:13:30Z
	token_expires_at = 0001-01-01T00:00:00Z
	executor = "shell"
	shell = "pwsh"
	[runners.cache]
		MaxUploadedArchiveSize = 0
		[runners.cache.s3]
		[runners.cache.gcs]
		[runners.cache.azure]


4 配置

📔《高级配置》官方文档
如果您是第一次了解Runner，可以忽略该步骤，先看完5 运行步骤再回头看该步骤。
以后可能会单独写一个文章专门讲解高级配置。

🧾 常用全局配置项详解

项目含义
concurrent最大并发作业数（根据服务器性能调整， 如果4核CPU可设置4）
check_interval轮询新作业的间隔（秒）
log_level日志级别 （“debug” / “info” / “warn” / “error”）

🧾 常用[runners]配置项详解

项目含义
name运行程序的描述。仅供参考。
urlGitLab 实例的URL（如果你是私有的gitlab）
token运行器的身份验证令牌，在运行器注册期间自动获取。与注册令牌不同。
environment附加或覆盖环境变量。
executor运行程序用于运行 CI/CD 作业的主机作系统上的环境或命令处理器。有关更多信息，请参阅 executors
shell用于生成脚本的 shell 的名称。默认值取决于平台。
clone_url覆盖GitLab 实例的 URL。仅当 runner 无法连接到 GitLab URL 时使用。

📄 示例


# Example `config.toml` file

concurrent = 20
check_interval = 0
connection_max_age = "15m0s"
shutdown_timeout = 0

[session_server]
  session_timeout = 1800

[[runners]]
  name = "某个项目"
  url = "http://git.xxx.com/"
  id = 55
  token = "PsEvWbVLP7nwqfiiBogH"
  token_obtained_at = 2025-01-07T03:43:45Z
  token_expires_at = 0001-01-01T00:00:00Z
  executor = "shell"
  shell = "pwsh"
  [runners.custom_build_dir]
  [runners.cache]
    MaxUploadedArchiveSize = 0
    [runners.cache.s3]
    [runners.cache.gcs]
    [runners.cache.azure]

[[runners]]
  name = "群组"
  url = "http://git.xxxx.com/"
  id = 58
  token = "BB8mSQ2TyZrxSGkDASgy"
  token_obtained_at = 2025-01-15T08:30:48Z
  token_expires_at = 0001-01-01T00:00:00Z
  executor = "shell"
  shell = "powershell"
  [runners.custom_build_dir]
  [runners.cache]
    MaxUploadedArchiveSize = 0
    [runners.cache.s3]
    [runners.cache.gcs]
    [runners.cache.azure]


5 运行

5.1 Windows 系统运行

🎈 启动服务

.\gitlab-runner-windows-amd64.exe install
Runtime platform          arch=amd64 os=windows pid=13172 revision=c4cbe9dd version=17.9.0

.\gitlab-runner-windows-amd64.exe start
Runtime platform          arch=amd64 os=windows pid=13172 revision=c4cbe9dd version=17.9.0

❓ 验证状态

 .\gitlab-runner-windows-amd64.exe status
Runtime platform         rch=amd64 os=windows pid=34096 revision=c4cbe9dd version=17.9.0
gitlab-runner: Service is running

若出现Service is running说明运行成功！

5.2 Linux 系统运行

🎈 启动服务
使用 systemctl 启动 GitLab Runner 并设置为开机自启动：

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

❓ 验证状态

 sudo systemctl status gitlab-runner

如果 GitLab Runner 正常运行，你应该会看到类似下面的输出：

● gitlab-runner.service - GitLab Runner
   Loaded: loaded (/etc/systemd/system/gitlab-runner.service; enabled; vendor preset: enabled)
   Active: active (running) since Sun 2025-03-10 14:21:05 UTC; 3min ago
     Docs: https://docs.gitlab.com/runner/
 Main PID: 1234 (gitlab-runner)
    Tasks: 6 (limit: 4915)
   Memory: 35.4M
   CGroup: /system.slice/gitlab-runner.service
           └─1234 /usr/bin/gitlab-runner run

📃 查看注册列表
确认 Runner 已正确注册到 GitLab 实例：

Linux:

sudo gitlab-runner list

Windows:

.\gitlab-runner-windows-amd64.exe list

输出示例：

Listing configured runners		ConfigFile=G:\project\GitLab-Runner\config.toml
HULU 测试						Executor=shell Token=dW68GD9n9w-gwkHTXCnS URL=http://git.gudsen-rd.com/
HULU 群组						Executor=shell Token=3_ZjysZJkDc51spUD96c URL=http://git.gudsen-rd.com/


6 实地演示


6.1 添加CI/CD文件

为了验证 GitLab Runner 是否正常工作，你可以通过 GitLab 提交一个简单的 CI 作业来进行测试。首先，确保在项目的根目录下有一个 .gitlab-ci.yml 文件。如果没有，可以创建一个最简单的 CI 配置：

stages:
  - test

test_job:
  stage: test
  script:
    - echo "Hello, GitLab Runner!"

将此文件提交到 GitLab 项目中，GitLab 会自动触发 CI 任务，GitLab Runner 会执行该任务并输出相关信息。

6.2 查看CI/CD状态

可以在 GitLab 项目的 CI / CD ——> Pipelines 页面查看任务状态。（这里演示三种状态）

🕛 阻塞状态：
在这里插入图片描述

原因分析：

这是由于没有对Runner注册该项目或者该群组导致的，参考步骤 3 注册即可。


🕛 失败状态：
在这里插入图片描述

原因分析：

环境变量里面没有检测到pwsh。

解决方案：

  1. 下载并安装 PowerShell Core 安装包，安装后把路径添加到环境变量中。
  2. 使用传统的 Windows PowerShell（powershell.exe）来执行 CI/CD 任务。
    • 打开 GitLab Runner 的配置文件config.toml（通常位于 C:\GitLab-Runner\config.toml）。
    • 在配置文件中找到类似以下的内容：
      [runners]
executor = "shell"
shell = "pwsh"  # 这里指定的是 pwsh
    • 将 shell 的值从 pwsh 改为 powershell，这样 GitLab Runner 将使用 Windows 自带的 PowerShell：
      [runners]
executor = "shell"
shell = "powershell"  # 修改为 powershell
    • 保存并关闭 config.toml 文件
    • 重新启动 GitLab Runner 服务：
      gitlab-runner restart


🕛 成功状态：
在这里插入图片描述
可以看到Hello, GitLab Runner! 的打印。

上一篇：《GitLab CI/CD学习教程 第一章概念》
下一篇：《GitLab CI/CD学习教程 第三章Pipeline》

K8S部署Java项目（Gitlab CI/CD自动化部署终极版）
博客主要分享技术教程、工具教程、bug解决、前沿技术动态、编程经验、心得感悟等。 内容同步、干货获取、推广宣发请看侧栏推广信息
02-26 5903
每个人都有惰性，但不断学习是好好生活的根本，共勉！
gitlab runner 安装、注册、配置、使用（Docker部署）
热门推荐
博客主要分享技术教程、工具教程、bug解决、前沿技术动态、编程经验、心得感悟等。 内容同步、干货获取、推广宣发请看侧栏推广信息
01-24 1万+
Gitlab Runner作为一个开源的项目，使用Go语言编写，可运行在不同系统重Gitlab Runner用于运行作业并将结果发给gitlab服务器Gitlab Runner与Gitlab CI结合使用，Gitlab CI是gitlab的开源持续集成服务，用于协调作业Gitlab Runner的版本安装时应注意与Gitlab版本尽量同步以防版本差异导致报错。
gitlab--基础--4.4--CICD--runner--配置
zhou920786312的博客
08-23 4198
将volumes = [“/root/.docker/config.json:/root/.docker/config.json”,“/root/.ssh/:/root/.ssh/”] 添加到config.toml文件的[runners.docker]里。使用 HTTPS 时要与对等方进行身份验证的私钥的文件。使用 HTTPS 时与对等方进行身份验证的证书的文件。在克隆 Git 存储库之后但在执行构建之前执行的命令。使用 HTTPS 时验证对等方的证书的文件。启用Sentry错误跟踪。
为GitLab项目配置CI/CD持续集成
joy_cz的专栏
05-21 908
为GitLab项目配置CI/CD持续集成 前提 1.已经安装好了Gitlab服务 2.准备一台linux服务器（示例以CentOS7） 3.这里以安装配置Gitlab-Runner，并且为Gitlab上某一项目配置Runner为例 4.安装的Runner以基于Linux为例，对应的Executor以docker为例 相关说明：Gitlab的CI/CD需要在项目下增加一个.gitlab-ci.ym...
GitLab Runner作为CI/CD
wangqiaowq的博客
07-30 988
CI（）持续集成，CD（）持续部署（也包含了持续交付的意思）。CD 指的是在我们 CI 流程通过之后，将代码自动发布到服务器的过程，这个过程也是自动化的。在开发人员提交代码之后，会触发 gitlab 的 CI 流水线。也就是上图的 CI PIPELINE，也就是中间的部分。在 CI 流水线中，我们可以配置多个任务。比如上图的 build、unit test、integration tests 等，也就是构建、单元测试、集成测试等。在 CI 流水线都通过之后，会触发 CD 流水线。
【CI/CD】详解如何配置gitlab-ci/cd
Future_0700_0000的博客
04-01 3148
gitlab：一个基于git的、开源的代码仓库管理平台，类似的平台还有github、gitee这些。CI：Continuous Integration 持续集成，对代码进行构建、编译、打包，得到产物 output.zipCD：Continuous Delivery 持续交付，将产物 output.zip部署到测试服务器（服务端及web端）、推送到内部的移动app安装平台（移动端），以供测试、验收。
GitLab-CI/CD指南
陈戏猿
08-10 2759
由于公司没有运维，写go服务时各个环境编译部署还是略显麻烦，由于代码管理使用的是 gitlab，所以决定使用 gitlab 自带的 CI/CD 来做自动编译和部署，这样每次提交代码以后就可以自动部署到服务器上了。Executor的类型在注册 Runner 的时候确定，比较常用的是 Docker 和 SSH。GitLab，Runner 和 Executor 之间的关系如下图所示(图片来自GitLab官方文档)。
GitLab Runner 使用教程
gitblog_00840的博客
08-16 1116
GitLab Runner 使用教程 gitlab-runnerMirror | Please open new issues in our issue tracker on GitLab.com项目地址:https://gitcode.com/gh_mirrors/gi/gitlab-runner 项目介绍 GitLab Runner 是一个用于运行作业并将结果发送回 GitLab 的代理。它...
gitlab runner使用教程
Things change, roll with them.
09-20 6382
一、gitlab-runner安装注册 1.docker下使用gitlab-runner Run GitLab Runner in a container – gitlab 1.1.安装docker # 如果yum-config-manager不可用：yum -y install yum-utils yum-config-manager --add-repo https://download.do...
完整详细的gitlab gitlab-runner CICD的安装使用教程
weixin_44131997的博客
02-20 3167
完整详细的gitlab gitlab-runner CICD教程
前端项目（vue3）自动化部署（Gitlab CI/CD）尚在完善中---＞
博客主要分享技术教程、工具教程、bug解决、前沿技术动态、编程经验、心得感悟等。 内容同步、干货获取、推广宣发请看侧栏推广信息
03-15 3291
正常部署前端项目时需要先打包后放到服务器上进行手动部署，现在我们尝试用Gitlab的CI/CD功能来实现自动化部署前端项目，节省部署操作时间以及避免过程中操作失误的可能。系统：linux centos。
复刻 OpenAI 式 DevOps 架构：AI 时代的新型 CI/CD 平台全景拆解
最新发布
在信息的熵增中，记录结构、重建秩序。 技术思想者的笔记，系统构建者的注释。
04-01 1267
本文深入解析 OpenAI 式 DevOps 架构的思维转变、系统结构、关键技术选型及落地路径。帮助你构建一个兼容模型构建、Prompt管理、灰度调度、反馈分析与安全审计的 AI DevOps 平台，实现从构建到反馈的智能闭环演进。
CI/CD 系统全景图：拆解一套现代 DevOps 工厂的底层结构与核心模块
在信息的熵增中，记录结构、重建秩序。 技术思想者的笔记，系统构建者的注释。
03-31 842
本篇从系统视角出发，全面拆解现代 CI/CD 系统的七大核心模块与完整数据流动路径，帮助开发者从“写脚本的使用者”升级为“智能工程系统的构建者”。通过 GitHub Actions、Jenkins 与华为 CodeArts 等主流平台对比，深入讲解触发器、Runner、构建产物、配置数据、日志流、AI 插件等模块构成与协作逻辑，构建你自己的 DevOps 工厂图谱，并为平台化、智能化 DevOps 体系奠定扎实基础。
配置.gitlab-ci.yml - 自定义流水线
Tri_C的博客
12-26 4649
参考官网： gitlab持续集成流水线配置 结合官网，以一种探索性的方式，展示gitlab持续集成流水线的搭建过程。 gitlab持续集成流水线 - 无中生有 如果您对“持续集成”“流水线”概念还处于模糊阶段，那么这节也许很适合您。 持续集成 gitlab持续集成流水线 - 加入自己的东西 gitlab持续集成流水线 - 重构，更简练更强复用性 ...
GitLab CI入门及实践操作
u014446463的博客
11-17 6774
假如我们有一个项目，已经部署在服务器上面了，然后但是我们想要修改其中的一个页面的部分功能，我们需要做些什么事情呢？ - 先拉取gitlab上的代码 - 对代码进行修改开发 - 测试代码是否正常运行 - 打包我们的前端代码 - 将代码重新上传服务器【要是是第一次部署服务器，那你得在服务器上安装你的项目所需要的环境，比如node，还得维护环境】 - 在服务器上看代码是否正常运行 - 提交代码 这样一看，非常麻烦，但凡我们想要修改一点儿东西都得经历上述步骤，时间也浪费了，也没法保证每次提交服务器都是正常运行的
Gitlab-Runner基础教程
weixin_34360651的博客
06-13 430
一、Intro jenkins和runner，作为主流自动化运维工具来说，两者的大思路其实是一样的，就是将我们提交到代码仓库的代码拉到jenkins或者runner运行的机器里，然后执行一系列的命令（这里通常是指打包和发布的命令，当然你想执行什么样的命令都是可以自己定义的） 二、Runner安装注册 准备工作 在gitlab创建个人项目，注意查看如下信息，在注册runner的时候会用到（必须是项目...
Gitlab-Runner部署全过程教程（指定版本安装、注册、卸载、后续配置等）
zzg11的博客
10-18 6823
还在为Gitlab-Runner部署而烦恼吗，按照我的教程来，手把手带你走完整个过程。本过程涉及Gitlab-Runner部署全过程教程，包含：指定版本安装、注册、卸载、后续配置等。
Gitlab CICD进阶教程
bocai_xiaodaidai的博客
01-27 7232
基于我所在公司的代码管理和发布流程，分享一套CICD最佳实践。 我们的项目有三个分支： master：生产分支，生产环境使用的分支 uat：测试分支，测试环境使用的分支 dev：开发分支，人少的话开发人员可直接在此分支上开发，也可基于此分支创建各自的分支，功能开发完合并再到dev分支 我们的工作流： 假如当前版本是1.0.0，即将发布一个新版本1.0.1。 1、开发人员在deb分支上开发，开发完1.0.1的功能后上传各自代码。 2、由项目负责人确认大家都提交了最新代码，提交MR，将dev
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值