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方式，動手試試吧！