Comment installer le serveur proxy Azure DevOps et configurer un site distantHow to install Azure DevOps Proxy Server and set up a remote site

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.

Si vous avez des développeurs sur un site distant qui partagent du code avec des développeurs sur le site principal, vous pouvez économiser de la bande passante en mettant en cache les fichiers de contrôle de version dans l'emplacement distant.If you have developers at a remote site who are sharing code with developers at the main site, you might save bandwidth by caching version control files at the remote location. Le serveur proxy Azure DevOps distribue les fichiers de contrôle de version populaires à partir de son cache sur le site distant, plutôt que de faire en sorte que plusieurs développeurs du site distant téléchargent le même fichier à partir du site principal.Azure DevOps Proxy Server distributes popular version control files from its cache at the remote site, rather than having multiple developers from the remote site each download the same file from the main site. Votre équipe située sur le site distant fonctionne comme elle l'a toujours fait, sans gérer les fichiers de contrôle version qui sont chargés dans le cache.Your team at the remote site works like they always have, without managing which version control files get loaded into the cache.

Pour configurer cela, vous devez installer et configurer le serveur proxy sur le site distant, connecter le serveur proxy à la couche application, puis connecter la fonctionnalité de contrôle de version de Team Explorer au proxy.To set this up, you install and configure the proxy server at the remote site, connect the proxy server to the application tier, and then connect the version control feature of Team Explorer to the proxy. Avant de pouvoir commencer à mettre en cache des fichiers sur le site distant, vous devez ajouter le compte de service du serveur proxy à Azure DevOps Server sur le site principal.Before you can start to cache files at the remote site, you must add the service account for the proxy server to Azure DevOps Server at the main site.

Serveur proxy Azure DevOps

Fichiers de contrôle de version du cache sur un site distantCache version control files at a remote site

ÉtapeStep TâcheTask Instructions détailléesDetailed instructions
Étape 1 Vérifiez le matériel et les logiciels pris en charge.Check for supported hardware and software. Vérifiez que le système d’exploitation répond à la configuration requise pour le serveur proxy Azure DevOps et que le matériel peut l’exécuter.Verify that the operating system meets requirements for Azure DevOps Proxy Server and that the hardware can run it. Configuration système requise pour le serveur proxy Azure DevOpsSystem requirements for Azure DevOps Proxy Server
Étape 2 Configurez le serveur proxy Azure DevOps.Set up Azure DevOps Proxy Server. Installez le serveur proxy Azure DevOps.Install Azure DevOps Proxy Server. Une fois l’installation terminée, utilisez le centre de configuration Azure DevOps Server pour configurer votre serveur proxy.After the installation is finished, use the Azure DevOps Server Configuration Center to configure your proxy server. Exécuter l’installation Azure DevOps ServerRun Azure DevOps Server installation
Procédure : configurer le serveur proxy Azure DevOps à l’aide du centre de configuration Azure DevOps ServerHow to: Configure Azure DevOps Proxy Server Using the Azure DevOps Server Configuration Center
Étape 3 : Connectez Team Explorer au serveur proxy Azure DevOps.Connect Team Explorer to Azure DevOps Proxy Server. Une fois que vous avez configuré le serveur proxy pour qu’il se connecte à Azure DevOps Server, vous devez configurer Team Explorer pour accéder aux fichiers de contrôle de version par le biais du serveur proxy.After you configure the proxy server to connect to Azure DevOps Server, you must configure Team Explorer to access version control files through the proxy server. Comment : configurer le contrôle de version Team Foundation pour utiliser un serveur proxyHow to: Configure Team Foundation version control to use Proxy server

Configurer le serveur proxy Azure DevOpsConfigure Azure DevOps Proxy Server

Vous pouvez utiliser la procédure suivante pour configurer le serveur proxy Azure DevOps avec le centre de configuration Azure DevOps Server.You can use the following procedure to configure Azure DevOps Proxy Server with the Azure DevOps Server Configuration Center.

Notes

Vous pouvez accéder au centre de configuration Azure DevOps Server à partir du menu Démarrer en lançant Azure DevOps Server console d’administration, en sélectionnant serveur proxy, puis en sélectionnant configurer les fonctionnalités installées.You can access the Azure DevOps Server Configuration Center from the Start menu by launching Azure DevOps Server Administration Console, selecting Proxy Server, and then selecting Configure Installed Features.

PrérequisPrerequisites

