Dockerfile+Jenkinsfile+GitLab轻松实现.NetCore程序的CI&CD

一.相关介绍

Dockerfile：关于Dockerfile的使用说明，我在文章《 让.NetCore程序跑在任何有docker的地方》中有说到，这里不在赘述，须要的能够先看下，本文主要介绍Jenkinsfile结合dockerfile配合使用，自动构建.NetCore应用程序。

 

Jenkinsfile ：Jenkinsfile 是 Jenkins 2.x 或更高版本核心特性 Pipeline（流水线） 的脚本，或者说对于Jenkins 流水线的定义被写在一个叫Jenkinsfile的文本文件中，该文件能够被提交到项目的源代码的控制仓库。这是"流水线即代码"的基础; 将CD 流水线做为应用程序的一部分，像其余代码同样进行版本化和审查。 建立 `Jenkinsfile`并提交它到源代码控制中提供了如下几个好处:

• 自动地为全部分支建立流水线构建过程并拉取请求。
• 在流水线上代码复查/迭代 (以及剩余的源代码)。
• 对流水线进行审计跟踪。
• 该流水线的真正的源代码 , 能够被项目的多个成员查看和编辑。

Jenkinsfile 能使用两种语法进行编写，分别是“声明式”和“脚本化”，两者语法都是 DSL(Domain-specific language) 语言，两者语法差很少，下面咱们具体看下

 

 

二.Jenkins和GitLab的安装

工欲善其事，必先利其器

Jenkins的安装能够看我以前的一篇文章： http://www.javashuo.com/article/p-mfjtggon-hu.html

Gitlab的安装推荐看下这篇文章： http://www.javashuo.com/article/p-airwuuml-cn.html

 

三.打通GitLab Webhooks与Jenkins流程

1.这里先新建一个.net core应用程序，除了新增长了一个Jenkinsfile文件之外，其余没有任何代码的修改

注意，Jenkinsfile的J须要大写，我测试了，小写会提示找不到文件.

Jenkinsfile中添加了几行测试代码：

pipeline{
    agent any
    stages {
        stage('Build') {
            steps{
                echo 'This is a build step' 
            }
        }
        stage('Test') {
            steps{
                echo 'This is a test step'  
            }
        }
        stage('Deploy') {
            steps{
                echo 'This is a deploy step'    
            }
        }
    }
}

而后将程序文件push到Gitlab上

 

2.在Jenkins系统管理，系统配置中，在Gitlab处添加相关信息

 

 

下面点击添加凭据，类型选择GitLab Api Token，因为这个Token须要由GitLab来提供，因此先到GitLab生成一个Api Token

 

3.生成Api Token

 

 

点击建立以后，Token就生效了

 

将Api Token复制到Jenkins中，点击添加

添加完成后，就能够在 Credentials中选择刚刚添加好的凭据

点击保存，这样系统配置中的Gitlab的全局配置就生效了

 

4.新建流水线任务测试

下面打开Jenkins，新建一个流水线发布任务，取名test，而后点击肯定.

勾选构建触发器

因为咱们须要达到的目的是在GitLab提交代码，Jenkins能够自动构建相关任务，因此咱们还须要配置一个触发器。如图，点击下面的"高级"按钮

点击“ Generate”，生成一个 SecretToken

而后再流水线Tab定义处，下拉选择“ Pipeline script from SCM”， SCM选择Git，而后填写代码库的地址和访问用户密码，下面脚本路径有个Jenkinsfile，意思就是从咱们提交到源代码管理根目录下面的Jenkinsfile中读取相关定义好的的流水线任务流程

点击保存

 

在Gitlab以下图地方进入，来配置web钩子

 

将在Jenkin中截图的一个url和生成的token分别填写在下方，在触发器的地方勾选上 Push events，而后点击下方的“ Add webhook” 按钮。若是你还有其余事件发生时想触发Jenkins的任务，也能够自行勾选上

添加完成后点击测试

这个时候能够看到上方出现了成功的提示

而另外一边Jenkins中，正在执行任务，而且任务的执行是 GitLab有推送任务

 完成以后，能够看到流水线任务流程图

下面经过代码推送来测一下，我在跟目录新建一个空的 README.md文件，而后推送，推送完成后能够看到Jenkins开始执行第二次构建任务

至此，从GitLab提交代码到Jenkins自动构建的整个流程已经完成了，细心的你会发现，只是流程跑通了，这个Jenkinsfile没有实质性的内容，下面进入Jenkinsfile

 

四.接入Jenkinsfile，Dockerfile实现自动发布

编写Dockerfile以下：

FROM mcr.microsoft.com/dotnet/core/sdk:3.1-buster AS build
COPY *.csproj ./app/
WORKDIR /app
RUN dotnet restore

COPY . ./
RUN dotnet publish -o out /p:PublishWithAspNetCoreTargetManifest="false"

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1-buster-slim AS runtime
ENV ASPNETCORE_URLS http://+:80
WORKDIR /app
COPY --from=build /app/out ./
ENTRYPOINT ["dotnet", "WebApplication_Jenkinsfile.dll"]

 

编写Jenkinsfile以下：

pipeline{
    agent any
    stages {
        stage('Checkout') {
            steps{
            git credentialsId: '85ca7e47-532e-4901-9828-50a8da071d16', url: 'http://xxx.gitlab.com/webapplication_jenkinsfile.git', branch:'master'
                    echo '---This is a Checkout step---'                 
            }
        }
        stage('Build') {
            steps{
                    sh '''cd WebApplication_Jenkinsfile
            docker rmi -f docker_webapplication_test:1.0
            docker build -t docker_webapplication_test:1.0 .'''
            echo '---This is a Build step---'
            }
        }
        stage('Run') {
            steps{
            sh '''docker rm -f docker_webapplication_test
            docker run --name docker_webapplication_test -d -p 7489:80 docker_webapplication_test:1.0
            '''
                    echo '---This is a run step---'    
            }
        }
    }
}

说明:

stages 必须，包括顺序执行的一个或多个stage命令，在pipeline内仅能使用一次，一般位于agent/options后面

steps 必须，steps位于stage指令块内部，包括一个或多个step。仅有一个step的状况下能够忽略关键字step及其{}

这里为了演示，只添加了几个核心的步骤，能够根据须要自行添加自动测试，邮件提醒等额外步骤

 

流水线语法，能够参照下图中的示例步骤点击后，能够生成脚本信息，上面Jenkinsfile中的git credentialsId信息就是在这里生成的

 

完成以后，将Jenkinsfile和Dockerfile推送到Gitlab，推送成功能够看到以下图的Jenkins自动构建过程，而且遵守定义规范发布了应用

 

 

若是须要查看日志，或者在发布失败后查看失败缘由，能够经过下面的 Console Output来查看

Console Output中的详细日志信息以下图，能够看到构建过程是遵循在Dockerfile中的定义

docker 容器运行状态检查

自动部署效果截图

五.结束总结

在定义web钩子的时候，我勾选的是push events，因此每次有提交代码到master，都会自动去走Jenkinsfile中的流水线任务，在实际生产中，若是不想这样操做，能够将持续集成流水线与持续发布流水线独立开来

其实只须要前期一次将Jenkins和Gitlab触发器打通以后，后面只须要在源代码中维护Dockerfile和Jenkinsfile便可，这是比较优雅的一种CI、CD方式，动手试试吧！