Atualizar os caches de dados em computadores cliente

  • Artigo

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

Para impedir que erros de workspace ocorram durante operações de controle de versão ou build 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 da camada de dados ou da camada de aplicativo
  • Depois de se recuperar de uma falha, como um mau funcionamento do hardware

Em ambos os casos, você deve atualizar o cache para acompanhar 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 , você deve ser membro do grupo de segurança Administradores no servidor da camada de aplicativo do Azure DevOps. Para obter mais informações, consulte Referência de permissão para 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 do item de trabalho

Esse procedimento é opcional. Você deverá executá-lo somente se ocorrerem erros com o acompanhamento de itens de trabalho.

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

Observação

Quando você invoca o método Web StampWorkitemCache, o desempenho do Visual Studio Azure DevOps Server pode prejudicar 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 acompanhar itens de trabalho em computadores cliente:

  1. No novo servidor, abra o Internet Explorer.

  2. Na Barra de endereços, insira 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 você esteja conectado com credenciais administrativas, talvez seja necessário iniciar o Explorer da Internet como administrador e você poderá ser solicitado a fornecer suas credenciais.

  3. Selecione StampWorkitemCache e, em seguida, escolha Invocar. 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 o 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 do Prompt de Comando com permissões administrativas e altere os diretórios para Unidade:\Arquivos de Programas (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

    Na implantação de exemplo, um desenvolvedor precisa atualizar o cache de controle de versão para um projeto que seja membro da coleção DefaultCollection, que é hospedada na implantação fabrikamPrime de Azure DevOps Server:

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

    Para obter mais informações, consulte Comando Workspaces.