Partilhar via


Atualizar os caches de dados nos computadores clientes

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

Para evitar que erros de espaço de trabalho ocorram durante o controle de versão ou operações de compilação no Azure DevOps, o cache de dados em computadores cliente deve ser atualizado após determinadas operações de manutenção:

  • Depois de mover, restaurar, renomear ou fazer failover de um servidor de camada de dados ou de camada de aplicativo
  • Depois de se recuperar de uma falha, como uma avaria de hardware

Em ambos os casos, você deve atualizar o cache para controlar itens de trabalho e os usuários devem atualizar o cache de controle de versão em computadores cliente.

Pré-requisitos

Para invocar o método Web StampWorkitemCache , tem de ser membro do grupo de segurança Administradores no servidor de camada de aplicação para o Azure DevOps. Para obter mais informações, consulte Referência de permissão para o Azure DevOps Server.

Para usar o comando tf workspaces no computador cliente, sua permissão de leitura deve ser definida como Permitir.

Atualizar o cache de itens de trabalho

Este procedimento é opcional. Você deve executá-lo somente se ocorrerem erros com o rastreamento de item de trabalho.

Para atualizar o cache para rastrear itens de trabalho, invoque o método da Web StampWorkitemCache. Esse método força os computadores clientes a atualizar o cache na próxima vez que se conectarem ao servidor de camada de aplicativo. Esse método também sincroniza os espaços de trabalho definidos nos computadores cliente.

Observação

Quando você invoca o método da Web StampWorkitemCache , o desempenho do Visual Studio Azure DevOps Server pode se degradar temporariamente. O impacto no desempenho depende de quantos usuários do Azure DevOps estão conectados quando você invoca o método.

Para atualizar o cache para rastrear itens de trabalho nos computadores dos clientes:

  1. No novo servidor, abra o Internet Explorer.

  2. Na barra de endereços, digite o seguinte endereço para se conectar ao serviço Web ClientService :

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

    Observação

    Mesmo que tenha sessão iniciada com credenciais administrativas, poderá ter de iniciar o Internet Explorer como administrador e poderá ser-lhe pedido que forneça as suas credenciais.

  3. Selecione StampWorkitemCache e, em seguida, escolha Invoke. O método StampWorkitemCache não retorna dados.

Atualizar o cache de controle de versão

Para atualizar o cache de controle de versão, cada usuário executa o comando tf workspaces em cada computador que deve ser atualizado. Eles devem atualizar qualquer computador que use controle de versão e que se conecte a uma coleção de projetos cujos bancos de dados foram realocados.

Para atualizar o cache de controle de versão em computadores cliente:

  1. No computador cliente, abra uma janela de Prompt de Comando com permissões administrativas e altere os diretórios para Drive:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE.

  2. No prompt de comando, digite o seguinte comando, incluindo a URL da coleção, que inclui o nome do servidor e o número da porta do novo servidor:

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

    No exemplo de implantação, um desenvolvedor precisa atualizar o cache de controle de versão para um projeto que seja membro da coleção DefaultCollection, que está hospedada na implantação FabrikamPrime do Servidor de DevOps do Azure:

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

    Para obter mais informações, consulte Comando Espaços de trabalho.