建立和使用組建控制器

  • 發行項

若要使用 Team Foundation Build，您的小組必須至少具有一個組建控制器，該組建控制器會統籌處理和管理一個或多個組建代理程式的服務。 它會執行某些工作，但是會將需要大量處理器資源的作業 (例如編譯程式碼或執行測試) 分散到集區內的組建代理程式。 每個組建控制器都專屬於單一的 Team 專案集合。

在開始之前：

  • 您應閱讀組建控制器在組建系統中所擔當的角色，以及使用組建代理程式的不同方式。 如需詳細資訊，請參閱認識 Team Foundation Build 系統。

  • 組建控制器裝載於組建電腦上。 因此，您必須先設定一部組建電腦，之後才可以建立和使用組建控制器。 每一部組建電腦可以裝載一個組建控制器。 如需詳細資訊，請參閱 設定組建電腦。

本主題內容

  • 必要的使用權限

  • 建立組建控制器

  • 修改組建控制器

  • 組建控制器屬性對話方塊

  • 移除組建控制器

必要的使用權限

若要執行此程序，您必須是組建電腦上 [Administrators] 群組的成員，且必須將您在 Visual Studio Team Foundation Server 中的 [管理組建資源] 權限設為 [允許]。 如需詳細資訊，請參閱 Team Foundation Server 使用權限。

建立組建控制器

若要建立組建控制器

  1. 登入您想要建立組建控制器的組建電腦。

  2. 依序按一下 [開始]、[所有程式]、[Microsoft Team Foundation Server 2010]，然後按一下 [Team Foundation 管理主控台]。

    [Team Foundation 管理主控台] 隨即出現。

  3. 在樹狀目錄窗格中，展開伺服器的名稱。

  4. 按一下 [組建組態] 節點。

    組建電腦的相關資訊會出現在內容窗格中。

    如果未出現 [組建服務已設定使用] 訊息或 [組建服務未註冊] 訊息，請參閱設定組建電腦。

  5. 如果內容窗格中出現 [新增控制器] 連結，則按一下此連結。

  6. (選擇性) 立即在組建控制器的名稱下方，按一下 [屬性] 修改組建控制器的各種屬性。

    [組建控制器屬性] 對話方塊隨即出現。 如需詳細資訊，請參閱本主題後面的組建控制器屬性。

  7. 如果 [啟動] 連結立即出現在組建控制器名稱下方，則按一下此連結。

修改組建控制器

您可以從用戶端機器中或者直接在裝載組建控制器的組建電腦上，修改組建控制器。

若要從用戶端機器修改組建控制器

  1. 在 Visual Studio 中，開啟 [建置] 功能表，然後按一下 [管理組建控制器]。

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

  2. 選取您想要修改的組建控制器，然後按一下 [屬性]。

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

若要在組建電腦上修改組建控制器

  1. 登入執行您要修改之組建控制器的組建電腦。

  2. 依序按一下 [開始]、[所有程式]、[Microsoft Team Foundation Server 2010]，然後按一下 [Team Foundation 管理主控台]。

    [Team Foundation 管理主控台] 隨即出現。

  3. 在樹狀目錄窗格中，展開伺服器的名稱。

  4. 按一下 [Team Foundation Build] 節點。

  5. 立即在您想要修改之組建控制器的名稱下方，按一下 [屬性]。

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

組建控制器屬性對話方塊

在 [組建控制器屬性] 對話方塊中，您可以檢視或變更顯示名稱和說明，以及影響組建控制器運作方式的其他屬性。

顯示名稱、說明

提供可協助人員輕鬆識別和取得組建控制器相關重要資訊的名稱和說明。 例如，這些值可協助您的小組成員在定義組建時指定正確的組建控制器。

電腦名稱

此方塊會顯示裝載此組建控制器之組建電腦的名稱。

自訂組件的版本控制路徑

您可以使用此欄位，讓您的組建利用下列各種組件：

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

  • 自訂 MSBuild 工作

您可以將此類程式碼簽入做為您在此欄位中所指定資料夾子系的任何資料夾。

注意事項注意事項

如果您設定或修改此值，則 Team Foundation Build Service 會自動重新啟動以載入新的組件。

同時執行的最大組建數目

您可以使用此欄位來控制組建佇列的深度。 在大多數情況下，您應保留將此值設為 [預設為代理程式數目]。

在某些情況下，您可能會發現過多的組建顯示 [執行中] 狀態，即便其中有很多組建是因為等待指派給它們的組建代理程式而停駐。 此類狀況會對小組造成混淆。 在這些狀況中，您可能想要按一下 [指定最大值]，然後指定小於在組建控制器下集區之組建代理程式數目的值。

例如，您可能會設計自訂組建範本來讓您的組建一次使用多個組建代理程式。 您在組建控制器下集區 12 個組建代理程式。 此組建控制器處理的組建是以同時使用三個組建代理程式來處理組建的自訂組建範本為基礎。 若要對組建佇列提供更加準確的外觀，您可能會設定組建控制器將 [同時執行的最大組建數目] 設為 [指定最大值] (值為 4)。

已啟用 [組建控制器] 服務

選取此核取方塊可讓此組建控制器運作，在您想要停用它並防止對其指派組建時，清除此核取方塊。

秘訣秘訣

當您在組建電腦上執行維護時停用組建控制器，可以避免某些問題。

移除組建控制器

您可以透過使用用戶端機器或者直接從裝載組建控制器的組建電腦中，修改移除組建控制器。

注意：移除組建控制器並不會從組建電腦中解除安裝 Team Foundation Build Service。

若要透過使用用戶端機器移除組建控制器

  1. 在 Visual Studio 中的 [組建] 功能表上，按一下 [管理組建控制器]。

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

  2. 按一下您想要移除的組建控制器，然後按一下 [移除]。

若要從組建電腦中移除組建控制器

  1. 登入執行您要修改之組建控制器的組建電腦。

  2. 依序按一下 [開始]、[所有程式]、[Microsoft Team Foundation Server 2010]，然後按一下 [Team Foundation 管理主控台]。

    [Team Foundation 管理主控台] 隨即出現。

  3. 在樹狀目錄窗格中，展開伺服器的名稱。

  4. 按一下 [Team Foundation Build] 節點。

  5. 緊接在您想要移除之組建控制器的名稱下方，按一下 [移除]。

請參閱

其他資源

定義您的建置流程