Pour suivre cette procédure, vous devez disposer des niveaux d’autorisation suivants :To follow this procedure, you must have the following permission levels:

  • Appartenance au groupe de sécurité Administrateurs sur le serveur sur lequel vous configurez le serveur proxy Azure DevOps.Membership in the Administrators security group on the server on which you are configuring Azure DevOps Proxy Server.

  • Appartenance au groupe Project Collection Administrators sur Azure DevOps Server.Membership in the Project Collection Administrators group on Azure DevOps Server.

  • Par Azure DevOps Services vous devez être administrateur de collection ou disposer des autorisations de proxy pour gérer l’espace de noms du proxy.For Azure DevOps Services you either need to be a collection admin, or have manage proxy permissions on the Proxy namespace. Vous pouvez accorder des autorisations de proxy à l’aide de :You can grant proxy permissions using:

    tfssecurity /a+ Proxy Proxy Manage <user account> ALLOW /collection:{collection url}
    

    Notes

    Vous devez disposer d’un serveur proxy sur TFS Update 2 ou une version ultérieure pour pouvoir utiliser la commande précédente.You must have a proxy server at TFS Update 2 or newer to use the preceding command.

Pour configurer le serveur proxy Azure DevOps, Azure DevOps Server doit être installé sur un système d’exploitation serveur.To configure Azure DevOps Proxy Server, you must have Azure DevOps Server installed on a server operating system. Pour plus d’informations, consultez Configuration système requise pour Azure DevOps Server.For more information, see System requirements for Azure DevOps Server.

Configurer le serveur proxy Azure DevOpsConfigure Azure DevOps Proxy Server

