重新整理用戶端電腦上的資料快取

Azure DevOps Server 2022 |Azure DevOps Server 2020 |Azure DevOps Server 2019

若要防止在 Azure DevOps 中的版本控制或建置作業期間發生工作區錯誤,用戶端電腦上的數據快取必須在特定的維護作業之後更新:

  • 移動、還原、重新命名或故障轉移數據層或應用層伺服器之後
  • 從失敗復原之後,例如硬體故障

不論是哪一種情況,您都必須重新整理快取以追蹤工作專案,而且用戶必須在用戶端計算機上重新整理版本控制快取。

必要條件

若要叫用 StampWorkitemCache Web 方法,您必須是 Azure DevOps 應用層伺服器上 Administrators 安全組的成員。 如需詳細資訊,請參閱 Azure DevOps Server 的許可權參考

若要在用戶端電腦上使用 tf 工作區 命令,您的 讀取 許可權必須設定為 [允許]。

重新整理工作項目快取

此程序是選用的。 只有當工作項目追蹤發生錯誤時,您才應該執行這項程序。

若要更新追蹤工作專案的快取,請叫用 StampWorkitemCache Web 方法。 此方法會強制用戶端電腦下次連線到應用層伺服器時更新快取。 此外,這個方法也會同步處理用戶端電腦上所定義的工作區。

注意

當您叫用 StampWorkitemCache Web 方法時,Visual Studio Azure DevOps Server 的效能可能會暫時降低。 效能影響取決於當您叫用 方法時,有多少 Azure DevOps 使用者已連線。

若要重新整理快取以追蹤用戶端電腦上的工作專案:

  1. 在新伺服器上開啟 Internet Explorer。

  2. 在 [位址列] 中,輸入下列位址以聯機到 ClientService Web 服務:

    http://PublicURL/VirtualDirectory:8080/WorkItemTracking/v3.0/ClientService.asmx

    注意

    即使您以系統管理認證登入,您可能需要以系統管理員身分啟動 Internet Explorer,而且系統可能會提示您輸入認證。

  3. 選取 [StampWorkitemCache],然後選擇 [ 用]。 StampWorkitemCache 方法不會傳回任何數據。

重新整理版本控制快取

若要重新整理版本控制快取,每個用戶必須在必須更新的每部計算機上執行 tf 工作區 命令。 他們必須更新任何使用版本控制的計算機,且該計算機會連線到資料庫重新放置的專案集合。

若要重新整理客戶端電腦上的版本控制快取:

  1. 在用戶端電腦上,開啟具有系統管理許可權的命令提示字元視窗,並將目錄變更為 Drive:\Program Files (x86) \Microsoft Visual Studio 12.0\Common7\IDE。

  2. 在命令提示字元中輸入下列命令以及集合的 URL,其中包括新伺服器的伺服器名稱和連接埠號碼:

    tf workspaces /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName

    在範例部署中,開發人員需要針對屬於 DefaultCollection 集合成員的專案重新整理版本控制快取,該集合裝載於 Azure DevOps Server 的 FabrikamPrime 部署中:

    tf workspaces /collection:http://FabrikamPrime:8080/tfs/DefaultCollection

    如需詳細資訊,請參閱 Workspaces 命令