部署和設定組建控制器

若要使用 Team Foundation Build，您的小組必須至少有一個組建控制器執行輕量型工作，並將建置流程的處理器密集工作分配至其組建代理程式集區。

提示
如果您的 Team 專案集合是裝載在 Team Foundation Service 上，您或許可以使用裝載的組建控制器，而不部署您自己的建置系統。

每個組建控制器都專屬於單一的 Team 專案集合。組建控制器會執行一些輕量型工作，例如判斷組建的名稱、建立版本控制中的標籤、記錄附註與報告組建的狀態。組建控制器會使用 AgentScope 活動，將密集使用處理器的工作 (例如編譯程式碼或執行測試) 委派給集區中的組建代理程式。這些組建代理程式可以裝載在相同的組建伺服器，或是在不同的組建伺服器上。

因為組建控制器通常不需要大量處理器時間，您可以在許多情況下將其裝載於 Team Foundation Server 所在的相同電腦 (如上所示) 或低耗電的實體或虛擬機器。

不過，組建控制器可能會在某些情況下需要大量的記憶體，因此您應該視需要提供足夠的記憶體以確保其正常運作。或者，依小組的需求和資源而定，您可能會想要在 Team Foundation Server 以外的電腦上執行組建控制器。

必要的使用權限

您必須是組建伺服器上的 Windows Administrators 群組成員，而且是 Team 專案集合上的 Project Collection Build Administrators 群組成員。請參閱 Team Foundation Server 使用權限。

您想要怎麼做？

• 建立或修改組建控制器

• 讓您的建置流程利用補充二進位檔

• 指定同時執行的最大組建數目

• 移除組建控制器

• 在 Team Foundation Service 裝載的 Team 專案集合中使用裝載的組建控制器。

建立或修改組建控制器

若要從組建伺服器建立或修改組建控制器

1. 登入組建伺服器。

2. 從 Windows 的 [開始]，執行 [Team Foundation 管理主控台]。

3. 在 [Team Foundation 管理主控台] 的樹狀目錄窗格中，展開伺服器的名稱，然後選擇 [組建組態] 節點。

   注意事項
   如果出現 [設定已安裝的功能] 訊息，請參閱部署組建伺服器。

4. 在 [組建組態] 頁面上：

   • 如果控制器未列出，請選擇 [新增控制器]。

   • 如果控制器已列出：

     

     選擇 [屬性]。

   [組建控制器屬性] 對話方塊隨即出現。

若要從 Visual Studio 修改組建控制器

1. 在 Visual Studio 中的 [Team Explorer]：

   1. 如果您尚未連接至 Team 專案集合中的 Team 專案，請連接到 Team 專案。

   2. 選擇首頁，然後選擇 [組建]。

2. 在 [組建] 頁面中，選擇 [動作]，然後選擇 [管理組建控制器]。

   [管理組建控制器] 對話方塊隨即出現。

   

3. 選取您想要修改的組建控制器，然後選擇 [屬性]。

   [組建控制器屬性] 對話方塊隨即出現。

在 [顯示名稱] 和 [描述] 欄位中：輸入有助於小組成員在定義其建置流程時，輕易識別適當組建控制器的名稱和描述。

如需如何設定組建控制器的詳細資訊，請參閱以下各節。

讓您的建置流程利用補充二進位檔

您可以更徹底的自訂建置流程，作法是利用：

• 包含自訂工作流程活動的組件

• 自訂 MSBuild 工作

• 測試回合中的協力廠商單元測試架構。

若要讓您的建置流程利用這類程式碼，請將二進位檔簽入至您在 [自訂組件的版本控制路徑] 方塊中指定的資料夾 (或其任何子資料夾)。當您設定或修改這個方塊中的值時，組建伺服器會自動重新啟動以載入組件。

提示
如果您的組建結果包含 TF215097 錯誤訊息，表示建置流程可能包含了不在這個資料夾或其任何子系資料夾中的自訂活動。

如需如何將二進位檔簽入至版本控制的指引，請參閱利用您的程式碼無法建置的協力廠商二進位檔。

指定同時執行的最大組建數目

在大多數情況下，您應該保留這個原本設為 [預設為啟用的代理程式數目] 的值。不過，在某些情況下，您可能會想要控制組建佇列的深度。例如：

• 您會發現過多的組建顯示 [執行中] 狀態，即便其中有很多組建是因為等待指派給它們的組建代理程式而停滯。這種情況可能造成小組混淆。若要避免這個問題，請選取 [指定最大值]，然後指定小於在組建控制器下集區之組建代理程式數目的值。

• 您會設計自訂組建範本，讓組建一次使用來自組建控制器底下由 12 個組建代理程式構成之集區中的多個組建代理程式。此組建控制器處理的組建是同時做為三個組建代理程式之委派的自訂組建範本為基礎。為了讓組建佇列資料更加有用，您可能會進行組建控制器設定，將 [同時執行的最大組建數目] 設為 [指定最大值] (值為 4)。

移除組建控制器

1. 在 Visual Studio 中，開啟 [管理組建控制器] 對話方塊，如從 Visual Studio 修改組建控制器中所述的。

2. 選取組建控制器底下的每個組建代理程式，並藉由選擇 [移除] 的方式，或是選擇 [屬性] 後，再使用 [組建代理程式屬性。] 對話方塊將組建代理程式指派給其他組建控制器的方式，加以移除。

3. 選取您想要移除的組建控制器，然後選擇 [移除]。

注意事項
當您登入組建伺服器時，您也可以使用 Team Foundation 管理主控台來移除組建控制器。但是，如果做的話，您可能仍然需要先使用 Visual Studio 或登入其他組建伺服器，以移除組建控制器合併的所有遠端組建代理程式。

在 Team Foundation Service 裝載的 Team 專案集合中使用裝載的組建控制器。

如果您的 Team 專案集合是裝載在 Team Foundation Service 上，您或許可以略過自己組建控制器的部署，而改用裝載的組建控制器。若要使用 [裝載的組建控制器]，您只需在定義建置流程時選取它。

裝載的組建控制器會提供單一標準暫存組建代理程式。

如需裝載組建控制器之功能的詳細資訊，請參閱使用裝載的組建控制器 (英文)。

後續步驟

• 部署和設定組建代理程式
  使用組建代理程式來執行組建的處理器密集工作。這包括從版本控制取得檔案、提供工作區、編譯程式碼和執行測試。您可以在一部組建伺服器上裝載一個或多個組建代理程式。

• 設定置放資料夾
  您可以準備一個或多個置放資料夾，然後指定這些資料夾，好讓建置系統可以提供二進位檔、測試結果和記錄檔給您的小組。

• 向外延展 Team Foundation Build 系統
  隨著小組和程式碼庫的擴增，您可相對輕鬆地，以累加方式擴充您的建置系統。

• 管理建置系統
  部署組建伺服器之後，您可以從 Team Foundation 管理主控台對其進行管理。您可以從 Team Foundation 管理主控台或 Visual Studio，管理組建控制器和組建代理程式。

• 定義建置流程
  當建置系統安排就緒之後，您已準備好可以定義建置流程，包含要編譯哪些程式碼專案、哪些動作觸發組建、要執行哪些測試，以及小組所需的任何其他程序的指示。