初探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

  1 version: '3'
  2 services:
  3   web: 
  4     build: .
  5     container_name: 'aspnetcore'
  6     ports:
  7       - '8003:80'

  docker-compose.yml

• 而后编写自动集成脚本

   1 build-master:
   2   image: docker:19.03.2
   3   stage: build              
   4 
   5   script:
   6     - docker --version
   7 
   8 image:
   9   name: docker/compose:1.24.1         #添加docker-compose，使用docker-compose编排镜像
  10   entrypoint: ["/bin/sh", "-c"]
  11 
  12 rtest:
  13   script:
  14     - docker-compose --version
  15     - docker-compose up -d --build --force-recreate

  .gitlab.ci.yml

•  

• 此时咱们把咱们的项目推送至咱们的gitlab服务器，就会开始自动构建了；jobs能够看到相关日志

•  

•  咱们访问到咱们的8003端口，能够看到控制器返回的内容

• 接下来，咱们修改下返回内容，提交至git服务器

• 此时，咱们再次访问咱们的8003端口能够看到，咱们的修改已生效=》

 

 

最后写下注意事项：

• 咱们的一整套操做都是基于Docker容器，包括服务的打包，以及交互，你们生产环境使用时候，
• 注意挂载下资料卷；runner是根据tag来编辑提交的代码，假如想让runner编译全部的提交，注意在runner配置中选择不设置tag也编译
• runner注册至gitlab时候，输入地址注意

 

也是刚开始了解Gitlab & gitlab-runner的ci 以及pipeline解决方案，假如文中有写错的地方欢迎你们批评指正。第一篇仅限极简的把CI服务搭建起来，并无涉及优化点，以及原理性的知识，敬请期待。。