使用升級範本定義組建

發行項
08/12/2011

您可以使用「升級範本」繼續在 Visual Studio Team Foundation Server 2010 中使用舊版組建定義。具體來說，您可以使用這個範本來執行下列類型的組建物件：

使用 Visual Studio Team System 2008 Team Foundation Server 建立的組建定義。
使用 Visual Studio 2005 Team Foundation Server 建立的組建類型。

當您第一次升級至 Team Foundation Server 2010 時，系統會針對系統中的每個舊版組建定義和每個組建類型，自動建立「升級範本」組建定義。

另外，當您使用舊版 Visual Studio ALM 在執行 Team Foundation Server 2010 的伺服器上建立組建定義或組建類型時，系統也會自動建立「升級範本」組建定義。

若要修改這些舊版組建物件，您多半必須修改 TFSBuild.proj 檔。如需詳細資訊，請參閱 Team Foundation Build 目標、工作和屬性。但是您也可以開啟 Team 總管中的組建節點，來變更組建定義物件中的某些設定。本主題將說明這些設定。

必要的使用權限

若要執行這個程序，您的 [編輯組建定義] 權限必須已設定為 [允許]。如需詳細資訊，請參閱 Team Foundation Server 使用權限。

若要修改升級範本組建定義

在 Team 總管中，展開要在其中定義組建的 Team 專案，然後展開 [組建] 節點。
以滑鼠右鍵按一下您要修改的組建定義，然後按一下 [編輯組建定義]。
在 [組建預設值] 索引標籤上，開啟 [組建控制器] 功能表，然後選取任一組建控制器。
按一下 [流程] 索引標籤。
確定 [升級範本] 出現在建置流程範本底下。
展開 [必要項] 節點。
在 [組態資料夾路徑] 中，確定已正確指定 TFSBuild.proj 檔所在的資料夾路徑。
使用本主題稍後的資訊，來完成提供功能的欄位，這些功能是您要放入此組建定義的功能。
當您完成 [流程] 索引標籤上的欄位後，視需要修改 [觸發程序]、[工作區]、[組建預設值] 和 [保留原則] 索引標籤中的欄位。

如需詳細資訊，請參閱建立基本組建定義。

本主題內容

關於升級範本建置流程參數
指定記錄詳細資訊
指定處理組建的組建代理程式
指定組建代理程式時間限制
指定進階建置流程參數

關於升級範本建置流程參數

本主題說明如何針對以「升級範本」為基礎的組建，使用建置流程參數來修改組建。只要下列條件成立，這項資訊即應適用於 Visual Studio Application Lifecycle Management (ALM)：

您在使用以 Visual Studio ALM 隨附之兩個流程範本的其中一個 (MSF for Agile Software Development v5.0 或 MSF for CMMI Process Improvement v5.0) 所建立的 Team 專案。
您的小組中沒有人已移除或自訂「升級範本」。

指定記錄詳細資訊

若要指定在建置結果視窗中顯示之記錄的詳細資訊，請展開 [基本] 節點，然後選取 [記錄詳細資訊] 清單中的值。下表列出 [記錄詳細資訊] 的值和其對應效果。

值	建置錯誤	建置警告	高重要性建置訊息	一般重要性組建訊息	低重要性組建訊息	工作流程活動屬性 (輸入和輸出)
最小	Y	N	N	N	N	N
一般	Y	Y	Y	N	N	N
詳細	Y	Y	Y	Y	N	N
診斷	Y	Y	Y	Y	Y	Y

您指定的記錄詳細資訊值也會影響來自 MSBuild 的訊息的詳細資訊。如需詳細資訊，請參閱 MSBuild 命令列參考。

如需組建報告的詳細資訊，請參閱檢視建置結果視窗。

指定處理組建的組建代理程式

若要指定用來處理組建的組建代理程式，請依序展開 [進階] 節點、[代理程式設定] 節點，然後填入下列其中一個方塊：

名稱篩選：您可以篩選用來處理此組建定義的組建代理程式，方法是在此欄位中輸入代理程式的名稱。您也可以使用 * 和 ? 萬用字元指定一組名稱。例如，您可以指定 CI* 以指定名稱以字元 CI 開頭的任何代理程式。符合此準則的代理程式包括 CI、CI1 或 CI_Agent2。

