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

关于gitlab部署的教程还好，有的看，但到了cicd环节，简直痛苦面具，教程虽多，但断断续续，先不说大部分都是只截取片段，让人云里雾里，不会的看不懂，懂的不需要看，根据步骤跑不起来不说，改了一堆，完全不解释为什么，也分不清是官方要求还是作者自己夹带的私货。痛定思痛，抛弃任何教程，根据报错实时改进，于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了一个新的

结束