Actualiser les caches de données sur les ordinateurs clients

  • Article

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

Pour empêcher les erreurs d’espace de travail de se produire pendant les opérations de contrôle de version ou de génération dans Azure DevOps, le cache de données sur les ordinateurs clients doit être mis à jour après certaines opérations de maintenance :

  • Après avoir déplacé, restauré, renommé ou basculé un serveur de la couche Données ou de la couche Application
  • Après la récupération d’une défaillance telle qu’un dysfonctionnement matériel

Dans les deux cas, vous devez actualiser le cache pour le suivi des éléments de travail, et les utilisateurs doivent actualiser le cache de contrôle de version sur les ordinateurs clients.

Prérequis

Pour appeler la méthode web StampWorkitemCache , vous devez être membre du groupe de sécurité Administrateurs sur le serveur de la couche Application pour Azure DevOps. Pour plus d’informations, consultez Informations de référence sur les autorisations pour Azure DevOps Server.

Pour utiliser la commande tf workspaces sur l’ordinateur client, votre autorisation Lecture doit être définie sur Autoriser.

Actualiser le cache d'éléments de travail

Cette procédure est facultative. Vous ne devez effectuer cette opération que si des erreurs se produisent lors du suivi des éléments de travail.

Pour mettre à jour le cache pour le suivi des éléments de travail, appelez la méthode web StampWorkitemCache . Cette méthode force les ordinateurs clients à mettre à jour le cache la prochaine fois qu’ils se connectent au serveur de la couche Application. Cette méthode synchronise également les espaces de travail définis sur les ordinateurs clients.

Notes

Lorsque vous appelez la méthode web StampWorkitemCache, les performances de Visual Studio Azure DevOps Server peuvent temporairement se dégrader. L’impact sur les performances dépend du nombre d’utilisateurs Azure DevOps connectés lorsque vous appelez la méthode.

Pour actualiser le cache pour le suivi des éléments de travail sur les ordinateurs clients :

  1. Sur le nouveau serveur, ouvrez Internet Explorer.

  2. Dans la barre d’adresse, entrez l’adresse suivante pour vous connecter au service web ClientService :

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

    Notes

    Même si vous êtes connecté avec des informations d’identification administratives, vous devrez peut-être démarrer Internet Explorer en tant qu’administrateur, et vous pouvez être invité à entrer vos informations d’identification.

  3. Sélectionnez StampWorkitemCache, puis choisissez Appeler. La méthode StampWorkitemCache ne retourne aucune donnée.

Actualiser le cache de contrôle de version

Pour actualiser le cache de contrôle de version, chaque utilisateur exécute la commande tf workspaces sur chaque ordinateur qui doit être mis à jour. Ils doivent mettre à jour tout ordinateur qui utilise le contrôle de version et qui se connecte à une collection de projets dont les bases de données ont été déplacées.

Pour actualiser le cache de contrôle de version sur les ordinateurs clients :

  1. Sur l’ordinateur client, ouvrez une fenêtre d’invite de commandes avec des autorisations d’administration et remplacez les répertoires par Drive :\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE.

  2. À l'invite de commandes, entrez la commande suivante, y compris l'URL de la collection, qui inclut le nom de serveur et le numéro de port du nouveau serveur :

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

    Dans l’exemple de déploiement, un développeur doit actualiser le cache de contrôle de version d’un projet membre de la collection DefaultCollection, qui est hébergé dans le déploiement FabrikamPrime de Azure DevOps Server :

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

    Pour plus d’informations, consultez Commande Espaces de travail.