Collegamento del debugger remoto

Questo documento descrive come collegare il debugger remoto di Visual Studio ai processi su una macchina virtuale Compute Engine che esegue Windows.

Prerequisiti

Prima di iniziare, assicurati che la macchina virtuale soddisfi i seguenti prerequisiti:

  • Esecuzione del sistema operativo Windows

  • Ha un indirizzo IP pubblico

  • Ha Remote PowerShell installato e abilitato

    • Se non vuoi attivare la connessione PowerShell remota o se non è installata sulla VM, puoi trovare i passaggi per installare manualmente gli strumenti di debug remoto di Visual Studio cercando MSDN Visual Studio Remote Debugging.

    • Puoi anche aggiungere regole firewall per sbloccare la porta dello strumento di debug remoto.

Puoi eseguire il deployment di un'immagine del framework ASP.NET che soddisfi tutti questi prerequisiti.

Collegamento del debugger remoto

Per collegare il debugger remoto:

  1. Seleziona Strumenti > Strumenti Google Cloud > Mostra Google Cloud Explorer per avviare Cloud Explorer.

  2. Fai clic con il tasto destro del mouse sull'istanza VM di Compute Engine a cui vuoi collegare il debugger remoto e seleziona Collega debugger.

    Viene visualizzata la procedura guidata per il collegamento del debugger.

  3. Fai clic su Ok quando ti viene chiesto di aggiungere regole firewall per consentire il traffico alle porte richieste.

    1. Il link Scopri di più nella finestra di dialogo ti reindirizza alla sezione Apertura delle porte del firewall per ulteriori informazioni.

  4. Seleziona il processo di cui eseguire il debug e fai clic su Ok.

Tieni presente quanto segue:

  • La prima volta che ti connetti a un'istanza VM remota, la procedura guidata installa Visual Studio Debugger Remote Tools. Questa installazione può richiedere un po' di tempo se la VM si trova in una regione diversa.

  • Gli strumenti di debug sono installati in Program Files\VisualStudioRemoteTools sulla macchina di destinazione.

  • Devi caricare manualmente i simboli se ottimizzi la build di rilascio:

    1. Durante il debug dell'applicazione, seleziona Debug > Windows > Moduli.

    2. Individua l'assembly di debuggee.

    3. Fai clic con il tasto destro del mouse sulla voce appropriata e seleziona Carica simboli.

Apertura delle porte del firewall

Per attivare il debug remoto, devi aggiungere regole firewall per consentire il traffico verso il computer di destinazione e attivare la connessione a Debugging Remote Tools. Per Visual Studio 2017, la porta è 4022.

Cloud Tools for Visual Studio può installare e avviare gli strumenti remoti per te utilizzando una connessione PowerShell remota. Devi prima attivare la porta HTTPs di PowerShell remota 5986.

Al termine del debug, rimuovi le regole firewall:

  1. Seleziona Strumenti > Strumenti Google Cloud > Mostra Google Cloud Explorer per avviare Cloud Explorer.

  2. Fai clic con il tasto destro del mouse sull'istanza VM di Compute Engine e seleziona Opzioni firewall….

  3. Deseleziona le caselle di controllo per le regole firewall Consenti connessioni del debugger di Visual Studio all'istanza e Consenti traffico HTTPS di PowerShell remoto all'istanza.

  4. Fai clic su Salva per rimuovere le regole firewall.