转载

Jenkins 筆記 3 - TFS 設定與 MSBuild 安裝

本篇整理 Jenkins 由 TFS 取回程式編譯的一些設定細節。

開始前先要將用來登入 TFS 伺服器的 AD 帳號新增為 Credential，新增位置如下圖：

Kind 為「Username with password」，Scope 有 System 與 Global 兩種選擇，System 限定帳號只供 Jenkins 伺服器自身使用(電子郵件、與其他主機 SSH 連線)，若帳號要提供建置作業使用則需選 Global，ID 欄位請輸入方便識別名稱，若不給系統會隨機命名。

Jenkins 筆記 3 - TFS 設定與 MSBuild 安裝

接著來到設定的 TFS/Team Services 區段，在 Team Project Collections 按下 Add 新增，輸入 TFS URL，選取剛才建立的 Credential，按「Test connection」測試連線無誤後，按「Save」儲存。

Jenkins 筆記 3 - TFS 設定與 MSBuild 安裝

設定完成後，在 Freestyle Project 設定介面的 Source Code Management 我們可以在 Team Foundation Version Control(TFVC) 的 Collection URL 下拉選單看到剛才新增的集合，Credentials 請選 Automatic 以直接引用剛才設定的帳號。

Jenkins 筆記 3 - TFS 設定與 MSBuild 安裝

進階設定有幾個常用選項：

Use update - 每次建置時不要刪除及重建 Workspace 資料夾，靠覆寫更新，建置速度會快一點，但缺點資料夾內可能殘留先前建置留下的廢棄檔案。
Use overwrite - TFS 預設遇到 Workspace 內的檔案被修改過或標為可讀寫時會略過不更新，這個選項可強迫一律用伺服器上的版本覆寫。
Cloaked paths - 列舉略過不要從 TFS 下載的路徑，排除建置過程不需要的檔案，可提升建置速度。

另外，記得在 Global Tool Configuration / MSBuild 區新增 MSBuld Installations。下圖範例為 MSBuild 2017，參考： VS2017 MSBuild 離線安裝

Jenkins 筆記 3 - TFS 設定與 MSBuild 安裝

再來的注意事項跟 TFS Build Service 類似，為了讓 MSBuild 順利編譯各式專案，需要手動安裝所需的 SDK，這裡先列出先前整理過的問題，後面再補上本次新發現：

TFS Build Service筆記
VS2017 MSBuild 離線安裝
NuGet Packages資料夾該不該加入TFS版控？
TypeScript MSBuild編譯失敗
在VS2012/VS2013環境編譯Web Deployment Project

實作過程陸續遇到幾個新問題，一併記錄：

編譯 ASP.NET 專案時遇到以下詭異錯誤，爬文多建議 aspnet_regiis，但我的 Jenkins 主機沒裝 IIS，最後是手動建立 Temporary ASP.NET Files 目錄搞定。

ASPNETCOMPILER : error ASPRUNTIME: The current identity (NT AUTHORITY/SYSTEM) does not have write access to
 'C:/Windows/Microsoft.NET/Framework/v2.0.50727/Temporary ASP.NET Files'.

建置 ASP.NET 3.5 wdproj 出錯，安裝 MSBuild 2017 Microsoft.Net.Component.3.5.DeveloperTools 解決。

(AspNetMerge target) -> 
  C:/Program Files (x86)/MSBuild/Microsoft/WebDeployment/v10.0/Microsoft.WebDeployment.targets(1589,9): 
  error MSB6004: The specified task executable location 
  "C:/Program Files (x86)/MSBuild/Microsoft/WebDeployment/v10.0/aspnet_merge.exe" is invalid.

原本在 Jenkins 主機上也裝了 MSBuild 2015，部分 wdproj 選用其編譯，但遇到一些錯誤：
error MSB4019: The imported project "C:/Program Files (x86)/MSBuild/Microsoft/VisualStudio/v14.0/WebApplications/Microsoft.WebApplication.targets" was not found. Confirm that the path in the <Import> declaration is correct, and that the file exists on disk. 、
C:/Program Files (x86)/MSBuild/14.0/bin/Microsoft.Common.CurrentVersion.targets(3266,5): error MSB3086: Task could not find "AL.exe" using the SdkToolsPath "" or the registry key "HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Microsoft SDKs/NETFXSDK/4.6/WinSDK-NetFx40Tools-x86". Make sure the SdkToolsPath is set and th e tool exists in the correct processor specific location under the SdkToolsPath and that the Microsoft Windows SDK is installed
分析為套件沒裝齊，甚至需另裝 Windows 10 SDK，步驟偏繁瑣，最後我棄用 MSBuild 2015，統一用 MSBuild 2017 後就沒問題了。
部分專案用到RDLC 報表，編譯時冒出 error ASPCONFIG: Could not load file or assembly 'Microsoft.ReportViewer.WebForms, Version=10.0.0.0, Culture=neutra l, PublicKeyToken=b03f5f7f11d50a3a' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040) 錯誤，需視版本需安裝報表元件：

Microsoft Report Viewer 2010 Redistributable Package (v10.0)
MICROSOFT® REPORT VIEWER 2012 RUNTIME (v11.0) (需先安裝 SQL Server 2012 SP1 Feature Pack SQLSysClrTypes.msi)
MICROSOFT® REPORT VIEWER 2015 RUNTIME (v12.0) (需先安裝 SQL 2014 SP1 Feature Pack )

Tips of TFS connection setup in Jenkins and some hint of MSBuild and related SDK installation.

原文 https://blog.darkthread.net/blog/jenkins-notes-3/

正文到此结束