一、下載安裝Jenkins  : 

官網地址 https://jenkins.io/index.html   安裝沒什麼特殊的 常規安裝即可。安裝後預設佔用8080埠。可通過瀏覽器訪問。

二、配置：

首次訪問，會提示安裝外掛，如果安裝Jenkins的伺服器可以聯網，選擇需要的安裝即可。但如果不能聯網，這裡不能選擇任何外掛安裝，否則會報錯（後面會自己下載外掛包通過上傳的方式進行安裝）。

然後就是註冊一個管理員賬號 即可登入進行配置了。

        離線安裝外掛：

外掛下載地址：http://updates.jenkins-ci.org/download/plugins/

               下載好對應的外掛（一般最新版就行,注意外掛的依賴關係，要下載整個依賴樹的所有下游外掛並從下往上安裝，否則會出錯，也可以根據出錯提示依次下載缺少的外掛）。

系統管理-->管理外掛-->高階-->上傳外掛-->選擇檔案-->選擇剛才下載的安裝包（一次只能選擇一個，一般為hpi格式），然後會自動進行安裝。如果安裝失敗，一般是由於缺少依賴外掛引起的  這時候點選檢視詳情 ，先安裝缺少的依賴外掛即可。

對於我們的部署.net專案 ，用到的主要外掛有 MSBuild （編譯.net專案），GitLab(從原始碼管理器上獲取程式碼並編譯)，Publish Over FTP或FTP publisher（通過FTP把生成的專案檔案傳送到目標伺服器，但是需要目標伺服器的FTP支援，後面實際沒有采用這種方式），PowerShell(停止\開啟遠端伺服器服務、網站、拷貝檔案等用途)，   Copy Artifact Plugin(把其他Job工作區的檔案拷貝到當前Job)。 除此之外  還有許多下游依賴外掛 如git 等  就不一一列出。

三、部分外掛的全域性設定：

        系統管理-->系統設定 中 

這個外掛是用FTP向遠端伺服器拷貝檔案/資料夾用的 （需要遠端伺服器開啟FTP服務），由於我後來使用的PowerShell 方式，所以這個方式暫時沒有用到，後期備用吧。

 四、專案配置：

其中 Credentials 是要用 SSH Username with private key 方式配置的，把本機的PRIVATE KEY填上即可 【其他方式暫時連不上，待研究】

配置GitLab Hook ：

 通過GitLab Hook  鉤子  可以實現  有程式碼push到指定分支自動執行JOB的目的。

 需要安裝Jenkins的外掛有 

安裝好後   需要分別在gitlab 和jenkins 上做相應的配置   

jenkins 觸發器中選擇gitlab hook    能看到回撥URL , 高階選項 生成 Token。     然後去gitlab 分別把 回撥URL 和Token 填入 webhooks設定介面  。

新增 然後測試 ，如果顯示藍色200  則配置成功！  具體步驟見下圖 

這裡沒什麼可說的 具體編譯的細節 引數都寫在 solution.msbuild 檔案裡了 ，注意這個檔案也要上傳到git 。 這檔案裡主要做了三件事

   刪除原生成目錄

   建立新生成目錄

   編譯生成專案 

   當然這個過程中的涉及的這些目錄 都是放在工作空間目錄中的。工作空間可以在這裡找到： Jenkins\workspace\JobName  （Jenkins目錄 在全域性設定裡面可以設定）

----------------------------------20170703補充  msbuild 不呼叫指令碼，直接寫引數----------------------------------

msbuild 可以直接呼叫sln以及csproj檔案。所以如果是釋出web專案的時候，可以msbuild 後面直接跟要釋出web專案的csproj檔案。

如msbuild  Web.csproj   

關於後面的引數  例如：

/t:ResolveReferences;Compile
 /t:_CopyWebApplication 
 /p:Configuration=Release 
/p:WebProjectOutputDir=C:/Software/Jenkins/workspace/MESWebService/Publish
 /p:OutputPath=C:/Software/Jenkins/workspace/MESWebService/Publish/bin

這是釋出Web專案的 一般引數形式 把最後兩行  釋出地址換了即可

----------------------------------------------------------------------------------------------------------------------------------

    這步操作 是把生成的專案目錄存檔，以便下游Job呼叫。這裡用到了 Copy Artifact  外掛。

下面就是第二個Job了  :

  這兩個地方 是和上一個Job銜接的 當上一個JOB執行成功自動觸發，把生成成功的釋出目錄拷貝到當前工作空間

