• 【云原生】DevOps之使用Gitlab Runner进行CICD


    前言

    在很久之前的文章中,我们已经搭建过了Jenkins+Docker+Harbor+SpringCloud微服务持续集成自动化部署,今天来介绍Gitlab原生的Gitlab Runner CICD功能。

    一、Gitlab Runner简介

    Gitlab实现CICD的方式有很多,比如通过Jenkins,通过Gitlab Runner等,今天主要介绍后者。Gitlab在安装的时候,就默认包含了Gitlab CI的能力,但是该能力只是用于协调作业,并不能真的去执行作业,因此需要搭配Gitlab Runner来作为执行器实现具体的CICD工作。Gitlab Runner可以被安装在任意支持的系统上,比如Linux、Windows、Mac,甚至也可以运行在Docker、Kubernetes集群上。

    Gitlab Runner分为三种类型,在注册Runner过程中使用不同类型的token就能区分不同的类型。

    • Shared Runners,共享Runner,可以被仓库里面的任意项目使用;token获取位置为全局管理中心-Runner-注册令牌;
    • Group Runners,组Runner,仅能被某个组中的任意项目使用;token获取位置为项目群组-CICD-Runner-注册令牌;
    • Specific Runners,特定Runner,仅能被指定的项目使用;token获取位置为项目-设置-CICD-Runner-注册令牌;

    如下是Gitlab Runner 的大致工作流程示意:

    在这里插入图片描述

    二、Gitlab Runner注册

    2.1 使用Docker安装

    GitLab Runner在不同平台的注册可以在官网找到教程,本文就以Docker方式讲解如何进行注册,在开始之前,确保我们的电脑上已经安装好了Docker,没安装的同学请看这篇文章Docker入门精讲

    首先我们需要下载Gitlab Runner的镜像,并运行起来:

    # 如果需要把配置文件挂载到宿主机的某个目录,可以自行修改
    docker run -d --name gitlab-runner-01 --restart always -v /srv/gitlab-runner/config:/etc/gitlab-runner -v /var/run/docker.sock:/var/run/docker.sock gitlab/gitlab-runner:latest
    
    • 1
    • 2

    然后执行注册命令:

    # 进入容器内部并执行注册命令
    docker exec -it gitlab-runner-01 gitlab-runner register
    Runtime platform                                    arch=amd64 os=linux pid=37 revision=bbcb5aba version=15.3.0
    Running in system-mode.
    
    # 填写gitlab的地址,确保容器内能够顺利访问到该地址
    Enter the GitLab instance URL (for example, https://gitlab.com/):
    http://10.96.12.149/
    # 填写需要注册的runner token,此处选择shared runner token
    Enter the registration token:
    BHRagrsztQAxdMPPhxGm
    # 描述信息随意填写,也可不填
    Enter a description for the runner:
    [caa2879d6833]: gitlab-runner-01
    # tag随意填写,此处不填
    Enter tags for the runner (comma-separated):
    # 随意填写,此处不填
    Enter optional maintenance note for the runner:
    
    Registering runner... succeeded                     runner=BHRagrsz
    # 选择执行器的种类,建议选择docker
    Enter an executor: docker, shell, ssh, kubernetes, custom, docker-ssh, parallels, virtualbox, docker+machine, docker-ssh+machine:
    docker
    # 使用最新版本
    Enter the default Docker image (for example, ruby:2.7):
    docker:latest
    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"
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29

    2.2 容器注册的runner

    此时,我们在gitlab的runner界面就能看到已经注册好的runner信息了:

    在这里插入图片描述

    其余系统或者环境注册runner的过程就不再赘述了,基本相同,详情参考文档。

    三、Gitlab Runner运行

    我们首先准备一个项目,这个项目内容很简单,只是作为runner演示使用,总共两个文件:

    • index.html,用来表示项目的主页;

      DOCTYPE html>
      <html lang="en">
      <head>
          <meta charset="UTF-8">
          <title>CICD测试title>
      head>
      <body>
      <h1>Gitlab CICD 测试!!!h1>
      body>
      html>
      
      • 1
      • 2
      • 3
      • 4
      • 5
      • 6
      • 7
      • 8
      • 9
      • 10
    • .gitlab-ci.yml,定义CICD流程的文件;

      build-job:
        stage: build
        script:
          - echo "Hello, $GITLAB_USER_LOGIN!"
      
      test-job1:
        stage: test
        script:
          - echo "This job tests something"
      
      test-job2:
        stage: test
        script:
          - echo "This job tests something, but takes more time than test-job1."
          - echo "After the echo commands complete, it runs the sleep command for 20 seconds"
          - echo "which simulates a test that runs 20 seconds longer than test-job1"
          - sleep 20
      
      deploy-prod:
        stage: deploy
        script:
          - echo "This job deploys something from the $CI_COMMIT_BRANCH branch."
      
      • 1
      • 2
      • 3
      • 4
      • 5
      • 6
      • 7
      • 8
      • 9
      • 10
      • 11
      • 12
      • 13
      • 14
      • 15
      • 16
      • 17
      • 18
      • 19
      • 20
      • 21
      • 22

      大致的意思是,build阶段启动一个作业,输出一段文本;test阶段并行启动两个作业,也是分别输出一段文本;deploy阶段启动一个作业,输出一段文本;这三个阶段分别模拟了构建、测试、部署流程,具体的语法关键词等内容不属于本文范畴,可以参考官网。

      3.1 测试项目

    以上项目内容提交到gitlab后,显示如下,仅有master分支:

    在这里插入图片描述

    3.2 运行流水线

    此时,任意的提交行为、合并行为都会触发流水线的执行,但是也可以手动执行,我们此时选择项目中的CICD,流水线,并点击运行流水线。

    在这里插入图片描述

    3.3 流水线运行界面

    如下是运行中的流水线状态,可以查看各个阶段的任务,点击任务图标还可以查看具体的任务执行明细。

    在这里插入图片描述

    3.4 runner任务运行数量统计

    需要注意的是,流水线中包含多个任务时,这些任务是会被Gitlab CI随机调度到可以运行的runner上运行的,并非一直在某一个runner上,如下是运行三次流水线,每个runner的任务执行数量统计:

    在这里插入图片描述

    至此,我们完成了两个runner的搭建和注册,并运行了示例项目中的流水线。后面文章我们再讲解工业级流水线的配置和高级的CICD内容。

    参考资料

    GitLab Runner | GitLab

  • 相关阅读:
    Java入门教程(11) ——基本数据类型
    I/O设备的分配与回收
    用最少数量的箭引爆气球(Java)
    微服务建构思想
    win11安装ubuntu(by wsl2)
    使用UniApp实现视频数组自动下载与播放功能:一步步指导
    (前端)「备忘录」设计模式在项目开发中的应用
    Qt Installation命名问题导致vs编译Qt项目出错
    Mybatis单表查询
    百花齐放:解锁大型语言模型的潜力 | 开源专题 No.32
  • 原文地址:https://blog.csdn.net/weixin_42469135/article/details/127379960