docker部署gitlab CI/CD (二)终篇:部署gitlab runner和添加gitlab-ci.yml文件 终极踩坑版

发布时间 2023-04-24 10:33:27作者: 戈凹高

网上教程很多,但断断续续,先不说大部分都是只截取片段,让人云里雾里,不会的看不懂,懂的不需要看,根据步骤跑不起来不说,改了一堆,完全不解释为什么,也分不清是官方要求还是作者自己夹带的私货。痛定思痛,抛弃任何教程,根据报错实时改进,于2023年4月24日完成此篇。

官方文档:

  https://docs.gitlab.com/runner/install/docker.html

前提:

  已部署gitlab,可参阅 docker部署gitlab CI/CD (一)第一篇:部署gitlab及汉化,内附官方文档链接

开始:

  #1.拉取并启动runner

 docker run -d --name runner --network=host --restart always -v /srv/gitlab-runner/config:/etc/gitlab-runner -v /var/run/docker.sock:/var/run/docker.sock gitlab/gitlab-runner:latest

官网没有--network=host这句话,正常情况不需要加。但是我在公司实际测试中,在后面的过程会说请求不到gitlab,加上这句话就好了

注意,挂载目录不能改,不然到最后会报错,找不到docker的守护进程:Preparation failed: Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?

  #2.进入容器内部

docker exec -it 容器id /bin/bash

  #3.runner注册

gitlab-runner register

 如图,打开你的项目设置,把URL和token都复制进入

 如图,自己填,tag需要记一下,后续的ci文件里要用到,镜像由于注册的时候还不懂,随便填了一个,应该填你的项目依赖的环境镜像,mcr.microsoft.com/dotnet/sdk:6.0,随便填也无所谓,yml文件里可以指定

如下图,刷新你的设置页面,会显示已经有了

  #4.docker部署的必要环节:修改runner的config文件

默认他会每次拉取hub里的镜像,我想改成使用本地镜像,可以用vi命令,也可以自己用其他方法改

vi /srv/gitlab-runner/config/config.toml

有就改,没有就结尾加上 pull_policy = "if-not-present"

由于runner默认不识别docker命令,所以 volumes加上 "/usr/bin/docker:/usr/bin/docker", "/var/run/docker.sock:/var/run/docker.sock"

官方配置说明:https://docs.gitlab.com/runner/configuration/advanced-configuration.html

改完就生效,不用重启

   #5.添加.gitlab-ci.yml文件

项目根目录创建.gitlab-ci.yml文件,官方各语言项目模板参考:https://gitlab.com/gitlab-org/gitlab/-/tree/master/lib/gitlab/ci/templates

以下附上net6项目的简略文件

image: mcr.microsoft.com/dotnet/sdk:6.0

variables:
  VERSION: "$CI_PIPELINE_ID"

stages:
  - deploy

deploy:
  stage: deploy
  script:
    - echo "开始构建镜像:webapi:${VERSION}"
    - docker build -t webapi:${VERSION} -f ./webapi/Dockerfile .
    - if [ $(docker ps -aq --filter name=webapi) ]; then 
        echo "暂停旧版容器";
        docker stop webapi;
        echo "删除旧版容器";
        docker rm webapi;
      fi
    - echo "启动新容器"
    - docker run -d --name webapi -p 5566:5566 -p 5567:5567 webapi:${VERSION} 
only: 
  - production 
tags: 
  - dotnet

解释:

image:mcr.microsoft.com/dotnet/sdk:6.0。依赖net6环境

stages: 定义了多个构建阶段,部署(deploy)阶段。这些阶段将按照定义的顺序依次执行。

$CI_PIPELINE_ID:内置变量,取当前流水线id为版本号

if,如果存在名为webapi的容器,就暂停并删除容器

only: -production  只有production分钟的改动才启动deploy阶段

tages: 用于为任务指定标签,让标签为dotnet的runner执行。

  #6.把环境拉取到本地

因为前文把runner改为了使用本地镜像,所以需要先把net6sdk拉取到本地

docker pull mcr.microsoft.com/dotnet/sdk:6.0

  #7.项目提交改动到gitlab

个人建议先拿前端项目练手,因为后端项目依赖比较复杂,坑比较多,我这还涉及依赖私有nuget包等问题,带来的挫折感,陆陆续续搞了两周才完事。

提交改动,然后打开项目的CI/CD流水线,等一等就会发现已经通过

查看控制台,也可以看到,任务执行成功,build成功,且把我docker里的旧容器删了,重新拿新镜像run了一个新的

结束