Modifier les paramètres de cache pour un serveur de couche Application

  • Article

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

Vous pouvez 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 la couche Application. 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. En tant qu’administrateur, vous pouvez modifier les paramètres de ce cache à tout moment.

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 la couche Application.

Notes

Par défaut, le répertoire d’installation de la couche Application est %programfiles%\Azure DevOps Server 2019\Couche Application\Web Services.

Prérequis

Pour effectuer ces procédures, 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 Contrôle de compte d’utilisateur.

Spécifier un autre dossier racine de cache

  1. Sur le serveur de couche Application, créez un répertoire de cache.

    Créez le dossier sur un disque local, dans le chemin d'accès UNC ou sur un lecteur monté. Par exemple, vous pouvez créer le dossier suivant :

    d :\temp\cacheroot

    Important

    Le dossier du cache les informations sensibles qui ne sont pas chiffrées. 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.

  2. Ouvrez le menu contextuel du dossier, puis sélectionnez Propriétés.

    La boîte de dialogue Propriétés du dossier s’ouvre.

  3. Sous l’onglet Sécurité , sélectionnez Modifier.

    La boîte de dialogue Autorisations s’ouvre.

  4. Sélectionnez Ajouter.

    La boîte de dialogue Sélectionner des utilisateurs, des ordinateurs ou des groupes s’ouvre.

  5. Ajoutez le groupe local TFS_APPTIER_SERVICE_WPG, puis sélectionnez OK.

  6. Cochez la case Modifier case activée, désactivez toutes les autres zones case activée, puis sélectionnez OK.

  7. Dans Windows Explorer (ou Explorateur de fichiers), accédez à %programfiles%\Azure DevOps Server 2019\Couche Application\Web Services.

  8. Ouvrez le fichier web.config dans un éditeur de texte ou XML, puis recherchez la <appSettings> section.

  9. Ajoutez une ligne à la appSettings section pour pointer vers le dossier que vous venez de créer :

    <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 temporaire d’un disque dur, comme dans l’exemple précédent :

    <add key="dataDirectory" value="d:\temp\cacheroot" />

  10. Enregistrez et fermez le fichier web.config .

    Notes

    Pour optimiser les performances, copiez les fichiers de l'ancien dossier de cache vers le nouveau dossier de cache.

  11. Ouvrez une fenêtre d’invite de commandes, entrez iisreset, puis appuyez sur ENTRÉE.

  12. Supprimez le dossier racine de l'ancien cache.

    Notes

    Par défaut, le dossier racine du cache se trouve dans %programfiles%\Azure DevOps Server 2019\Version Control Proxy\Web Services\VersionControlProxy\Data.

Modifier les limites de suppression de fichiers du 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. Lorsque cette limite est atteinte, une routine de nettoyage fait de l’espace pour les fichiers nouvellement demandés en supprimant les fichiers avec les temps d’accès les plus anciens.

Modifier la limite à laquelle les anciens fichiers sont supprimés du cache

  1. Sur le serveur de la couche Application, ouvrez Windows Explorer (ou Explorateur de fichiers), puis accédez à \%programfiles%\Azure DevOps Server 2019\Couche Application\Web Services.

  2. Ouvrez le fichier web.config dans un éditeur de texte ou XML, puis recherchez l’élément \<appSettings\> .

  3. Ajoutez un des éléments suivants :

    • Pour spécifier un pourcentage d’espace disque disponible à remplir avant la suppression des anciens fichiers, ajoutez l’élément PercentageBasedPolicy . Vous devez spécifier un nombre entier comme valeur de cet élément.

      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 :

      <add key="PercentageBasedPolicy" value="60" />

    • Pour spécifier une taille fixe en Mo que le cache doit atteindre avant la suppression des anciens fichiers, ajoutez l’élément FixedSizeBasedPolicy . Vous devez spécifier un nombre entier comme valeur de cet élément.

      Par exemple, la ligne suivante spécifie que le cache doit atteindre 500 Mo avant la suppression des anciens fichiers :

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

      Notes

      Si les FixedSizeBasedPolicy éléments et PercentageBasedPolicy sont spécifiés, la valeur de l’élément FixedSizeBasedPolicy est utilisée à la place de la valeur de l’élément PercentageBasedPolicy .

  4. Enregistrez et fermez le fichier web.config .

  5. Ouvrez une fenêtre d’invite de commandes, entrez iisreset, puis appuyez sur ENTRÉE.

Modifier la quantité de cache à libérer lors de la suppression d’anciens fichiers

  1. Sur le serveur de la couche Application, ouvrez Windows Explorer (ou Explorateur de fichiers) et accédez à %programfiles%\Azure DevOps Server 2019\Couche Application\Web Services\.

  2. Ouvrez le fichier web.config dans un éditeur de texte ou XML, recherchez l’élément <appSettings> , puis ajoutez l’élément CacheDeletionPercent .

    Par exemple, la ligne suivante spécifie qu'il faut libérer 50 % du cache lors de la suppression d'anciens fichiers :

    <add key="CacheDeletionPercent" value="50" />

  3. Enregistrez et fermez le fichier web.config .

  4. Ouvrez une fenêtre d’invite de commandes, entrez iisreset, puis appuyez sur ENTRÉE.

Article connexe