欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

Windows中Gitlab-Runner的安装

程序员文章站 2022-06-11 19:03:25
...

写在最前

最近在学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了
本教程的任务完成

相关标签: windows gitlab