刷新客户端计算机上的数据缓存

  • 项目

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

若要防止在 Azure DevOps 中的版本控制或生成操作期间发生工作区错误，必须在执行某些维护操作后更新客户端计算机上的数据缓存：

  • 移动、还原、重命名或故障转移数据层或应用程序层服务器后
  • 从硬件故障等故障中恢复后

在任一情况下，都必须刷新缓存以跟踪工作项，并且用户必须刷新客户端计算机上的版本控制缓存。

先决条件

若要调用 StampWorkitemCache Web 方法，你必须是 Azure DevOps 应用程序层服务器上的 Administrators 安全组的成员。 有关详细信息，请参阅Azure DevOps Server的权限参考。

若要在客户端计算机上使用 tf workspaces 命令，必须将 “读取 ”权限设置为 “允许”。

刷新工作项缓存

此过程是可选的。 仅当工作项跟踪出错时，才应执行此操作。

若要更新用于跟踪工作项的缓存，请调用 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 workspaces 命令。 它们必须更新使用版本控制并连接到数据库已重新定位的项目集合的任何计算机。

刷新客户端计算机上的版本控制缓存：

  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 命令。