Pour configurer le serveur proxy Azure DevOps à l’aide du centre de configuration Azure DevOps Server, procédez comme suit :To configure Azure DevOps Proxy Server by using the Azure DevOps Server Configuration Center, follow these steps:

  1. Sélectionnez configurer le serveur proxy Azure DevOps, puis Démarrer l’Assistant.Select Configure Azure DevOps Proxy Server, and then select Start Wizard.

    L’Assistant configuration du serveur proxy Azure DevOps s’affiche.The Azure DevOps Proxy Server Configuration wizard appears.

  2. Lisez l’écran d’accueil, puis sélectionnez suivant.Read the Welcome screen, and then select Next. Si une version du proxy TFS 2013 (cette fonctionnalité fonctionne uniquement avec le proxy TFS 2013 et versions ultérieures) est installée sur ce serveur, vous êtes invité à restaurer vos paramètres.If you had a version of TFS 2013 proxy (this feature only works with TFS 2013 proxy and forward) set up on this server, you're prompted to restore your settings. Si vous souhaitez configurer ce serveur proxy avec différentes ressources, sélectionnez non et passez à l’étape suivante.If you want to configure this proxy server with different resources, select No and move on to the next step. Si vous souhaitez connecter le proxy aux mêmes serveurs de Azure DevOps Server, sélectionnez Oui.If you want to connect the proxy to the same Azure DevOps Server servers, select Yes. Azure DevOps Server tentera de s’authentifier.Azure DevOps Server will attempt to authenticate. Si Azure DevOps Server authentifie correctement tous les points de terminaison, passez à l’étape 4.If Azure DevOps Server successfully authenticates all endpoints, skip to step 4.

    En cas de problème au niveau d'un ou plusieurs points de terminaison, les options de dépannage suivantes sont disponibles pour chaque connexion qui échoue :If there is a problem with one or more endpoints, you have the following troubleshooting options for each failed connection:

    • Connexion: utilisez cette option pour authentifier manuellement les points de terminaison.Connect: Use this option to manually authenticate endpoints. L'authentification manuelle est un bon point de départ en cas d'échec de connexion.Manual authentication is a good place to start with any failed connection.

    • Ignorer: utilisez cette option pour ignorer l’authentification.Skip: Use this option to skip authentication. Skip est utile lorsque vous n’avez pas encore le mot de passe pour authentifier ce point de terminaison et que vous souhaitez enregistrer les informations de connexion pour une autre tentative ultérieure.Skip is useful when you don't yet have the password to authenticate this endpoint, and you want to save the connection information for another try later.

    • Supprimer: utilisez cette option pour supprimer complètement le point de terminaison.Remove: Use this option to completely remove the endpoint.

    Conseil

    Pour plus d’informations sur ces options, consultez le billet de blog, mises à niveau de proxy : comment vérifier les points de terminaison proxy ignorés.For more details about these options, see the blog post, Proxy Upgrades: How to Verify Skipped Proxy Endpoints.

  3. Sélectionnez Parcourir, puis sélectionnez la collection de projets à laquelle vous souhaitez que ce serveur proxy se connecte.Select Browse, and then select the project collection to which you want this proxy server to connect. Sélectionnez Suivant.Select Next.

    Notes

    Si votre collection de projets est sur Azure DevOps Services, vous êtes invité à vous authentifier.If your project collection is on Azure DevOps Services, you're prompted to authenticate. Entrez le compte Microsoft vous avez utilisé pour configurer le service.Enter the Microsoft account you used to set up the service.

  4. Sous compte de service, sélectionnez utiliser un compte système pour utiliser le service réseau ou utiliser un compte d’utilisateur pour utiliser un compte de domaine ou un compte local.Under Service Account, select Use a system account to use Network Service or Use a user account to use a domain or local account. Si vous utilisez un compte d’utilisateur, vous devez entrer le mot de passe.If you are using a user account, you must enter the password. Pour tester la combinaison de compte d’utilisateur et de mot de passe, sélectionnez test.To test the user account and password combination, select Test.

    Service réseau est la valeur par défaut pour ce compte de service de serveur proxy.Network Service is the default value for the proxy server service account.

  5. Les configurations facultatives suivantes apparaissent sous Configuration avancée:The following optional configurations appear under Advanced Configuration:

    • Si vous êtes connecté au service hébergé, le nom du compte s’affiche ici.If you're connected to the hosted service, Account Name appears here.

      Lorsque vous avez créé l’instance de Azure DevOps Server sur le service hébergé, le nom du compte a été automatiquement créé pour vous.When you created the instance of Azure DevOps Server on the hosted service, Account Name was automatically created for you. Ce compte sera ajouté au groupe Project Collection proxy Service Accounts sur le service hébergé.This account will be added to the Project Collection Proxy Service Accounts group on the hosted service. Pour utiliser un compte différent, entrez le nom du compte et sélectionnez test.To use a different account, enter the account name and select Test.

      Pour rétablir le compte de service par défaut automatiquement créé pour vous, sélectionnez rétablir le compte de service par défaut.To reset to the default service account automatically created for you, select Reset to default service account. Cela ne s’applique plus à Azure DevOps Server 2017 Update 2 et aux serveurs proxy plus récents.This is no longer applicable for Azure DevOps Server 2017 Update 2 and newer proxy servers.

    • Vous pouvez modifier les paramètres d'authentification.You can change authentication settings. Sous méthode d’authentification, sélectionnez NTLM pour utiliser l’authentification NTLM ou négocier (Kerberos) pour tenter d’abord d’utiliser l’authentification Kerberos, qui est l’option la plus sécurisée, et en cas d’échec, revenir à NTLM.Under Authentication Method, select NTLM to use NTLM authentication, or Negotiate (Kerberos) to first attempt Kerberos authentication, which is the more secure option, and if that fails, fall back to NTLM.

      NTLM est la valeur par défaut.NTLM is the default value.

  6. Sélectionnez Suivant.Select Next.

  7. Dans port, acceptez la valeur par défaut 8081 ou entrez un autre numéro de port d’écoute pour les connexions entrantes vers le serveur proxy Azure DevOps.In Port, accept the default value of 8081 or enter a different listener port number for incoming connections to Azure DevOps Proxy Server.

    8081 est la valeur par défaut.8081 is the default value.

  8. Dans répertoire racine du cache, acceptez la valeur par défaut ou entrez le chemin d’accès à un emplacement différent dans lequel stocker les fichiers cache.In Cache Root Directory, accept the default value, or enter the path of a different location in which to store cache files.

    La valeur par défaut est lecteur: \ Program Files \ tfs \ 12,0 version Control proxy \ _ tfs _ DataThe default value is Drive:\Program Files\TFS 12.0\Version Control Proxy\ _tfs_data

    Lecteur est la lettre du lecteur sur lequel vous souhaitez stocker les fichiers cache.Drive is the letter of the drive on which you want to store cache files. Vous pouvez spécifier un lecteur réseau mappé.You can specify a mapped network drive.

  9. Sélectionnez Suivant.Select Next.

  10. Dans la page vérifier, passez en revue les paramètres, puis sélectionnez suivant.On the Review page, review the settings, and then select Next.

    L'Assistant valide votre configuration.The wizard validates your configuration.

  11. Sélectionnez configurer pour que l’Assistant applique les paramètres de configuration.Select Configure for the wizard to apply configuration settings.

  12. Sélectionnez suivant sur l’écran de réussite pour lire les résultats détaillés sur l’écran de réussite suivant.Select Next on the success screen to read the detailed results on the next success screen. Vous trouverez également sur cet écran un lien vers un journal qui contient les résultats de la configuration.You will also find a link to a log on this screen that contains the results of the configuration.

  13. Sélectionnez Fermer à deux reprises et la console d’administration Azure DevOps Server s’affiche.Select Close twice and the Azure DevOps Server Administration Console will appear.

Configurer le contrôle de version Team FoundationConfigure Team Foundation version control

Vous pouvez configurer le contrôle de version Team Foundation pour utiliser un serveur proxy, qui met en cache des copies des fichiers de contrôle de version à l’emplacement d’une équipe distribuée.You can configure Team Foundation version control to use a proxy server, which caches copies of version control files in the location of a distributed team. Vous pouvez réduire les besoins en bande passante pour les développeurs distants à l’aide d’un serveur proxy.You may reduce bandwidth requirements for remote developers by using a proxy server.

