部署 Jenkins

請提前在 Linux 上安裝 Docker，在 Linux 中，我們使用 Docker 啟動 Jenkins，這樣可以避免手動安裝大量依賴以及污染本地環境，也便于快速啟動和故障恢復。

安裝 Docker 完畢后，使用 docker version 檢查 Docker 版本，Docker 版本不能為 1.x、3.x 這種版本，請升級到 18.x 以上版本。一般在 Ubuntu 系統中，下載安裝的是最新版本，但是在 Centos 中因為默認鏡像源中的版本比較舊， 安裝 Doker 版本較低，需要手動添加新版本的鏡像源再升級。

請參考：https://www.jb51.net/article/243104.htm

因為會使用到容器提供環境，以及使用 Docker 打包 .NET Core 程序為 Docker 鏡像，所以需要在 Jenkins 容器中映射 Docker 的 .sock 文件，以便在容器中，還能使用 Docker 命令。

在宿主機中創建 /var/jenkins_home 目錄，用于備份 Jenkins 中的數據。

在 Linux 中使用 Docker 啟動 Jenkins ，其命令如下：

docker run \
  -u root \
  -itd \
  -p 8080:8080 \
  -p 50000:50000 \
  -v /var/jenkins_home:/var/jenkins_home \
  -v /var/run/docker.sock:/var/run/docker.sock \
  jenkinsci/blueocean

啟動后，使用 docker logs {容器ID} 查看日志獲取 Jenkins 登錄密碼，其密碼是一串哈希字符串，例如：1abc12445adcf。

最后打開 8080 端口，即可訪問 Jenkins。

安裝插件

登錄 Jenkins 后，會提示安裝推薦的插件，請根據提示安裝推薦的插件，推薦安裝的插件列表如下：

Folders Plugin
OWASP Markup Formatter Plugin
Build Timeout
Credentials Binding Plugin
Timestamper
Workspace Cleanup
Ant
Gradle
Pipeline
GitHub Branch Source Plugin
Pipeline: GitHub Groovy Libraries
Pipeline: Stage View
Git plugin
SSH Build Agents
Matrix Authorization Strategy Plugin
PAM Authentication
LDAP
Email Extension
Mailer Plugin
Localization: Chinese (Simplified)

另外為了提供容器打包支持等，需要另外手工安裝以下插件。

# 提供 Docker 支持（必裝）
docker
Docker Pipeline
docker-build-step

# 可視化設計流水線腳本的工具（必裝）
Blue Ocean

# 提供對 gitlab 支持，如果不使用可以不安裝
gitlab

# 提供 Git 參數化和鉤子觸發構建支持，不需要可以不安裝
Git Parameter
Generic Webhook Trigger

拉取鏡像

這里介紹一下我們后面要用到的兩個鏡像。

拉取一個 .NET Core SDK，每次啟動流水線時，都會啟動一個 .NET Core SDK 容器，為我們提供構編譯、發布 .NET Core 程序的環境。

docker pull mcr.microsoft.com/dotnet/sdk:3.1

拉取一個 ASP.NET Core Runtime，用于制作應用鏡像的基礎鏡像。

docker pull mcr.microsoft.com/dotnet/aspnet:3.1

鏡像列表：

mcr.microsoft.com/dotnet/aspnet   3.1          ac199e8d6dff   2 weeks ago   208MB
mcr.microsoft.com/dotnet/sdk      3.1          82e2a34647f0   2 weeks ago   710MB

制作 Jenkinsfile 腳本

筆者貼心地給各位同學準備了 Demo 項目，請到 https://github.com/whuanle/DotNetCoreJenkinsDemo 倉庫，fork 到你的倉庫，后續我們使用這個 ASP.NET Core 的 Demo 程序實踐流程。

在項目文件中，可以找到一個 Jenkinsfile 文件，此文件為我們定義流水線的步驟。

我們看一下簡單的 Jenkinsfile 模板：

pipeline {
    stages {
        stage('Build') {
            steps {
                echo 'Building..'
            }
        }
        stage('Test') {
            steps {
                echo 'Testing..'
            }
        }
        stage('Deploy') {
            steps {
                echo 'Deploying....'
            }
        }
    }
}

