一、安装

安装gitlab runner文档地址 docs.gitlab.com/runner/inst…

1.下载exe执行文件

我这里是 win64

https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-windows-amd64.exe

2.创建 gitlab-runner 目录，并进入目录

cd gitlab-runner

3.将上面下载的 gitlab-runner-windows-amd64.exe 放到 gitlab-runner 目录

# 当然不改也可以，这里改名是为了后面执行命令方便
改名成：gitlab-runner.exe

注意后续使用 .\gitlab-runner.exe 执行的命令都需要使用管理员身份运行否则会被拒绝

4.安装 gitlab-runner

使用系统账号安装gitlab-runner

这里使用默认系统用户安装，可能导致各种资源找不到或者权限问题
此时可以：
- 右键我的电脑、或者打开文件管理器->右键此电脑
- 选择管理
- 选择服务和应用程序-服务
- 找到 gitlab-runner 服务-右键选择属性-选择登陆tab-登陆身份选择此账户，浏览选择日常开发时候所用到的账户
- 设置好后，重启gitlab-runner 服务即可

.\gitlab-runner.exe install

使用指定账户安装gitlab-runner

重要的事情说三遍！！！重要的事情说三遍！！！重要的事情说三遍！！！大部分问题是这个没做好导致的！！！最好指定当前日常开发时候所用的用户，这样可以明确指定gitlab-runner使用当前开发用户的git、yarn、npm、node 等资源，而不会导致各种资源缺少或者权限问题

.\gitlab-runner.exe install --user your-username --password your-password

二、注册

registering runners 文档参考地址

1.注册一个gitlab-runner

注册的 gitlab-runner 分为共享runner和特定runner 共享runner，所有gitalb项目都可用特定runner，只对指定项目生效

这里我们注册特定runner

.\gitlab-runner.exe register

注册时候需要填写该runner关联的url和token，以及runner的描述和标签tags，还有runner执行时候的脚本类型 .gitlab-ci.yml 中执行任务中的tags，指定要运行的runner

url 和 token 在 gitlab 项目 ---> 设置 ---> CI/CD ---> Setup a specific Runner manually 获取回到 gitlab 页面，刷新即可看到注册的 runner 1644393508(1).png

三、构建

1.注册好后，在项目中添加`.gitlab-ci.yml`文件

在里面定义gitlab-runner所要执行的逻辑：

runner任务触发的时机
runner任务触发时候执行的脚本
等等

2.使用shell executor，构建项目时候，项目将会被克隆到以下目录：

<working-directory>/builds/<short-token>/<concurrent-id>/<namespace>/<project-name>
例如:D:\gitrunner\builds\58820ada\0\web-secure\webapp

项目的caches被存储到<working-directory>/cache/<namespace>/<project-name>

变量解释：

<working-directory>：runner当前执行的目录或者使用--working-directory指定的目录 
<short-token>：runner的token前8位 
<concurrent-id>：一个唯一的number，用于区别job，从0开始 
<namespace>：项目拥有者的名称
<project-name>：项目名

四、gitlab-runner 常用命令

.\gitlab-runner.exe install 安装
.\gitlab-runner.exe register 注册
.\gitlab-runner.exe start 启动
.\gitlab-runner.exe stop 停止
.\gitlab-runner.exe status 查看runner状态
.\gitlab-runner.exe list 查看runner列表

更新：
1、.\gitlab-runner.exe stop 
2、下载新版的gitlab-runner程序，替换掉当前的gitlab-runner.exe 
3、.\gitlab-runner.exe start

卸载：
.\gitlab-runner.exe stop
.\gitlab-runner.exe uninstall
cd .. 
rmdir /s gitlab-runner

gitlab-runner windows 安装