Eseguire il debug di un servizio Servizi cloud di Azure (supporto esteso) in Visual Studio

Visual Studio offre diverse opzioni per il debug di Servizi cloud di Azure (supporto esteso) e macchine virtuali.

Prerequisiti

• Visual Studio (vedere [download di Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) con il carico di lavoro per lo sviluppo di Azure installato e i modelli di progetto e di elementi del componente individuale .NET Framework installati. Fare riferimento a Modificare Visual Studio.
• Un account Azure. Se non si ha un account Azure, attiva i vantaggi di Azure per i sottoscrittori di Visual Studio o registrati per una prova gratuita.

Eseguire il debug del servizio cloud nel computer locale

È possibile risparmiare tempo e denaro usando l'emulatore di calcolo di Azure per eseguire il debug del servizio cloud in un computer locale. Eseguendo il debug di un servizio in locale prima di distribuirlo, è possibile migliorare l'affidabilità e le prestazioni senza pagare il tempo di calcolo. Tuttavia, alcuni errori possono verificarsi solo quando si esegue un servizio cloud in Azure stesso. È possibile eseguire il debug di questi errori se si abilita il debug remoto quando si pubblica il servizio e quindi si collega il debugger a un'istanza del ruolo.

L'emulatore simula il servizio di calcolo di Azure ed è in esecuzione nell'ambiente locale in modo da poter testare ed eseguire il debug del servizio cloud prima di distribuirlo. L'emulatore gestisce il ciclo di vita delle istanze del ruolo e fornisce l'accesso alle risorse simulate, ad esempio l'archiviazione locale. Quando si esegue il debug o si esegue il servizio da Visual Studio, avvia automaticamente l'emulatore come applicazione in background e quindi distribuisce il servizio nell'emulatore. È possibile usare l'emulatore per visualizzare il servizio quando viene eseguito nell'ambiente locale. È possibile eseguire la versione completa o la versione rapida dell'emulatore. Consultare Uso dell'emulatore Express per eseguire e fare il debug di un servizio cloud in locale.

Per eseguire il debug del servizio cloud nel computer locale

1. Nella barra dei menu selezionare Debug>Avvia debug per eseguire il progetto servizi cloud di Azure (supporto esteso). In alternativa, è possibile premere F5. Verrà visualizzato un messaggio che informa che l'emulatore di calcolo sta avviando. All'avvio dell'emulatore, l'icona della barra delle applicazioni conferma.

   

2. Visualizzare l'interfaccia utente per l'emulatore di calcolo aprendo il menu di scelta rapida per l'icona di Azure nell'area di notifica e quindi selezionare Mostra interfaccia utente dell'emulatore di calcolo.

   Il riquadro sinistro dell'interfaccia utente mostra i servizi attualmente distribuiti nell'emulatore di calcolo e le istanze del ruolo in cui è in esecuzione ogni servizio. È possibile scegliere il servizio o i ruoli per visualizzare il ciclo di vita, la registrazione e le informazioni di diagnostica nel riquadro destro. Quando si mette il focus nel margine superiore di una finestra inclusa, essa si espande per riempire il riquadro destro.

3. Esaminare l'applicazione scegliendo i comandi nel menu Debug e impostando punti di interruzione nel codice. Durante l'esecuzione dell'applicazione nel debugger, i riquadri vengono aggiornati con lo stato corrente dell'applicazione. Quando si arresta il debug, la distribuzione dell'applicazione viene eliminata. Se l'applicazione include un ruolo Web e la proprietà Azione di avvio è stata impostata per avviare il Web browser, Visual Studio avvia l'applicazione Web nel browser. Se si modifica il numero di istanze di un ruolo nella configurazione del servizio, è necessario arrestare il servizio cloud e riavviare il debug in modo da poter eseguire il debug di queste nuove istanze del ruolo.

   Nota

   Quando si arresta l'esecuzione o il debug del servizio, l'emulatore di calcolo locale e l'emulatore di archiviazione non vengono arrestati. È necessario disattivarli esplicitamente dall'area di notifica.

Eseguire il debug di un servizio cloud in Azure

Se si abilita il debug remoto per un servizio cloud usando la procedura descritta in questa sezione, non presenta prestazioni ridotte o comporta costi aggiuntivi. Non usare il debug remoto in un servizio di produzione, perché i client che usano il servizio potrebbero essere influenzati negativamente.

Per abilitare il debug remoto per un servizio cloud (supporto esteso)

1. Aggiungere un endpoint al ServiceDefinition.csdef per la porta msvsmon predefinita. Per Visual Studio 2022, ovvero 4026; per Visual Studio 2019, è 4024.

   <Endpoints>
      <InputEndpoint name="RemoteDebug" protocol="tcp" port="4026" localPort="4026" />
   </Endpoints>
   

   Nota

   Altre versioni di Visual Studio hanno porte diverse assegnazioni di porte del debugger remoto.

2. Se si ha come destinazione .NET 4.8, assicurarsi di aprire il file ServiceConfiguration.Cloud.cscfg e controllare il valore dell'attributo osFamily nell'elemento ServiceConfiguration durante la pubblicazione di Servizi cloud (supporto esteso). Per un progetto .NET 4.8, usare osFamily="7".

3. Aprire il menu di scelta rapida per il progetto di Azure e quindi selezionare Pubblica.

4. Selezionare l'ambiente di gestione temporanea e la configurazione debug.

   Questa è solo una linea guida. È possibile scegliere di eseguire gli ambienti di test in un ambiente di produzione. Tuttavia, è possibile influire negativamente sugli utenti se si abilita il debug remoto nell'ambiente di produzione. È possibile scegliere la configurazione di rilascio, ma la configurazione di debug semplifica il debug.

   

5. Seguire i normali passaggi descritti in Servizi cloud (supporto esteso), ma selezionare la casella di controllo Abilita Desktop remoto per tutti i ruoli.

   Verrà chiesto di creare un nome utente e una password per l'utente desktop remoto, che sarà necessario in un secondo momento per accedere a tale macchina virtuale.

6. Passare alla schermata successiva, esaminare le impostazioni e, quando si è pronti, fare clic su Pubblica e attendere il completamento della distribuzione.

7. Accedere a portale di Azure e passare al servizio cloud (supporto esteso) di cui si vuole eseguire il debug.

8. Scegliere Ruoli e Istanze nel riquadro sinistro, quindi scegliere il ruolo di cui si è interessati per eseguire il debug in remoto.

9. Fare clic su Connetti nella finestra popup Istanza del ruolo a destra e scegliere il pulsante Connetti per scaricare un file desktop remoto che consentirà di accedere alla macchina virtuale. Accedi usando le credenziali create in un passaggio precedente quando è stato abilitato il desktop remoto.

   

10. Nella macchina virtuale di Azure remota installare gli strumenti remoti di Visual Studio 2022, come descritto in Debug remoto.

11. Dal desktop nella macchina virtuale eseguire il comando msvsmon.exe nella cartella di installazione di Visual Studio in Common7\IDE\Remote Debugger\x64. Assicurarsi di eseguire come amministratore.

12. Accettare le richieste per consentire l'accesso tramite il firewall. Verrà visualizzato un messaggio che indica che msvsmon.exe ha iniziato ad ascoltare le connessioni.

    

13. Nel portale di Azure aprire il gruppo di risorse e ottenere l'indirizzo IP pubblico per il servizio cloud (supporto esteso).

    

Per collegare il debugger a un servizio cloud (supporto esteso) in Azure

Nota

Quando possibile, è consigliabile eseguire il debug con la configurazione debug scelta nel processo di pubblicazione , tuttavia, se si esegue il debug di una configurazione versione, in Visual Studio usare CTRL+Q per cercare "Just My Code" e deselezionare Abilita Just My Code in Tools>Opzioni>Debugger>Generale. Le build di rilascio sono ottimizzate e pertanto non sono considerate "Codice personale".

1. Scegliere Debug>Attacca al processo (o premere Ctrl+Alt+P).

2. Mantenere il tipo di connessione predefinito .

3. Immettere la destinazione di connessione usando l'indirizzo IP e la porta: {ipaddress}:4026.

4. Impostare Collega a su automatico.

5. Accedere usando le stesse credenziali dell'utente desktop remoto.

6. Selezionare Mostra processo per tutti gli utenti. Se si esegue il debug di un ruolo di lavoro, connettersi a WaWorkerHost.exe; se si esegue il debug di un ruolo Web, connettersi al processo w3wp.exe; per un ruolo API Web, è WaIISHost.exe.

7. Impostare i punti di interruzione (passare alla riga e premere F9), accedere all'URL pubblico del sito e riprodurre lo scenario per il debug.

Debug del servizio app di Azure

È possibile eseguire il debug di programmi eseguiti nel servizio app di Azure usando la finestra di dialogo Connetti a processo in Visual Studio.

Nota

Questa opzione è disponibile solo per il servizio app di Azure a partire da Visual Studio 2022 17.1.

Per eseguire il debug di un servizio app di Windows Azure

1. In Debug, selezionare Collega a un processo.

2. Modificare Tipo di connessione in Microsoft Azure App Services, quindi selezionare Trova..

3. Nella finestra di dialogo visualizzata selezionare il nome della sottoscrizione .

   

   Nota

   È necessario accedere a un account Microsoft con accesso alla sottoscrizione che contiene il servizio app di Azure.

4. Filtrare la vista in base al gruppo di risorse o al tipo di risorsa oppure cercare in base al nome.

5. Selezionare quindi il servizio app di cui eseguire il debug e quindi selezionare Ok.

   In questo modo è possibile eseguire il debug remoto nel servizio app e viene visualizzato un elenco di processi disponibili a cui connettersi.

   

6. Selezionare il processo a cui si vuole connettersi e quindi scegliere Collega per avviare il debug.

Contenuto correlato

• Usare diagnostica di Azure per registrare informazioni dettagliate dal codice in esecuzione all'interno dei ruoli in Azure. Vedere Raccolta dei dati di registrazione tramite Diagnostica di Azure.

• Per altri scenari di debug remoto, vedere Debug remoto.