gitlab-runner安装注册

末蓝、 2022-12-28 15:28 301阅读 0赞

**目录**

gitlab-runner的安装

gitlab-runner的类型

gitlab-runner的注册

CICD持续集成和部署

案列分享

FAQ

问题1：

问题2：

问题3：

--------------------

## gitlab-runner的安装 ##

curl --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-darwin-amd64"
    
    chmod +x /usr/local/bin/gitlab-runner

## gitlab-runner的类型 ##

如下所示gitlab-runner分为shared、group、specific等几个类型

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70][]

## gitlab-runner的注册 ##

下面我们注册一个shared类型的runner. 通过管理员登录 gitlab ---- Admin area----Overview ---- Runner   查看需要注册的 URL与 Token（令牌）

#交互式
    # gitlab-runner register
    Runtime platform                                    arch=amd64 os=linux pid=28542 revision=8fa89735 version=13.6.0
    Running in system-mode.                            
                                                       
    Enter the GitLab instance URL (for example, https://gitlab.com/):
    http://172.16.xx.xx:84/
    Enter the registration token:
    CHLiFzF-BxVkAauJEim7
    Enter a description for the runner:
    [db003-hf-xxx]: develop   
    Enter tags for the runner (comma-separated):
    develop
    Registering runner... succeeded                     runner=CHLiFzF-
       
    Enter an executor: docker-ssh, parallels, shell, ssh, docker+machine, docker-ssh+machine, custom, virtualbox, kubernetes, docker:
    shell 
    Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded! 
    
    
    #非交互式
    gitlab-runner register --non-interactive --executor 'shell' --url 'http://172.16.xx.xx:84//' --registration-token 'CHLiFzF-BxVkAauJEim7'
    Runtime platform                                    arch=amd64 os=linux pid=28016 revision=8fa89735 version=13.6.0
    Running in system-mode.                            
                                                       
    Registering runner... succeeded                     runner=CHLiFzF-
    Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!

注册完可以在页面中看到一个shared类型的runner.

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 1][]

上面注册的时候，我们选择了shell类型的执行器，下面是几个常见执行器的功能对比表

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 2][]

## CICD持续集成和部署 ##

创建一个项目，然后修改代码，推送到master分支后，自动完成流水线工作

在项目的根下，创建**[.gitlab-ci.yml][]**文件，内容如下：

stages:
      - build
      - deploy
    
    build:
      stage: build
      tags:
        - deploy
      only:
        - master
      script:
        - echo "mvn clean"
        - echo "mvn install"
    
    deploy:
      stage: deploy
      tags:
        - deploy
      only:
        - master
      script:
        - echo "hello deploy"

当我们编辑任意文件，提交到master分支后，流水线开始工作，成功后，如下所示。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 3][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 4][]

由上图可以看出，流水线工作已经开启，对于具体的任务，需要在**[.gitlab-ci.yml][]**文件中编写。

## 案列分享 ##

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 5][]

gitlab-ci.yml文件

include:
      - '/templates/.before-script.yml'
        
    stages:
      - build
      - deploy_sha
      - deploy_tag
      
        
    build:
      stage: build
      tags:
        - deploy
      only:
        - master
      script: 
        - docker build -t 172.16.xx.xx:85/testproject/$SERVICE_NAME:$CI_COMMIT_SHA .
    
    deploy_sha:
      stage: deploy_sha
      tags:
        - deploy
      only:
        - master
      script: |
        set -e -o pipefail
        docker login -u admin -p 123456  172.16.xx.xx:85 
        docker push 172.16.xx.xx:85/testproject/$SERVICE_NAME:$CI_COMMIT_SHA
    
    
    deploy_tag:
      stage: deploy_tag
      tags:
        - deploy
      only:
        - tags
      script: |
        set -e -o pipefail
        docker login -u admin -p 123456  172.16.xx.xx:85 
        docker tag 172.16.xx.xx:85/testproject/$SERVICE_NAME:$CI_COMMIT_SHA  172.16.154.14:85/testproject/$SERVICE_NAME:$CI_COMMIT_TAG
        docker push 172.16.xx.xx:85/testproject/$SERVICE_NAME:$CI_COMMIT_TAG

触发构建机制，然后可以看到两个job，以及镜像已经推送到harbor私有仓库中

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 6][]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 7][]

## FAQ ##

### 问题1： ###

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 8][]

升级git操作，可自行百度。

### 问题2： ###

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 9][]

[解决方案][Link 1]，给gitlab-runner用户添加权限。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 10][]

### 问题3： ###

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 11][]

需要给docker添加访问harbor的权限

docker login -u admin -p 123456  172.16.xx.xx:85     #harbor的登陆名和密码

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70]: /images/20221120/a58db6eea5f945c78911e58854804106.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 1]: /images/20221120/577216485ead4aec842e1ea743b6b8f0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 2]: /images/20221120/8d98d9ba4cfc4522aa91ca67343b0d42.png
[.gitlab-ci.yml]: http://172.16.154.14:84/root/vue3-demo/-/blob/master/.gitlab-ci.yml
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20201222224048904.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/20201222223355806.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 5]: https://img-blog.csdnimg.cn/2021011310420495.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 6]: https://img-blog.csdnimg.cn/20210113104903213.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 7]: https://img-blog.csdnimg.cn/20210113104826279.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 8]: https://img-blog.csdnimg.cn/20210113105051518.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 9]: https://img-blog.csdnimg.cn/20210113105151452.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc=,size_16,color_FFFFFF,t_70
[Link 1]: https://stackoverflow.com/questions/47854463/docker-got-permission-denied-while-trying-to-connect-to-the-docker-daemon-socke
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 10]: https://img-blog.csdnimg.cn/20210113104957817.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc=,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc_size_16_color_FFFFFF_t_70 11]: https://img-blog.csdnimg.cn/20210113105308705.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5bDk1Mjc=,size_16,color_FFFFFF,t_70