Modifier les paramètres de cache pour un serveur de couche ApplicationChange cache settings for an application-tier server

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2013Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Notes

Azure DevOps Server a été précédemment nommé Visual Studio Team Foundation Server.Azure DevOps Server was previously named Visual Studio Team Foundation Server.

Vous pouvez aider à augmenter ou à équilibrer les performances de votre déploiement de Azure DevOps Server en modifiant les paramètres du cache pour les fichiers qui sont sous contrôle de version sur le serveur de couche application.You can help increase or balance performance in your deployment of Azure DevOps Server by changing the settings of the cache for files that are under version control on the application-tier server. Par défaut, ce cache est activé afin que les utilisateurs puissent télécharger rapidement des fichiers à partir du cache, plutôt que directement à partir de la base de données.By default, this cache is enabled so that users can download files quickly from the cache, rather than directly from the database. En tant qu’administrateur, vous pouvez modifier les paramètres de ce cache à tout moment.As an administrator, you can change the settings of this cache any time.

Vous pouvez effectuer ces tâches en modifiant le fichier web.config pour le contrôle de version, qui se trouve dans le répertoire d’installation sur le serveur de couche application.You can do these tasks by editing the web.config file for version control, which is located in the installation directory on the application-tier server.

Notes

Par défaut, le répertoire d’installation de la couche application est % ProgramFiles% \mise DevOps Server 2019 \ application Tier\Web services.By default, the installation directory for the application tier is %programfiles% \Azure DevOps Server 2019\Application Tier\Web Services.

PrérequisPrerequisites

Pour exécuter ces procédures, vous devez être membre du groupe de sécurité administrateurs sur le serveur de couche application pour Azure DevOps.To perform these procedures, you must be a member of the Administrators security group on the application-tier server for Azure DevOps.

Pour plus d’informations, consultez Contrôle de compte d’utilisateur.For more information, see User Account Control.

Spécifier un autre dossier racine de cacheSpecify a different cache root folder

  1. Sur le serveur de couche Application, créez un répertoire de cache.On the application-tier server, create a cache folder.

    Créez le dossier sur un disque local, dans le chemin d'accès UNC ou sur un lecteur monté.You can create the folder on a local disk, in the UNC path, or on a mounted drive. Par exemple, vous pouvez créer le dossier suivant :For example, you might create the following folder:

    d : \ temp \ CacheRootd:\temp\cacheroot

    Important

    Le dossier du cache les informations sensibles qui ne sont pas chiffrées.The cache folder stores sensitive information that is not encrypted. Par conséquent, vous devez vous assurer que seul le compte de service de la couche application (TFSSERVICE) dispose des autorisations modifier sur ce dossier.Therefore, you should make sure that only the service account of the application tier (TFSService) has Modify permissions to this folder.

  2. Ouvrez le menu contextuel du dossier, puis sélectionnez Propriétés.Open the shortcut menu for the folder, and then select Properties.

    La boîte de dialogue Propriétés du dossier s’ouvre.The Properties dialog box for the folder opens.

  3. Sous l’onglet sécurité , sélectionnez modifier.On the Security tab, select Edit.

    La boîte de dialogue autorisations s’ouvre.The Permissions dialog box opens.

  4. Sélectionnez Ajouter.Select Add.

    La boîte de dialogue Sélectionner les utilisateurs, les ordinateurs ou les groupes s’ouvre.The Select Users, Computers, or Groups dialog box opens.

  5. Ajoutez le groupe local tfs _ APPTIER _ service _ WPG, puis sélectionnez OK.Add the local group TFS_APPTIER_SERVICE_WPG, and then select OK.

  6. Activez la case à cocher modifier , désactivez toutes les autres cases à cocher, puis sélectionnez OK.Select the Modify check box, clear all other check boxes, and then select OK.

  7. Dans l’Explorateur Windows (ou l’Explorateur de fichiers), accédez à % ProgramFiles% \ Azure DevOps Server 2019 \ services Web de la couche application \ .In Windows Explorer (or File Explorer), browse to %programfiles%\Azure DevOps Server 2019\Application Tier\Web Services.

  8. Ouvrez le fichier web.config dans un éditeur de texte ou XML, puis recherchez la <appSettings> section.Open the web.config file in a text or XML editor, and then locate the <appSettings> section.

  9. Ajoutez une ligne à la appSettings section pour pointer vers le dossier que vous venez de créer :Add a line to the appSettings section to point to the folder that you just created:

    <add key="dataDirectory" value="NewCacheRootFolderLocation" />
    

    Par exemple, vous ajoutez la ligne suivante si vous avez créé un dossier racine de cache nommé CacheRoot dans le répertoire Temp d’un disque dur, comme dans l’exemple précédent :For example, you would add the following line if you created a cache root folder that is named cacheroot in the temp directory of a hard drive, as in the earlier example:

    <add key="dataDirectory" value="d:\temp\cacheroot" />
    
  10. Enregistrez et fermez le fichier web.config .Save and close the web.config file.

    Notes

    Pour optimiser les performances, copiez les fichiers de l'ancien dossier de cache vers le nouveau dossier de cache.To maximize performance, copy the files from the old cache folder to the new cache folder.

  11. Ouvrez une fenêtre d’invite de commandes, entrez IISReset, puis appuyez sur entrée.Open a Command Prompt window, enter iisreset, and then press ENTER.

  12. Supprimez le dossier racine de l'ancien cache.Delete the old cache root folder.

    Notes

    Par défaut, le dossier racine du cache se trouve à l’emplacement % ProgramFiles% \mise DevOps Server 2019 \ version Control Proxy\Web Services\VersionControlProxy\Data.By default, the cache root folder is located at %programfiles% \Azure DevOps Server 2019\Version Control Proxy\Web Services\VersionControlProxy\Data.

