Windows中Gitlab-Runner的安装

写在最前

最近在学CI/CD，写完的yml，想先在本地测试看看
所以就有了在本机上安装gitlab-runner的需求
虽然gitlab官方的安装文档给写的已经很详细了，但是由于是英文文档
加上我在安装时也走了点弯路，以及网上的教程多以linux和mac的安装为主(相信多数人工作中还是使用windows的多吧
为了备忘以及后来人能少走弯路，决定写下安装过程
由于各人机器环境不同，此文可能并不能完全解决你遇到的问题
未竟事宜留言讨论

正文

下面我会按照官方文档的操作来，并在其中加入自己的理解和说明 文档原文

1. 创建一个文件夹 比如C:\GitLab-Runner 此步骤非必要(但最好做)主要是为了方便下面的注册、安装步骤

2. 下载exe可执行文件64位或32位，将下载的exe文件放到第一步的目录下，你可以重命名此可执行文件为gitlab-runner.exe(可选)，更多的版本详见

3. 确保exe有写入权限 可忽略原因下面说

4. 打开一个命令行 cmd/PowerShell都行
   但需要注意，请用管理员身份执行
   cmd的管理员权限:win+R输入Taskmgr回车，打开任务管理器，文件-运行新任务，输入cmd，并勾选下面方的以系统管理权限创建此任务
   PowerShelle的管理员权限：win+X再按A确认

5. 注册运行器 文档原文

   准备工作

   • 可以在一个独立的电脑上安装，而不是非得是装了Gitlab的那台
   • 获取授权Token
     • 对于共享运行器，得让管理员去GitLab Admin Area里的Overview > Runners中添加
     • 对于组运行器，去Settings > CI/CD 展开Runner节点
     • 对于项目指定的运行器，去Settings > CI/CD 展开Runner节点 这里的Settings是项目的Settings不是账户的Settings

   Windows

   因为是测试用，所以我选择直接在Windows上安装，其他安装方式请查阅文档

   1. 执行cd命令进入上文exe的目录，调用exe执行register，具体命令

      cd C:\GitLab-Runner  
      ./gitlab-runner.exe register    //使用exe的名字 不用全部敲出来，可按Tab键补齐  
      

   2. 接下来根据提示输入Gitlab的地址，比如https://gitlab.com 这步操作实际是告诉gitlab-runner去连接此地址
   3. 输入准备工作中获得的token
   4. 输入runner的描述 描述和下步的标签都可以在Gitlab网页上修改
   5. 输入标签Tags 多个标签用逗号隔开
   6. 选择runner的执行器，大多数情况下，选docker 有virtualbox, docker, docker-windows, shell, ssh, docker-ssh+machine, kubernetes, custom, docker-ssh, parallels, docker+machine可供选择
   7. 如果上一步选的是docker，你还要选择yml中未指定时的默认镜像
   示例

   D:\GitLab-Runner>gitlab-runner-windows-amd64.exe register  
   Runtime platform                                    arch=amd64 os=windows pid=39504 revision=8925d9a0 version=14.1.0  
   Enter the GitLab instance URL (for example, https://gitlab.com/):  
   https://gitlab.com/  
   Enter the registration token:  
   xxxxxxx  
   Enter a description for the runner:  
   [computername]:  
   Enter tags for the runner (comma-separated):  
   
   Registering runner... succeeded                     runner=HsQECyAn  
   Enter an executor: virtualbox, docker, docker-windows, shell, ssh, docker-ssh+machine, kubernetes, custom, docker-ssh, parallels, docker+machine:  
   docker  
   Enter the default Docker image (for example, ruby:2.6):  
   alpine:latest  
   Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!  
   

6. 把Gitlab安装成一个服务并启动

   cd C:\GitLab-Runner
   .\gitlab-runner.exe install
   .\gitlab-runner.exe start
   

   如果在步骤4没法使用管理员权限 那你也可以为自己的账户安装gitlab runner服务

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

7. (可选) 修改C:\GitLab-Runner\config.toml配置文件启用多并发任务，高级配置信息，你也可以在高级配置里使用Bash或PowerShell来取代Bat
   此段大部分人都可忽略，毕竟是用来本地测试的并不需要用到什么高级配置，有需要的自行了解

做完上面的步骤，你就可以在你的项目设置-CI/CD里看到此runner了
本教程的任务完成