初探gitlab & gitlab-runner & asp.net core持续集成

•  gitlab & gitlab-runner 简介

•  基于gitlab & gitlab-runner 的asp.net core webapi 极简持续集成实践

 

gitlab & gitlab-runner 简介

写在最前面，文中示例使用到了docker & docker-compose 相关知识，文中的gitlab server 以及 gitlab-runner都是使用docker容器，以及gitlab-runner的执行方式也是docker模式，相关内容不再赘述，但是注意点会在文中标注。

gitlab是一款基于git的代码管理平台， 可以基于此做代码管理，以及相关CI-CD操作。gitlab-runner是一个代码持续集成工具，将其注册至gitlab后可以基于此做相关的CI-CD。

持续集成流程大致分为三步，1）本地用户将代码上传至gitlab仓库 2）gitlab-runner接收代码推送事件，从gitlab拉取相关代码（需要将runner注册至gitlab&将创建项目委托给runner）  3）runner执行自动集成脚本（.gitlab.ci.yml），编译发布服务。如图所示=》

 

文档传送门=>gitlab https://docs.gitlab.com/ee/README.html  gitlab-runner  https://docs.gitlab.com/runner/

极简实践

• 从dockerhub下载gitlab & gitlab-runner 镜像  

  docker pull gitlab/gitlab-ce  & docker pull gitlab/gitlab-runner

• 创建gitlab & gitlab-runner容器

  docker run -d --hostname localhost -p 10080:80 -p 10443:443 --name gitlab -v /var/run/docker.sock:/var/run/docker.sock gitlab/gitlab-ce:latest 
  docker run -d --name gitlab-runner --link gitlab -v /var/run/docker.sock:/var/run/docker.sock --restart always gitlab/gitlab-runner:latest      -- 这里注意下，runner启动容器时候需要-v 
  /var/run/docker.sock:/var/run/docker.sock命令将本地的docker服务套接在runner容器上（直白点就是runner容器可以使用本机docker服务） ;--link将runner容器链接到gitlab容器

• 等gitlab启动几分钟，此时我们可以看到现在有两个正在运行的容器
• 接下来访问我们本机的10080端口就可以访问到我们的gitlab了，第一次进入需要初始化密码。顺便我们现在再创建一个叫做tony的用户。登录后，是这样的一个界面=》

•  

   接下来，我们注册gitlab-runner。 注册的目的是将gitlab-runner 与 gitlab绑定起来。回到我们的powershell（命令行）界面，执行命令。我们依次需要填写我们的gitlab地址，服务token，描述信息，tag标签（runner会根据tag标签来决定自动编译项目的推送也可以修改runner配置执行所有推送），runner执行模式（这里我们选docker），以及默认镜像。gitlab地址和token我们需要以管理员身份进入gitlab服务，选择Overview的Runners菜单查看。这里注意，gitlab地址不可以写localhost，会导致runner找不到gitlab（每一个docker容器相当于独立的服务器）

  docker exec -it gitlab-runner gitlab-runner register

• 

• runner注册成功后，我们进入gitlab的的runner页面会出现我们注册的runner;此时我们切换tony用户，创建一个项目（我这里的mywebsite)；回到root用户，将runner分配给这个项目（同时把不需要tag就可以执行编译的选项选上）；这时候，我们的mywebsite项目就托管在了注册的runner上了。

• 

• 然后我们创建一个asp.net core v2.2的webapi项目，并为其编写dockerfile ，容器编排我们使用docker-compose的方式。主要文件内容

   1 FROM  mcr.microsoft.com/dotnet/core/sdk:2.2 as build-env
   2 # code目录
   3 WORKDIR /code  
   4 
   5 #项目拷贝至code
   6 COPY *.csproj ./ 
   7 RUN dotnet restore
   8 
   9 # #代码拷贝至code
  10 COPY  . ./
  11 # #发布文件在code/out文件夹
  12 RUN dotnet publish -c Release -o out
  13 # #找到runtime 
  14 FROM mcr.microsoft.com/dotnet/core/aspnet:2.2
  15 # #新建一个目录app
  16 WORKDIR /app
  17 # #code目录发布的代码文件放到app
  18 COPY --from=build-env /code/out ./
  19 # 输出到80端口
  20 EXPOSE 80
  21 ENTRYPOINT [ "dotnet","tonywebsite.dll" ]

  DockerFile