管理您的建置系統

您已設定組建伺服器，包括組建控制器和組建代理程式。 您已定義建置流程，以符合小組的需求。 為了編譯和測試應用程式，您的小組目前正在執行和管理自動化組建。

有時候，您會遇到需要監視和管理建置系統的情況，例如診斷問題或向外延展建置系統。

必要的使用權限

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

您想要怎麼做？

• 從 Visual Studio 中，檢查狀態、管理並修改您的控制器和代理程式

• 從管理主控台，檢查狀態、管理並修改您的伺服器、控制器和代理程式

• 啟動、停止或重新啟動組建伺服器

• 重新啟動組建控制器或組建代理程式

• 啟用或停用控制器或代理程式

• 為控制器指定同時執行的最大組建數目

• 註冊或移除註冊組建伺服器

• 監視組建伺服器的健康情況

• 使用事件記錄檔診斷問題

• 執行後續步驟

從 Visual Studio 中，檢查狀態、管理並修改您的控制器和代理程式

在某些情況下，例如，當加入佇列的建置流程沒有啟動或無法進行時，您會想要檢查狀態並管理您的組建控制器和組建代理程式。 您可以直接從 Visual Studio 執行上述所有動作。

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

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

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

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

後續步驟

• 檢查您的控制器和代理程式的狀態

  • 如果 [狀態] 為 [可用]，而且 [狀態] 為 [允許]，則元件目前可能運作正常。

  • 如果 [狀態] 為 [停用]，您可以選取元件，再選擇 [屬性]，然後重新啟用該元件。

  • 如果 [狀態] 為 [離線]，則元件已中斷連接。 登入組建伺服器，並確定該伺服器已註冊且可以連接至您的 Team Foundation Server。

• 檢視、修改、啟用或停用控制器或代理程式
  選取它並選擇 [屬性]，然後參閱部署和設定組建控制器 or 部署和設定組建代理程式。

• 移除控制器或代理程式
  請參閱移除組建控制器或移除組建代理程式。

• 使用組建伺服器、控制器或代理程式管理或解決問題
  如需詳細資訊，請參閱下面章節。

從管理主控台，檢查狀態、管理並修改您的伺服器、控制器和代理程式

當您想要檢查或管理組建的系統元件時，有時候需要可在登入組建伺服器時使用的其他功能。

1. 登入您要設定的組建伺服器。

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

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

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

4. 選擇 [組建組態] 節點。

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

後續步驟

• 檢查您的控制器和代理程式的狀態

  • 如果有任何組建控制器或組建代理程式正在處理組建，您可以在 Team Foundation 管理主控台上，即時查看有關這個進行中工作的訊息。

    

    如需監視和執行建置程序的詳細資訊，請參閱執行、監視和管理組建和診斷組建的問題。

  • 如果 控制器或 代理程式是紅色，則元件已中斷連接。 確定組建伺服器可以連接至您的 Team Foundation Server。

• 與組建伺服器搭配使用

  

  • 選擇 [重新啟動]、[停止] 或 [啟動] 以啟動、停止或重新啟動組建伺服器。

  • 選擇 [屬性] 以部署和設定組建伺服器。

  • 選擇 [註冊] 或 [移除註冊] 以註冊或移除註冊組建伺服器。

  • 選擇 [Events…] 以使用事件記錄檔診斷問題。

  • 監視組建伺服器的健康情況。

• 與組建控制器搭配使用
  

  • 選擇 [屬性]，並參閱部署和設定組建控制器。

  • 選擇 [重新啟動] 以重新啟動控制器。

  • 選擇 [啟用] 或 [停用] 以啟用或停用控制器。

• 與組建代理程式搭配使用
  

  • 選擇 [屬性]，並參閱部署和設定組建代理程式。

  • 選擇 [重新啟動] 以重新啟動代理程式。

  • 選擇 [啟用] 或 [停用] 以啟用或停用代理程式。

啟動、停止或重新啟動組建伺服器

每當您在組建伺服器上執行維護時，就停止組建伺服器，這是很好的做法。 從 Team Foundation 管理主控台中，選擇 [停止] 讓組建伺服器上裝載的所有組建控制器和組建代理程式離線。 當您準備好要將控制器和代理程式放回到服務中時，請選擇 [啟動]。

如果組建伺服器無法回應 (例如，如果建置流程無法啟動或及時進行)，則選擇 [重新啟動] 可能會有幫助。當您重新啟動組建伺服器時，Team Foundation Build Service 處理序會關閉，然後重新啟動成幾乎就像您將電腦重新開機一樣的全新狀態。 如果組建目前正由此組建伺服器上的組建控制器或任何組建代理程式處理，則取消那些組建。

重新啟動組建控制器或組建代理程式

當重新啟動組建伺服器太受到干擾或不必要時，您可以從 Team Foundation 管理主控台選擇組建控制器或組建代理程式的 [重新啟動] 連結 當您重新啟動組建控制器時，它會重新載入組件並中止其正在處理的所有組建。 當您重新啟動組建代理程式時，它會捨棄應用程式定義域、重新載入組件，並中止其正在處理的組建。

啟用或停用控制器或代理程式

您可以停用 控制器或 代理程式，防止對其指派組建。 如果您停用正在處理組建的控制器或代理程式，則組建會在停用元件之前完成。

此功能可協助您微調或暫時修改建置系統的運作方式。 例如，由於處理組建的速度太慢，因此您質疑組建伺服器目前執行過多的組建代理程式。 您可以停用部分組建代理程式並評定此操作對效能造成的影響。 稍後您可以視需要重新啟用一個或多個組建代理程式。