此處是另一個關鍵，利用PowerShell  先停止遠端網站， 把檔案覆蓋過去，再啟動網站，最後別忘了釋放登入Session .

*****************20170628補充 釋出專案前自動備份************************************************************************

思路是使用PowerShell指令碼  把當前的專案資料夾 整個拷貝到備份資料夾中 ，並以當前日期時間命名。

上圖中的Powershell命令做如下修改：

 Invoke-Command -Session $session -ScriptBlock{
 c:\windows\System32\inetsrv\appcmd stop site "WebService"
 E:\WebServiceBackUp\BackUpDir.ps1     #停掉網站後  執行備份指令碼（備份指令碼已寫好  放置在網站部署伺服器上）
}

備份指令碼內容如下：

#源目錄
$pathFrom = "E:\WebService";  
#目標目錄
$pathTo = "E:\WebServiceBackUp\bak"+(Get-Date -Format 'yyyyMMddHHmmss');   
write-host("SourcePath is: " + $pathFrom);  
write-host("TargetPath is: " + $pathTo);  
#建立目標目錄 
mkdir -Pa $pathTo;   
if (!(Test-path -path $pathFrom)){  
  write-host("SourcePath is not exist!");  
  exit -1;  
}  
  
$pathCopyTo = "";  
$pathFromLen = $pathFrom.Length;  
$LenGap = 0;  
$LenGap2 = 0;  
  
ls -r $pathFrom  | Foreach-Object{  
    $lenGap = $_.FullName.Length - $pathFromLen - $_.Name.Length - 1;  
    $pathCopyTo =  $PathTo + $_.FullName.Substring($pathFromLen, $lenGap);  
  
    write-host("Copy " + $_.FullName + " to " + $pathCopyTo);  
    if(!(Test-path -path $pathCopyTo)){ 
        mkdir -Pa $pathCopyTo;  
    }  
    copy-item $_.FullName $pathCopyTo -Force;  
}  
exit 0;  

使用的時候 只需要根據實際情況把源目錄和目標目錄修改了就好（也可以寫成引數的形式在呼叫指令碼的時候傳進目錄）

注：部署專案的伺服器 初次執行ps1指令碼的時候 出現“無法載入檔案 ******.ps1，因為在此係統中禁止執行指令碼” 的錯誤 ，原因是預設設定是禁止執行

指令碼的，需要手動開啟 ，方法是在PowerShell  中 輸入命令  set-executionpolicy remotesigned  然後再按提示輸入Y 即可

********************************************20170629補充   一鍵還原到最近備份版本*************************************************************************

根據上一步操作 ，在釋出新版本前，已經把專案都備份好了 。下面的思路依然是利用Jenkins新建一個Job去直接呼叫伺服器上寫好的powershell指令碼。

 Jenkins配置：

$pass=ConvertTo-SecureString -String '密碼' -AsPlainText -Force
$cre=New-Object System.Management.Automation.PSCredential('使用者名稱', $pass)
$session=New-PSSession -ComputerName 伺服器IP -Credential $cre

 Invoke-Command -Session $session -ScriptBlock{
 c:\windows\System32\inetsrv\appcmd stop site "網站名"
 E:\WebServiceBackUp\RevertVersion.ps1  #要執行的關鍵指令碼
 c:\windows\System32\inetsrv\appcmd start site "網站名"
}
Remove-PSSession -Id $session.Id

$pathFrom = "E:\WebServiceBackUp";  
$pathTo = "E:\WebService";  
#獲取最新的備份檔案目錄
$pathFrom= $pathFrom+"\"+(ls  "e:\WebServiceBackUp\" |?{$_.Mode -eq "d----"}|sort -Descending LastWriteTime)[0].Name; #通用
#$pathFrom= $pathFrom+"\"+(ls -dir -r $pathFrom | sort -Descending LastWriteTime)[0].Name;  #僅ps5支援 伺服器上版本太低。。
write-host("Source:"+$pathFrom);
write-host("To"+$pathTo);
#清空專案資料夾
Remove-Item ($pathTo+"\*") -recurse
write-host("Clear Finish!");
#拷貝檔案
$pathCopyTo = "";  
$pathFromLen = $pathFrom.Length;  
$LenGap = 0;  
 ls -r $pathfrom  | foreach-object{  
 $lengap = $_.fullname.length - $pathfromlen - $_.name.length - 1;  
 $pathcopyto =  $pathto + $_.fullname.substring($pathfromlen, $lengap); 
 if(!(test-path -path $pathcopyto)){ 
     mkdir -pa $pathcopyto;  
 }  
 copy-item $_.fullname $pathcopyto -force;  
 }  
 write-host("Revert Finish!");
 exit 0; 

