Jenkins是什麼

Jenkins是一個可擴充套件的持續整合的引擎，主要用於持續自動的構建、測試軟體專案監控一些定時執行的任務。

安裝配置

我的環境：

機器：Windows Server 2008 R2 Enterprice

開發環境：VS2017

原始碼管理：Git

軟體安裝

1、Jenkins

最新的Jenkins 安裝包可以從這裡下載：http://jenkins-ci.org/

安裝完成後我們可以看到在windows服務中多了一個叫Jenkins的服務。

安裝目錄：C:\Program Files (x86)\Jenkins

介面：http://localhost:8080/

2、.NET Framework 4.6.1   

https://www.microsoft.com/zh-cn/download/details.aspx?id=49982

3、Microsoft Build Tools 2015   

https://www.microsoft.com/zh-CN/download/details.aspx?id=48159

我機器安裝vs2017是已經包含了msbuild（C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\MSBuild.exe），所有也可以不用下載。

MSBuild功能是“對.NET專案的原始碼進行編譯”，雖然平時我們使用 Visual Studio 都是圖形介面編譯、釋出程式，但實際上 Visual Studio 是去呼叫 MSBuild 來進行各種操作的，所以我們要想讓 Jenkins 也能自動編譯程式碼，也要為它準備一套 MSBuild。

4、.NET Framework 4.6.1 Developer Pack   

https://www.microsoft.com/zh-CN/download/details.aspx?id=49978

5、NuGet x86 Commandline        

 https://dist.nuget.org/index.html

NuGet 的控制檯程式，在編譯程式之前，先需要使用 NuGet 進行包還原。這個軟體不需要安裝，放在一個固定的位置就行，例如F:\Software\nuget.exe 。

Jenkins->簡單操作

開啟控制檯/命令列 - >轉到Jenkins安裝目錄。分別執行以下命令：
停止：jenkins.exe stop

開始：jenkins.exe start

重新啟動：jenkins.exe restart

登入介面使用者名稱密碼

如果不記得密碼了，可以配置為不使用密碼，如下：

修改安裝目錄下的config.xml檔案的節點  <useSecurity>false</useSecurity>

而密碼儲存在檔案：credentials.xml

jenkins->安裝外掛

Git外掛獲取原始碼，MSBuild外掛編譯.net專案。 

http://localhost:8080/ 中Manager Jenkins => Manage Plugins

在Available選項卡中，選中git Plugin安裝。

在Available選項卡中，選中MSBuild安裝。

jenkins->全域性工具配置/系統設定

http://localhost:8080/configureTools/

其中 MSBuild Name 可以隨便。

Path to MSBuild 就是我們MSBuild在當前電腦的路徑：C:\Program Files (x86)\MSBuild\14.0\Bin\MSBuild.exe

對應：VisualStudioVersion=11.0

注：實踐證明，這裡應該要根據使用的開發環境VisualStudio版本來決定。

eg：使用VS2017編寫的程式，這裡應該填寫 C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\MSBuild.exe

對應：VisualStudioVersion=15.0

 建任務

回到主介面，然後點選 New Job, 輸入任務名稱，推薦用英文，我們選擇構建一個自由風格的軟體專案。

專案名稱：FirstSite

則從git上下載的程式碼放置在jenkins伺服器的 d:\Jenkins\workspace\FirstSite目錄【即工作目錄 Workspace】下。（注：不一定是d盤，是jenkins 的安裝目錄）       

原始碼管理

原始碼管理選擇git，配置我們的原始碼的路徑和使用者名稱密碼

 MSBuil編譯（介紹）

有好多種命令方式，主要介紹“windows批處理命令“和”Build a Visual Studio project or solution using MSBuild “

      Execute Windows batch command（執行windows批處理命令）

命令舉例：cd %WORKSPACE%\DEV\    npm install

其中 WORKSPACE解釋：The absolute path of the directory assigned to the build as a workspace.（分配給構建的目錄的絕對路徑作為工作區） 即git檔案down下來的路徑(d:\Jenkins\workspace\FirstSite)。

點選輸入框下方的“可用環境變數”   在Execute shell 或 Execute Windows batch command文字框中使用，使用方法：%變數名%

   Build a Visual Studio project or solution using MSBuild 

MSBuild Build File：解決方案的相對路徑。【專案檔案或者工程檔案的名稱】

.\angularDemo\angularDemo.csproj

