网上教程很多,但断断续续,先不说大部分都是只截取片段,让人云里雾里,不会的看不懂,懂的不需要看,根据步骤跑不起来不说,改了一堆,完全不解释为什么,也分不清是官方要求还是作者自己夹带的私货。痛定思痛,抛弃任何教程,根据报错实时改进,于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了一个新的
结束
标签:webapi,run,部署,gitlab,runner,docker,com,终篇 From: https://www.cnblogs.com/gaoxiong666/p/17336256.html