名字降序排列也能取出最近的資料夾名字。

*******************************************************************************************************************************************************************

至此 ，任務的配置基本完成。執行的時候 只需開啟第一個Job  點選立即構建，即可自動完成專案從GitLab上拉取指定分支的最新程式碼，編譯釋出，停網站，

拷貝覆蓋檔案，啟動網站等一系列動作，當然 ，後期如有需要 ，可以設定輪詢方式，在指定時間自動釋出專案，或者使用Hook 鉤子方式，當有程式碼提交自動

釋出專案。

  下面說一下.net專案的編譯環境、MSBuild環境配置、PowerShell的設定等檔案：

    MSBuild  命令的使用，要配置環境變數，把.net framework 的目錄（如C:\Windows\Microsoft.NET\Framework\v4.0.30319）寫進Path環境變數中。

    編譯要有環境，而一般伺服器是沒有開發環境的，這時候一般有兩個選擇，安裝Visual Studio （2012以上，建議這種後期麻煩可能會少一點），要不就

安裝 Windows SDK ，這裡面有編譯所依賴的東西。這時候 可以嘗試編譯了 ，一般測試編譯環境的時候在本地直接用msbuild 命令即可，不用上Jenkins.

這時候，可能會提示缺少各種檔案，根據錯誤提示，從開發機上拷貝過去即可，注意，上傳gitlab時  packages包，各種引用dll也要上傳，不然後面拉取程式碼到工作區編譯的時候

會少這些檔案.。

注意，編譯時候，報錯可能會跟C:\Program Files (x86)\MSBuild 目錄中的檔案有關，這時候根據提示，把相應的目錄從開發機拷貝過去，實在不行 把出錯目錄

刪除會有奇效，它會尋求其他目錄，其他目錄環境也許是完好的。

      我操作的環境是Windows Server 2008 R2   ，但是PowerShell的向遠端伺服器拷貝檔案的命令只能PowerShell5才支援，PowerShell5是

windows management framework5的一部分，WMF5又依賴於 Windows Server 2008 R2 SP1 和.net framework4.5，所以  都要安裝上。

都裝好後  開啟PowerShell   $PSVersionTable.PSVersion命令檢視版本  確認是不是5.

  使用PowerShell連線遠端機器 需要先新增信任列表 命令 

winrm set winrm/config/client  '@{TrustedHosts="xxx.xxx.xxx.xxx,xxx.xxx.xxx.xxx"}'

(注意是設定TrustedHosts不是新增，可以設定多個TrustedHosts，用逗號分開)好像是客戶端（源伺服器）用設定 服務端（目標伺服器）不用

  然後初始化配置 winrm quickconfig 根據提示 輸入一到兩次'yes' 即可。

[檢視已配置的TrustedHosts:Get-Item WSMan:\localhost\Client\TrustedHosts | Select-Object Value]

 最後 貼下 solution.msbuild檔案 【其實不用這個檔案 ，直接 編譯csproj 或sln檔案後面加引數也可以，只是這個檔案中增加了刪除\新建目錄等其他功能】

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003"   DefaultTargets="Compile">
<ItemGroup>
 <BuildArtifactsDir Include="BuildArtifacts\" />
  <SolutionFile Include="trunk\MKCurtain.sln" /> 
</ItemGroup>

<PropertyGroup>
 <Configuration Condition=" '$(Configuration)' == '' ">Release</Configuration>
 <BuildPlatform Condition=" '$(BuildPlatform)' == '' ">Any CPU</BuildPlatform>
</PropertyGroup>

<Target Name="Compile" DependsOnTargets="Init">
 <MSBuild Projects="@(SolutionFile)" Targets="Rebuild"
          Properties="OutDir=%(BuildArtifactsDir.FullPath);Configuration=$(Configuration);Platform=$(BuildPlatform)" />
</Target>

<Target Name="Init"  DependsOnTargets="Clean">
 <MakeDir Directories="@(BuildArtifactsDir)" />
</Target>

<Target Name="Clean">
 <RemoveDir Directories="@(BuildArtifactsDir)" />
</Target>

</Project>

 參考文件：http://blog.csdn.net/dj0379/article/details/52389454

                     http://blog.csdn.net/wangmuming/article/details/22925671

                     http://www.cnblogs.com/scheshan/p/5849704.html

https://www.cnblogs.com/v5captain/articles/6480708.html  備份恢復