Pour suivre cette procédure, vous devez être membre du groupe de sécurité utilisateurs sur l’ordinateur sur lequel vous configurez Team Explorer.To follow this procedure, you must be a member of the Users security group on the computer on which you are configuring Team Explorer.

Pour configurer Team Explorer pour utiliser le serveur proxy Azure DevOps :To configure Team Explorer to use Azure DevOps Proxy Server:

  1. Lancez Visual Studio.Launch Visual Studio.

  2. Dans le menu Tools (Outils), sélectionnez Options.On the Tools menu, select Options.

  3. Dans la boîte de dialogue options , développez contrôle de code source, puis sélectionnez sélection du plug- in.In the Options dialog box, expand Source Control, and then select Plug-in Selection.

  4. Pour le plug-in de contrôle de code source actuel, assurez-vous que la valeur est Visual Studio Team Foundation Server.For Current source control plug-in, ensure the value is Visual Studio Team Foundation Server.

  5. Sous contrôle de code source, sélectionnez Visual Studio Team Foundation Server.Under Source Control, select Visual Studio Team Foundation Server.

  6. Activez la case à cocher utiliser un serveur proxy pour les téléchargements de fichiers .Select the Use proxy server for file downloads check box.

  7. Dans la zone nom du serveur proxy , entrez le nom du serveur exécutant le serveur proxy Azure DevOps.In the Proxy server name box, enter the name of the server running Azure DevOps Proxy Server.

  8. Dans la zone port , entrez le port de l’écouteur pour le serveur proxy Azure DevOps.In the Port box, enter the listener port for Azure DevOps Proxy Server. Par défaut, le serveur proxy Azure DevOps écoute les demandes des clients sur le port 8081.By default, Azure DevOps Proxy Server listens for client requests on port 8081.

Questions et réponsesQ & A

Q : le serveur proxy est-il à compatibilité descendante avec les versions précédentes de TFS ?Q: Is the proxy server backward compatible with previous versions of TFS?

R : Oui.A: Yes. Le serveur proxy est entièrement compatible avec TFS 2010 et TFS 2012.The proxy server is fully compatible with TFS 2010 and TFS 2012. En fait, TFS Proxy 2010, TFS Proxy 2012 et le serveur proxy sont entièrement compatibles les uns avec les autres dans n’importe quelle combinaison.In fact, TFS Proxy 2010, TFS Proxy 2012, and the proxy server are fully compatible with one another in any combination. Par exemple, vous pouvez utiliser le proxy TFS 2010 avec le serveur proxy, ou vice versa.For example, you can use TFS Proxy 2010 with the proxy server or vice versa.

Q : n’importe quelle version du serveur proxy Azure DevOps a-t-elle des améliorations de nettoyage du cache pour prendre en charge des disques de plus de 1 to ?Q: Does any version of Azure DevOps Proxy Server have cache cleanup improvements to support disks larger than 1 TB?

R : Oui.A: Yes. Le serveur proxy offre des améliorations du nettoyage du cache pour prendre en charge des disques de grande taille.The proxy server has cache cleanup improvements to support large disks.

Q : le serveur proxy a-t-il une logique de détection d’altération ?Q: Does the proxy server have corruption detection logic?

R : Oui.A: Yes. Si un fichier mis en cache est endommagé sur un disque après son stockage, le serveur proxy a une logique pour détecter les dommages.If a cached file becomes corrupted on a disk after it was stored, the proxy server has logic to detect the corruption.

Q : le serveur proxy prend-il entièrement en charge la mise en cache par rapport à dev.azure.com ?Q: Does the proxy server fully support caching against dev.azure.com?

R : Oui.A: Yes.

Q : que se passe-t-il dans le cache du proxy lors de la mise à niveau d’une version du serveur proxy Azure DevOps vers un autre ?Q: What happens to the proxy cache when I upgrade from one version of Azure DevOps Proxy Server to another?

R: Si vous effectuez une mise à niveau à partir d’une version antérieure du serveur proxy Azure DevOps ou du serveur proxy TFS, le cache est conservé pendant la mise à niveau.A: If you upgrade from an earlier version of Azure DevOps Proxy Server or TFS Proxy server, the cache is preserved during upgrade. Vous pourrez continuer à accéder immédiatement à Azure DevOps Server à partir d’emplacements distants, sans aucun impact sur les performances, car Azure DevOps Server n’aura pas besoin de recréer ou de remplir à nouveau le cache.You will be able to continue accessing Azure DevOps Server from remote locations right away, without any performance impact, because Azure DevOps Server will not need to recreate or repopulate the cache.