Jenkins手把手圖文教程[基於Jenkins 2.164.1]

本文基於當前最新的 LTS 版本 2.164.1 ，理論上適應於Jenkins 2.x全部版本。

1、下載

前往https://jenkins.io/download/ ，按需下載。如用於生產，建議下載Long-term Support (LTS) 版本，這樣可以得到相對長期的維護；如想體驗最新的功能，可嘗試 Weekly 版本。

能夠直接下載特定系統專屬的版本，也可下載 Generic Java package (.war) 。本文下載的是 Generic Java package (.war) ，這樣對全部系統都通用。

2、安裝

2.1 通用安裝方式

安裝Jenkins很是簡單，只需準備一個Tomcat（筆者使用的是Tomcat 8），而後將下載下來的 jenkins.war 丟到Tomcat的 webapps 目錄中，而後啓動Tomcat便可。本文，Tomcat使用的端口是 18080 。

Tomcat下載與安裝本文不作贅述，請自行百度。

2.2 Docker安裝方式

使用以下命令便可：

docker run -d -v jenkins_home:/var/jenkins_home -p 18080:8080 -p 50000:50000 jenkins/jenkins:lts

2.3 初始化

Jenkins啓動片刻後，訪問 http://localhost:18080/jenkins ，便可看到相似以下的界面：

由界面提示可知，Jenkins設置了一個初始的管理員密碼，該密碼存儲在 /Users/itmuch.com/.jenkins/secrets/initialAdminPassword 文件中——只需可找到該文件，將其內容複製到圖示的輸入框中便可。點擊 繼續 按鈕，將會出現相似以下的界面：

按需選擇便可，建議初學者選擇 安裝推薦的插件 ，由於該選項包含了Jenkins經常使用的一些插件，基本知足平常使用；高手則可選擇 選擇插件來安裝 ，該選項更具靈活性。這裏，筆者以 安裝推薦的插件爲例，點擊後，將會看到相似以下的界面：

待插件安裝完畢後（等待的時間長短視您的網絡而定），將會看到相似以下的界面：

Jenkins要求咱們建立第一個管理員帳戶。填入相關信息，並點擊 保存並完成 按鈕，Jenkins便可初始化完成。

TIPS

安裝完成後，若是訪問 http://localhost:18080/jenkins 變成白板，並且沒有反應，建議重啓Jenkins服務器，並從新訪問嘗試。

3、配置

下面，咱們來配置Jenkins。

3.1 全局工具配置

1. 點擊系統管理 - 全局工具配置 ，以下圖：

2. 將會看到相似以下圖的界面。按需添加JDK、Git、Gradle、Maven、Docker等配置。配置比較簡單，這裏就不贅述了。

3.2 郵件配置

1. 點擊 系統管理 - 系統設置

2. 配置管理員郵件地址：

3. 郵件發送配置：

   須要注意的是：郵件通知所使用的地址必須與管理員郵箱地址一致，不然將沒法正常發送郵件！！

固然，Jenkins還有不少其餘的配置選項，讀者可自行在Jenkins左側的系統管理 自行挖掘。

4、使用案例1：構建項目

1. 在Jenkins首頁，點擊開始建立一個新任務. ，以下圖所示：

2. 建立一個自由風格的項目，以下圖所示：

3. 點擊肯定後，將會看到配置詳情：

   如圖，請設置您想構建的項目的Git倉庫地址、對應的帳號密碼、想要構建的Git分支。通常來講，源碼庫瀏覽器選擇自動便可。

4. Maven配置

   其中Maven版本 中所選擇的 maven ，就是以前在全局工具配置 一節中的Maven配置名稱。

5. 若是想設置定時構建（例如：天天晚上八點構建）：

6. 配置構建完成後操做（以發送郵件爲例）

7. 點擊構建項目，執行構建

5、使用案例2：流水線

Jenkins 2.x 內置了強大的流水線功能。

1. 建立一個 流水線 類型的任務

2. 填寫Pipeline腳本：

   node {
      def mvnHome
      stage('Preparation') { // for display purposes
         // clone源碼
         git 'https://gitee.com/itmuch/spring-cloud-yes.git'
         // 這裏的maven-3.5.0必須跟全局工具配置中設置的Maven名稱一致       
         mvnHome = tool 'maven-3.5.0'
      }
      stage('Build') {
         // Run the maven build
         if (isUnix()) {
            sh "'${mvnHome}/bin/mvn' clean install"
         } else {
            bat(/"${mvnHome}\bin\mvn" clean install/)
         }
      }
      stage('Email') {
         mail bcc: '', body: '構建成功。', cc: '511932633@qq.com', from: 'eacdy0000@126.com', replyTo: '', subject: '構建成功', to: 'eacdy0000@126.com'
      }
   }

   如代碼所示，咱們編寫了一個流水線，該流水線包含三個階段：

   • Preparation：在該階段中，咱們Clone源碼，同時，定義了一個變量叫mvnHome。
   • Build：在該階段中，咱們執行 mvn clean install 命令，其中針對操做系統作了判斷。
   • Email：若是構建成功，就發送郵件到 511932633 @ qq.com 。

3. Pipeline腳本功能很是強大，默認支持數十個指令！你可能擔憂指令學習的成本，但這種擔憂實際上是多餘的——只需點擊下圖中的 流水線語法 按鈕，就能夠傻瓜化地使用Pipeline語法啦！

本文首發

http://www.itmuch.com/work/jenkins-in-action/