Associer le débogueur distant

Ce document explique comment attacher le débogueur distant Visual Studio aux processus d'une VM Compute Engine exécutant Windows.

Prérequis

Avant de commencer, assurez-vous que votre VM respecte les prérequis suivants :

  • Elle exécute le système d'exploitation Windows.

  • Elle dispose d'une adresse IP publique.

  • La session PowerShell distante est installée et activée.

    • Si vous ne souhaitez pas activer la connexion à distance PowerShell ou si elle n'est pas installée sur la VM, vous pouvez trouver les étapes à suivre pour installer manuellement les outils à distance du débogueur Visual Studio en recherchant débogage à distance MSDN Visual Studio.

    • Vous pouvez également ajouter des règles de pare-feu pour débloquer le port de l'outil à distance du débogueur.

Vous pouvez déployer une image ASP.NET Framework respectant tous ces prérequis.

Attacher le débogueur distant

Pour attacher le débogueur distant :

  1. Sélectionnez Tools > Google Cloud Tools > Show Google Cloud Explorer (Outils > Outils Google Cloud > Afficher Google Cloud Explorer) pour lancer Cloud Explorer.

  2. Cliquez avec le bouton droit de la souris sur l'instance de VM Compute Engine à laquelle vous souhaitez attacher le débogueur distant, puis sélectionnez Attach debugger (Attacher le débogueur).

    L'assistant d'attache du débogueur s'affiche.

  3. Cliquez sur OK lorsque vous y êtes invité pour ajouter des règles de pare-feu afin d'autoriser le trafic vers les ports requis.

    1. Le lien Learn more (En savoir plus) dans la boîte de dialogue vous permet d'accéder à la section Ouvrir les ports de pare-feu pour plus d'informations.

  4. Sélectionnez le processus à déboguer et cliquez sur OK.

Veuillez noter les points suivants :

  • La première fois que vous vous connectez à une instance de VM distante, l'assistant installe les outils à distance du débogueur Visual Studio à votre place. Cette installation peut prendre un certain temps si la VM se trouve dans une région différente.

  • Les outils de débogage sont installés dans le répertoire Program Files\VisualStudioRemoteTools de la machine cible.

  • Vous devez charger manuellement les symboles si vous souhaitez optimiser votre version :

    1. Lors du débogage de votre application, sélectionnez Debug > Windows > Modules (Débogage > Windows > Modules).

    2. Localisez votre assemblage de débogage.

    3. Cliquez avec le bouton droit sur l'entrée appropriée et sélectionnez Load Symbols (Charger les symboles).

Ouvrir les ports de pare-feu

Pour activer le débogage distant, vous devez ajouter des règles de pare-feu pour autoriser le trafic sur la machine cible et permettre la connexion aux outils de débogage distant. Pour Visual Studio 2017, le port est 4022.

Cloud Tools for Visual Studio peut installer et démarrer des outils à distance à l'aide d'une connexion PowerShell distante. Vous devez au préalable activer le port 5986 afin d'autoriser HTTPs pour PowerShell distant.

Lorsque vous avez terminé le débogage, supprimez les règles de pare-feu :

  1. Sélectionnez Tools > Google Cloud Tools > Show Google Cloud Explorer (Outils > Outils Google Cloud > Afficher Google Cloud Explorer) pour lancer Cloud Explorer.

  2. Cliquez avec le bouton droit sur l'instance de VM Compute Engine et sélectionnez Firewall Options... (Options de pare-feu).

  3. Désactivez les cases à cocher pour les règles de pare-feu Allow Visual Studio Debugger connections to the instance (Autoriser les connexions du débogueur Visual Studio à l'instance) et Allow Remote PowerShell HTTPs traffic to the instance (Autoriser le trafic HTTPs PowerShell distant vers l'instance).

  4. Cliquez sur Save (Enregistrer) pour supprimer les règles de pare-feu.