stages 中，定義流水線的階段，在模板中，一個定義了三個階段，分別是 Build、Test、Deploy。

每個階段都可以定義多個步驟(steps)，每個步驟中都可以執行多個不同類型的 step。

    stage('Test') {
        steps {
            echo 'Testing..'
        }
    }

demo 中的 Jenkinsfile 比較簡單，我們可以找個 Publish 階段的內容看一下：

        stage('Publish') { 
            steps {
                sh 'dotnet publish src/WebDemo -c Release'
            }
        }

其實很簡單，每個步驟執行 shell 命令就行，我們可以使用 sh '...' 表示此步驟要執行的 shell 命令。

接著我們看一下 Jenkinsfile 開頭的兩部分內容。

    // 全局環境變量
    environment {
        IMAGENAME     = 'webdemo'       // 鏡像名稱
        IMAGETAG      = '1.0.0'         // 鏡像標簽
        APPPORT       = '8089'          // 應用占用的端口
        APPDIR        = '/opt/app'      // 應用工作的目錄
    }

    agent {
        docker {
            image 'mcr.microsoft.com/dotnet/sdk:3.1' 
            args '-v /var/run/docker.sock:/var/run/docker.sock -v /usr/bin/docker:/usr/bin/docker'
        }
    }

environment 中，可以定義此次構建過程的環境變量。

agent 則是節點選擇器，可以選擇在何種環境下啟動流水線，有 node、docker 等類型。

構建流水線

登錄到 Jenkins 網頁后臺，在左側菜單欄中點擊?New Item，開始創建流水線。

Jenkins 有多種流水線風格，還可以通過添加插件，來加入更多的流水線類型，我們主要了解 Freestyle project 、Pipeline、Multibranch Pipeline 即可。

• Freestyle project

  Freestyle project流水線 使用上比較自由，不需要對項目做更改即可創建流水線，可以添加很多選擇、配置。如果流程需要變化，改動比較麻煩。

• Pineline、Multibranch Pipeline

  他們都可以同時處理多個分支，這兩種都是依賴于項目中的 Jenkinsfile 文件。Multibranch Pipeline 好處是可以同時檢查多個分支，為每個分支創建構建Job，而 Pipeline 會把多個分支放到一個 Job 中。

點擊?New Item?，創建流水線，選擇 Mutibranch Pipline。

添加 Git 源代碼 倉庫方式，我們可以自由選擇一種類型，建議使用?Single repository & branch。

由于我們沒有添加密鑰，所以 Jenkins 無法訪問你的 Github 倉庫，所以需要添加一個可訪問的密鑰。

找一臺已經安裝了 git 的電腦，生成公鑰私鑰，為 Jenkins 和 GitHub 之間提供加密連接。

執行命令：

ssh-keygen -t rsa -b 2048 -C "email@example.com"

根據提示，填寫要存放密鑰的路徑，如?D:/id_rsa。

執行命令后，會生成兩個文件，?id_rsa、id_rsa.pub，復制 id_rsa (私鑰)中的內容到 Jenkins 中。

然后把?id_rsa.pub?(公鑰)的內容添加到 Github 你的賬號中。

你可以使用多種方式添加認證方式，最簡單、安全的是密鑰，我們可以選擇?Secret file，然后上傳私鑰，或者使用別的方式，這里就不贅述了。

然后選擇要發布的分支，最后直接保存即可。

然后回到主界面，打開 我們創建的流水線，點擊 Build Now，即可啟動流水線。

構建成功截圖：

在 Linux 服務器上，查看鏡像列表：

root@localhost ~ 19:54:20 # docker images
REPOSITORY                        TAG          IMAGE ID       CREATED         SIZE
webdemo                           1.0.0        79b636ddef73   2 minutes ago   208MB

可以看到，已經自動打包應用為鏡像，其鏡像名稱和版本號，都可以在 Jenkinsfile 中設置。

觀察

我們可以在構建界面中，觀察每個步驟的日志。

在 Open Blue Ocean 中，有更加好看的 UI 和方便的工具。

可視化設計流水線步驟。

觀察構建過程。