注：指定編譯檔案時，可以指定解決方案(.sln)也可以指定為專案檔案(.csproj)，這樣就只針對某個模組進行編譯。

Command Line Arguments：MSBuild 的命令列引數

MSBuild.exe 用指定的選項生成指定的專案或解決方案檔案。

方式一：根據vs專案釋出配置檔案來編譯釋出

【可以分本地釋出和遠端WebDePloy釋出，依據在vs中的釋出方式而定】

/t:Rebuild

/p:Configuration=Release

/p:DeployOnBuild=True;PublishProfile=Testing-Environment-CI-publish 

使用 Testing-Environment-CI-publish.pubxml 釋出檔案來發布專案

 注：/t是/target的縮寫，/p是/property的縮寫，多個屬性間用分號或逗號分隔，最後不需要分號或逗號。

MSBuild 命令列參考

方式二：直接使用MSBuild命令來編譯釋出

參考：

/p: DeployOnBuild=true;

ExcludeGeneratedDebugSymbol=false;

ExcludeXmlAssemblyFiles=false;

SkipExtraFilesOnServer=True;

WarningLevel=4;

NoWarn=1591;

DeployTarget=MSDeployPublish;

MSDeployPublishMethod=WMSVC;

AllowUntrustedCertificate=True;

MsDeployServiceUrl=https://172.xx.yy.zz:8172/msdeploy.axd;

username=WDeployAdmin;

password=yyyyyy;

DeployIisAppPath=offline.dev.wingontravel.com/ferry;

Configuration=Dev

解釋：

DeployOnBuild=true 表示啟用編譯併發布

Configuration=Release 表示編譯Release版本

TargetFrameworkVersion=v4.5表示編譯的目標是.NET

PublishProfile指定建立的Profile名稱（不用寫目錄，僅檔名即可，而且不用副檔名)  程式編譯成功後就是釋出到我們PublishProfile指定的資料夾中

VisualStudioVersion=11.0 表示VS2012

MsDeployServiceUrl  指定釋出伺服器連線的URL（在IIS站點右鍵啟用Web Deploy釋出來設定的）

DeployIisAppPath  要釋出的位置。Eg:  Test/FirstSite 對應的在iis中是

Username 使用者名稱。此處的使用者名稱和密碼，來自站點的IIS裡面設定的windows使用者。

設定密碼

VS中站點發布

在VS中右擊專案，釋出

1、釋出方法：選 檔案系統

目標位置：E:\IIS_Deploy\FirstSite

PublishProfile=CustomProfile1，點發佈會在目標位置生成相應的檔案，在iis中配置後即可訪問網站。

設定繫結800埠，

訪問：http://localhost:800/FirstSite/Practice/pages/#/

2、若釋出方法選 Web Deploy，則是

伺服器不寫localhost而是寫ip就會要求填寫使用者名稱和密碼。

這些配置在下一篇文章，IIS中“遠端釋出配置和WebDeploy安裝配置”中會提到。

 MSBuil編譯構建（實際配置）

1、nuget包還原

我們在把專案提交到git或者svn上的時候並不包含這些包，我們把專案從git上拉到下來後用vs開啟，vs會首先來還原這些nuget包，同樣，如果我們是使用msbuild.exe來構建這些專案，也需要首先還原nuget包，否則專案由於缺少依賴而無法正常編譯，下面我們就介紹如何使用nuget.exe來還原專案依賴。

在jenkins的專案，配置中，build節中 增加一個bat處理命令：

"F:\Software\nuget.exe" restore "%WORKSPACE%\angularDemo.sln"

指定 nuget.exe 的路徑，然後使用 restore 命令，對當前目錄下的 xx.sln 解決方案【不要用專案csproj】檔案進行包還原。

注：bat命令 必須要在Build命令之前。點中拖動，可調換順序。

2、Build配置——釋出到本地

根據前面VS中釋出專案，生成的CustomProfile1 來配置

1、MSBuild Build File：配置為

.\angularDemo\angularDemo.csproj

或者C:\Program Files (x86)\Jenkins\workspace\FirstSite\angularDemo.sln 都可以。

2、Build的命令列引數：

/t:rebuild

/p:DeployOnBuild=true;Configuration=Release;VisualStudioVersion=15.0; PublishProfile=CustomProfile1

構建之後，站點會發布到CustomProfile1中設定的publishUrl的物理路徑下。

常見的構建問題報錯，參考：

其他參考：使用jenkins配置.net mvc網站進行持續整合一