Comme son nom l’indique le serveur Proxy TFS est un serveur proxy, comparable à un proxy web, permettant d’optimiser l’accès pour les développeurs distants au fichiers du contrôleur de code source.
En effet, l’utilisation d’un Proxy TFS n’est utile que pour l’accès au contrôleur de code source, l’accès aux autres artéfacts de TFS n’est pas pris en compte par le serveur Proxy.
Sur ce post, je vous propose de voir ensemble :
- Le principe de fonctionnement
- L’installation du serveur Proxy
- La configuration du serveur Proxy
- La configuration des clients
Le principe de fonctionnement
TFS proxy va être utilisé pour optimiser la récupération des fichiers stockés sur le contrôleur de code source. Il n’est pas utilisé pour toute les opérations d’archivage. L’intérêt de son utilisation réside donc dans certaines configurations seulement:
- Plusieurs développeurs distants travaillent sur les mêmes sources
- Serveur de Build distant
Si les développeurs distants travaillent sur des projets distincts, il n’y a donc pas d’intérêt.
Concrètement le serveur TFS Proxy expose des Web services utilisés par le client (nécessité de IIS sur le serveur Proxy) et utilise un espace de stockage (cache) lui permettant de stocker les fichiers récupérés de manière à les fournir aux différents clients.
L’installation
L’installation fait partie de l’installation du serveur TFS 2010, c’est à dire que vous trouverez ce composant sur le DVD de TFS 2010 au même niveau que le serveur de Build. Le serveur ou vous installez le Proxy doit avoir IIS installé (pré-requis, l’installation ne le fait pas pour vous) puisque le Proxy exposera des Web services.
La configuration
Une fois la “feature” installée, vous devez la configurer via la console d’administration de TFS (Team Foundation Administration Console).
- Définir le compte utilisé et le mode d’authentification
- Définir le dossier du cache et le port utilisé
Une fois Proxy serveur configuré, la dernière étape consiste à renseigner, au niveau du fichier de configuration proxy.config, l’adresse du serveur TFS qui fournira les données. La particularité de TFS 2010 réside dans le fait qu’il faut préciser également la collection à utiliser. Vous pouvez bien sûr définir plusieurs URI.
Soit à partir du lien de l’assistant de configuration
Soit à partir de la console d’administration, une fois la configuration terminée
Voici à quoi ressemble le fichier de configuration proxy.config
<?xml version="1.0" encoding="utf-8"?>
<ProxyConfiguration
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Servers>
<Server>
<Uri>serverTFS/tfs/maCollection</Uri>
</Server>
</Servers>
<!-- Proxy file cache root folder -->
<CacheRoot>C:\...\_tfs_data</CacheRoot>
<CacheLimitPolicy>
<!-- Cache limit expressed as percentage of disk space -->
<PercentageBasedPolicy>75</PercentageBasedPolicy>
<!-- Cache limit expressed as MB -->
<!-- <FixedSizeBasedPolicy></FixedSizeBasedPolicy> -->
</CacheLimitPolicy>
<!-- Percentage of cache size that needs to be freed up, on hitting cache limit -->
<CacheDeletionPercent>10</CacheDeletionPercent>
<!-- Indicates how often (number of hours) the proxy statistics information should be persisted to a file-->
<StatisticsPersistTime>1</StatisticsPersistTime>
<ReaderChunkSize>1048576</ReaderChunkSize>
<WriterChunkSize>1048576</WriterChunkSize>
</ProxyConfiguration>La configuration des clients
Une fois la configuration du serveur TFS Proxy effectuée, il ne vous reste plus qu’à indiquer à Team Explorer et Visual Studio d’utiliser un Proxy TFS. Pour cela, dans Visual Studio, dans le menu Tools, cliquez sur Options, puis sélectionnez la rubrique Source Control et Visual Studio Team Foundation Server.
Il ne vous reste plus qu’à indiquer l’adresse du serveur Proxy que vous souhaitez utiliser.
Conclusion
L’utilisation du Proxy TFS permet donc d’optimiser les opérations de récupération de fichiers pour les développeurs distants. L’ensemble des autres opérations (archivages, gestion des branches, …) ne sont pas prises en compte. De même, la consultation des Workitem ou autres fonctionnalités de TFS ne sont pas possibles à travers ce dernier. Ce Proxy reste néanmoins intéressant à mettre en place pour des équipes distantes travaillant simultanément sur le même projet et dont la qualité de l’accès internet est faible.