若要啟用或停用組建代理程式或組建控制器：

• 從 Visual Studio 管理組建控制器對話方塊中，選取您要停用或啟用的組建控制器或組建代理程式，然後選擇 [屬性]。 [組建控制器屬性] 或 [組建代理程式屬性] 對話方塊會出現。 清除或選取 [組建控制器服務已啟用] 或 [組建代理程式服務已啟用] 核取方塊。

• 在 Team Foundation 管理主控台中，找出您要停用或啟用的組建控制器或組建代理程式，然後選擇其 [啟用] 或 [停用] 連結。

註冊或移除註冊組建伺服器

如果您想要從建置系統移除組建伺服器，請在 Team Foundation 管理主控台中選擇 [移除註冊]。 當您選擇 [移除註冊] 時，系統會詢問您是否想要刪除組建伺服器上執行的任何組建控制器和組建代理程式：

• 如果您想要暫時對此組建電腦解除委任，請選擇 [否]。 這個組建伺服器上的控制器和代理程式沒有從 Team 專案集合中刪除，並在 Visual Studio 管理組建控制器對話方塊中出現 [離線] 的 [狀態]。 您可以稍後選擇 [註冊]，並還原組建控制器和組建代理程式。

• 如果您想要從 Team 專案集合中刪除此組建的所有組態設定，請選擇 [是]。 系統會刪除與任何組建控制器和組建代理程式相關的所有資訊。

如果出現訊息 [組建服務未註冊]，您可以選擇 [註冊] 重新委任組建伺服器，並讓其裝載組建控制器和組建代理程式。

提示

您也可以在部署新的組建伺服器時取代現有的組建伺服器。例如，您可能想要在更強大的新電腦上裝載相同的組態和一組組建控制器及組建代理程式。請參閱 使用 Team Foundation Server 組態工具設定 Team Foundation Build Service。

監視組建伺服器的健康情況

在已登入組建伺服器時，您可以確認 Team Foundation Build Service 正在執行、取得其目前使用資源的資訊，並確認組建伺服器的一般健康情況。

1. 執行 Windows 工作管理員 (Windows 8 上的工作管理員)。

2. 在 Windows 8 上，如果出現 [其他詳細資料] 連結，請選擇它。

3. 選取 [處理序] 索引標籤。

4. 在 Windows 8 以外的 Windows 版本中，確認已選取 [顯示所有使用者的處理序]。

5. 您的組建伺服器是在哪一個 Windows 版本上執行？

   • Windows 8：找出 Visual Studio Team Foundation Build Service Host 處理序。 這應該會位於 [背景處理序] 區段中，如果您的組建伺服器是在互動模式下執行，則位於 [應用程式] 區段。 觀察處理序使用的 CPU、記憶體、磁碟和網路資源。

   • 其他 Windows 版本：找出 [TFSBuildServiceHost.exe] 處理序。 觀察處理序使用的 CPU 和記憶體資源。

6. 使用 [工作管理員] 中的其他索引標籤，確認組建伺服器的一般健康情況。 例如，您可選擇 [效能] 索引標籤，以確認具有足夠的處理器和記憶體資源。 您可以接著選擇 [資源監視器] (在 Windows 8 中為 [開啟資源監視器])。

使用事件記錄檔診斷問題

使用事件檢視器，以取得可協助您監視組建伺服器作業方式的資訊，以及診斷組建伺服器或建置流程的問題。

檢視近期事件

藉由檢查最近期事件開始。 從 Team Foundation 管理主控台中，選擇 [事件…] 開啟事件檢視器以顯示最新的資訊、警告和錯誤訊息。

檢視作業記錄

若要取得一段較長時間的詳細資訊，請在事件檢視器的樹狀目錄窗格中，展開 [應用程式及服務記錄檔]、[Microsoft]、[Team Foundation Server]、[組建服務]，然後選擇 [操作]。

檢視分析記錄

在大多數情況下，並不需要讀取分析記錄公開的內部訊息。 不過，當您使用客戶支援來解決問題時，這項資料可能會很有用。

若要啟用分析記錄檔

1. 在 [事件檢視器] 中，選擇 [檢視]、[顯示分析與偵錯記錄檔]。

2. 在樹狀目錄窗格中，展開 [應用程式及服務記錄檔]、[Microsoft]、[Team Foundation Server]、[組建服務]，然後選擇 [分析]。

3. 趁 [分析] 仍在選取狀態時，開啟其捷徑功能表，然後選擇 [啟用]。

提示

根據預設，當這個記錄到達資料限制時，事件檢視器會停止收集資料。若要修改限制或變更這個行為，請選取 [分析] 節點，開啟其捷徑功能表並選擇 [屬性]。

自訂並檢視資料

若要將資料儲存在易於掃描和檢視的永久檔案，請在樹狀目錄窗格中選取上述的其中一個節點、開啟其捷徑功能表，然後選擇 […儲存所有事件]。 使用 [另存新檔] 對話方塊，以符合您需求的格式儲存資料。

後續步驟

• 部署和使用組建伺服器
  若要使用 Team Foundation Build 搭配內部部署 Team Foundation Server，您必須部署至少一個組建伺服器。 伺服器可以部署在實體電腦或虛擬機器上。

• 部署和設定組建控制器
  使用組建控制器執行輕量型工作，並將建置流程的處理器密集工作分配至其組建代理程式集區。 您可以在組建伺服器上裝載一個組建控制器。

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

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

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