【Jenkins】外掛套件:MSBuild

  在 Jenkins 中使用 MSBuild 進行建置。

1、環境配置

  專案使用 Visual Studio 進行開發,需要使用 MSBuild 進行建置,選擇安裝「MSBuild」與「Visual Studio」其中一種。

1.1 MSBuild

  在 Jenkins 伺服器主機上安裝符合開發環境的 MSBuild。

1.2 Visual Studio

  在 Jenkins 伺服器主機上安裝符合開發環境的 Visual Studio。

2、Jenkins 套件管理

  由 Jenkins 主畫面依序點選「管理 Jenkins」 → 「管理外掛程式」,進入「Jenkins 套件」管理頁面。

01:Jenkins_Plugin_Manager

2.1 安裝 MSBuild plugin

  點選「可用的」頁籤,輸入過濾條件「MSBuild」,選取【MSBuild】並按下【下載並於重新啟動後安裝】。

套件安裝有【直接安裝】與【下載並於重新啟動後安裝】兩種選擇。【下載並於重新啟動後安裝】是比較安全的做法,可避免工作正在執行時套件被更新而造成錯誤。

02:Filter_MSBuild_Plugin

  套件安裝過程中會將相依套件一併載入安裝,安裝完成後顯示「下載成功。下次啟動後就會生效。」。

  當套件與相依套件全部下載完成後,按下【當安裝完成且沒有工作正在執行時,重啟 Jenkins】重新啟動 Jenkins。

03:MSBuild_Plugin_Install

3、Jenkins 工具組態設定

  由 Jenkins 主畫面依序點選「管理 Jenkins」 → 「Global Tool Configuration」,進入「Jenkins 工具組態」設定頁面。

04:Jenkins_Global_Tool_Configuration

3.1 設定 MSBuild plugin

  頁面中有標示為 MSBuild 的區塊(安裝 MSBuild plugin 產生的區塊),按下【新增 MSBuild】,輸入「Name」與「Path to MSBuild」。

  • Visual Studio MSBuild 預設路徑
    • 2015(x86):C:\Program Files (x86)\MSBuild\14.0\Bin\MSBuild.exe
    • 2015(x64):C:\Program Files (x86)\MSBuild\14.0\Bin\amd64\MSBuild.exe
    • 2017(x86):C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\MSBuild.exe
    • 2017(x64):C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\amd64\MSBuild.exe

05:MSBuild_Plugin_Setting

4、工作組態設定

  由 Jenkins 主畫面依序點選「Lab.Jenkins_VisualStudio」(前面新增的工作名稱) → 「組態」,進入「工作組態」設定頁面。

4.1 建置

  點選「建置」頁籤,按下【新增建置步驟】 → 【Build a Visual Studio project or solution using MSBuild】(安裝 MSBuild plugin 產生的選項),選擇「MSBuild Version」,輸入「MSBuild Build File」,按下【儲存】儲存工作組態設定。

  • MSBuild Version:在【3.1 設定 MSBuild plugin】中設定。
  • MSBuild Build File:可輸入專案或方案路徑,路徑可以是相對路徑(相對於工作區域)或是絕對路徑。

06:Job_Configure_Setting_MSBuild

4.2 工作建置

  按下【馬上建置】,此時此項工作會使用 MSBuild VersionMSBuild Build File 進行建置

  • MSBuild Version:在【3.1 設定 MSBuild plugin】中設定,在【4.1 建置】中選擇。
  • MSBuild Build File:在【4.1 建置】中設定。

07:Job_Build

  在建置歷程的建置結果列表中,點選建置結果可以查看更詳細的建置紀錄。

  點選「Console Output」,進入「終端機輸出」頁面,可以看到此次此項工作使用 MSBuild Version 對 MSBuild Build File 進行建置。

08:Job_Console_Output

嘗試將自己的理解寫成文字紀錄,資料來源均來自於網路。

如有理解錯誤、引用錯誤或侵權,請多加指正與告知,讓我有更多的進步與改進的空間,謝謝!