部署和設定組建控制器

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

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

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

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

必要的使用權限

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

您想要怎麼做？

• 建立或修改組建控制器

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

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

• 移除組建控制器

• 使用組建控制器和裝載在 Visual Studio Online 上的 Team 專案集合

建立或修改組建控制器

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

1. 登入組建伺服器。

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

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

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

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

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

   • 如果控制器已列出：

     

     選擇 [屬性]

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

從 Visual Studio 修改組建控制器

1. 在 Visual Studio 中的 Team Explorer：

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

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

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

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

   

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

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

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

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

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

您可以讓建置流程運用您上傳至 Team Foundation Server 的二進位檔，例如：

• 包含自訂工作流程活動的組件。 請參閱 使用及開發自訂建置流程活動。

• 協力廠商單元測試架構。 請參閱 在建置流程中執行測試。

• 自訂 MSBuild 工作

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

提示

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

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

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

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

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

移除組建控制器

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

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

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

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

使用組建控制器和裝載在 Visual Studio Online 上的 Team 專案集合

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

**使用內部部署組建控制器：**如果建置流程需要裝載的組建控制器功能以外的資源，您可以將內部部署組建控制器連接到裝載的 Team 專案集合。

後續步驟

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

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

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

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

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