標記篩選：指定一個或多個標記，以確保只有具備相符標記的組建代理程式會執行此組建。例如，您在組建電腦上設定一個專為處理您的閘道簽入組建所設計的組建代理程式。您將閘道標記套用至此組建代理程式。最後，您將閘道標記套用至組建定義，使其只能由也以閘道標記加註的代理程式處理。若要指定標記，請按一下省略符號按鈕 (...)。

注意事項
可用於處理此組建的組建代理程式集，是由您指定給此組建定義的組建控制器所決定。若要修改組建控制器，請按一下 [組建預設值] 索引標籤，然後開啟 [組建控制器] 功能表，再從該功能表中選取組建控制器。

指定組建代理程式時間限制

若要指定時間限制，請依序展開 [進階] 節點、[代理程式設定] 節點，然後指定下列參數。

如果想要...	然後設定此參數…	依照下列指引…
指定允許組建代理程式處理組建的最大時間	最長執行時間	以 hh:mm:ss 格式輸入時間範圍值。例如，如果您指定的值為 04:30:15，而組建代理程式在 4 小時 30 分 15 秒後未完成其工作，則建置將會失敗且具有逾時錯誤。如果您要提供組建代理程式無限制的時間來處理組建，請指定值 00:00:00。
指定將組建要求指派至組建代理程式所允許的最大時間	最長等待時間	以 hh:mm:ss 格式輸入時間範圍值。例如，如果您指定的值為 01:30:45，而組建在 1 小時 30 分 45 秒後仍未指派組建代理程式，則建置將會失敗且具有逾時錯誤。如果您要提供組建控制器無限制的時間來尋找用以處理此組建定義的組建代理程式，請指定值 00:00:00。

指定進階建置流程參數

若要成功完成某些較不常見的案例，您必須修改 [進階] 節點中的建置流程參數。

如果想要...	然後設定此參數…	依照下列指引…
指定用於存放所建置之二進位檔的子目錄	二進位檔子目錄	如果您未指定子目錄，系統會使用名稱為 Binaries 的子目錄。
使用本機電腦上現有的組建類型定義	不要下載組建類型	如果您想要使用已經存在於本機電腦上的組建類型定義，而不要從 Team Foundation Server 下載定義，請將此旗標設定為 True。所使用的本機路徑就是此組建類型的本機工作區 (Workspace)。此參數通常會暫時設為 True，讓您可以偵錯 TFSBuild.proj 檔。
針對個別專案產生錯誤和警告記錄檔	每個專案各一個記錄檔	將這個值設定為 True 可針對個別專案 (而非個別的平台和組態組合) 產生錯誤和警告記錄檔。
指定要傳遞至 MSBuild 的命令列引數	MSBuild 引數	如果建置流程需要您將引數傳遞至 MSBuild，請在 [MSBuild 引數] 參數中輸入這些引數。如需詳細資訊，請參閱 MSBuild 命令列參考。
指定用來處理組建的 MSBuild 版本的 Bitness	MSBuild 平台	指定下列其中一個值：如果您想要以與組建代理程式上安裝的 Team Foundation Build Service 相同的 CPU Bitness 來執行 MSBuild，請指定 [自動]。指定 [X86] 會一律以 32 位元版本的 MSBuild 處理此組建。由於 Visual Studio 2010 是做為 32 位元的應用程式執行，因此當執行 64 位元版本 Team Foundation Build Service 的組建代理程式處理您的組建時，可能會發生問題。指定 [X86] 應該可以解決這類的問題。指定 [X64] 會一律以 64 位元版本的 MSBuild 處理此組建。注意事項如果指定此值，則應該要確定 (例如使用本主題稍早說明的標記) 組建會由 64 位元組建電腦上裝載的組建代理程式處理。否則將無法進行建置。
讓 MSBuild 以遞迴的方式取得和使用 [組態資料夾路徑] 中的檔案	遞迴類型	指定下列其中一個值：一層：如果 [組態資料夾路徑] 中指定的資料夾包含 MSBuild 要處理的檔案。完整：如果 [組態資料夾路徑] 中指定的資料夾或該資料夾的子目錄包含 MSBuild 要處理的檔案。
指定用來對應工作區和組建的子目錄	來源子目錄	針對使用這部組建電腦的組建代理程式，將這個值設定為適當的來源子目錄。如果您未指定子目錄，系統會使用名稱為 Sources 的子目錄。
指定用於儲存測試結果的子目錄	測試結果子目錄	針對使用這部組建電腦的組建代理程式，將這個值設定為適當的測試結果子目錄。如果您未指定子目錄，系統會使用名稱為 TestResults 的子目錄。

共用方式為