Modifier les limites de suppression des fichiers du cacheChange limits for removing files from the cache

Modifiez la limite maximale de la quantité d'espace de stockage que le serveur de couche Application peut utiliser pour mettre en cache les fichiers.You can change the maximum limit on the amount of storage space that the application-tier server can use for caching files. Lorsque cette limite est atteinte, une routine de nettoyage fait de la place pour les fichiers récemment demandés en supprimant les fichiers avec les plus anciennes heures d’accès.When this limit is reached, a cleanup routine makes room for newly requested files by deleting the files with the oldest access times.

Modifier la limite à laquelle les anciens fichiers sont supprimés du cacheChange the limit at which old files are removed from the cache

  1. Sur le serveur de couche application, ouvrez l’Explorateur Windows (ou l’Explorateur de fichiers), puis accédez à \ % programfiles% \ Azure DevOps Server 2019 \ services Web de la couche application \ .On the application-tier server, open Windows Explorer (or File Explorer), and browse to \%programfiles%\Azure DevOps Server 2019\Application Tier\Web Services.

  2. Ouvrez le fichier web.config dans un éditeur de texte ou XML, puis localisez l' \<appSettings\> élément.Open the web.config file in a text or XML editor, and then locate the \<appSettings\> element.

  3. Ajoutez un des éléments suivants :Add one of the following elements:

    • Pour spécifier un pourcentage d’espace disque disponible à remplir avant la suppression des anciens fichiers, ajoutez l' PercentageBasedPolicy élément.To specify a percentage of available disk space to fill before old files are removed, add the PercentageBasedPolicy element. Vous devez spécifier un nombre entier comme valeur de cet élément.You must specify a whole number as the value of this element.

      Par exemple, la ligne suivante spécifie que le cache doit remplir jusqu'à 60 % de la capacité de l'espace disque disponible avant de supprimer les anciens fichiers :For example, the following line specifies that the cache should fill up to 60% capacity of available disk space before old files are removed:

      <add key="PercentageBasedPolicy" value="60" />
      
    • Pour spécifier une taille fixe en Mo à atteindre par le cache avant la suppression des anciens fichiers, ajoutez l' FixedSizeBasedPolicy élément.To specify a fixed size in MB for the cache to reach before old files are removed, add the FixedSizeBasedPolicy element. Vous devez spécifier un nombre entier comme valeur de cet élément.You must specify a whole number as the value of this element.

      Par exemple, la ligne suivante spécifie que le cache doit atteindre 500 Mo avant la suppression des anciens fichiers :For example, the following line specifies that the cache should reach 500 MB before old files are removed:

      <add key="FixedSizeBasedPolicy" value="500" />
      

      Notes

      Si les deux FixedSizeBasedPolicy PercentageBasedPolicy éléments et sont spécifiés, la valeur de l' FixedSizeBasedPolicy élément est utilisée à la place de la valeur de l' PercentageBasedPolicy élément.If both the FixedSizeBasedPolicy and PercentageBasedPolicy elements are specified, the value of the FixedSizeBasedPolicy element is used instead of the value of the PercentageBasedPolicy element.

  4. Enregistrez et fermez le fichier web.config .Save and close the web.config file.

  5. Ouvrez une fenêtre d’invite de commandes, entrez IISReset, puis appuyez sur entrée.Open a Command Prompt window, enter iisreset, and then press ENTER.

Modifier la quantité de cache à libérer lors de la suppression des anciens fichiersChange the amount of cache to free when removing old files

  1. Sur le serveur de couche application, ouvrez l’Explorateur Windows (ou l’Explorateur de fichiers), puis accédez à % ProgramFiles% \ Azure DevOps Server 2019 \ services Web de la couche application \ \ .On the application-tier server, open Windows Explorer (or File Explorer), and browse to %programfiles%\Azure DevOps Server 2019\Application Tier\Web Services\.

  2. Ouvrez le fichier web.config dans un éditeur de texte ou XML, localisez l' <appSettings> élément, puis ajoutez CacheDeletionPercent l’élément.Open the web.config file in a text or XML editor, locate the <appSettings> element, and then add the CacheDeletionPercent element.

    Par exemple, la ligne suivante spécifie qu'il faut libérer 50 % du cache lors de la suppression d'anciens fichiers :For example, the following line specifies to free 50% of the cache when removing old files:

    <add key="CacheDeletionPercent" value="50" />
    
  3. Enregistrez et fermez le fichier web.config .Save and close the web.config file.

  4. Ouvrez une fenêtre d’invite de commandes, entrez IISReset, puis appuyez sur entrée.Open a Command Prompt window, enter iisreset, and then press ENTER.

Article connexeRelated article