Eseguire e sottoporre a debug le app abilitate per Azure Developer CLI

Eseguire ed eseguire il debug di app nel computer locale usando l'estensione Visual Studio Code per l'interfaccia della riga di comando per sviluppatori di Azure (azd). In questa guida si userà l'app Web React con l'API Node.js e il modello MongoDB in Azure . È possibile applicare i principi appresi in questo articolo a uno dei modelli dell'interfaccia della riga di comando per sviluppatori di Azure.

Prerequisiti

Installare l'estensione Visual Studio Code per l'interfaccia della riga di comando per sviluppatori di Azure

Tramite Visual Studio Code

  1. Aprire Visual Studio Code.

  2. Scegliere Estensioni dal menu Visualizza.

  3. Nel campo di ricerca immettere Azure Developer CLI.

  4. Selezionare Installa.

Tramite Marketplace

  1. Usando il browser passare alla pagina Dell'interfaccia della riga di comando per sviluppatori di Azure - Estensione VS Code.

  2. Selezionare Installa.

Inizializzare una nuova app

  1. Creare e aprire una nuova directory in Visual Studio Code.

  2. Scegliere Riquadro comandi dal menu Visualizza.

  3. Digitare e selezionare Azure Developer: init.

    Screenshot of the option to initialize a new app.

  4. Selezionare il modello Azure-Samples/todo-nodejs-mongo.

    Screenshot of selecting the todo-nodejs-mongo sample template.

Esplorare i file seguenti inclusi nella .vscode directory:

File Descrizione
launch.json Definisce le configurazioni di debug, ad esempio Debug Web e Debug API. per visualizzare le opzioni di configurazione di debug, selezionare Esegui dal menu Visualizza . Le configurazioni di debug disponibili sono elencate nella parte superiore del riquadro. Per altre informazioni sul debug in Visual Studio Code, vedere Debug.
tasks.json Definisce le configurazioni per avviare il server Web o API. Per visualizzare queste opzioni di configurazione, aprire il riquadro comandi ed eseguire l'attività Task: run. Per altre informazioni sulle attività di Visual Studio Code, vedere Integrare con strumenti esterni tramite attività.

Nota

Se si usa il modello MS SQL SWA-func C#, è necessario avviare manualmente l'attività Start API e quindi Eseguire il debug dell'API (F5). Quando viene chiesto di scegliere da un elenco di processi .NET in esecuzione, cercare il nome dell'applicazione e selezionarlo.

provisioning delle risorse di Azure

Prima di avviare il debug, effettuare il provisioning delle risorse di Azure necessarie.

  1. Aprire il riquadro comandi.

  2. Immettere Sviluppatori di Azure: effettuare il provisioning delle risorse di Azure.

    Screenshot of option to provision the Azure resources for a new app.

Eseguire il debug di un'API

L'API debug della configurazione di debug esegue automaticamente il server API e collega il debugger. Per testare questo modello, seguire questa procedura:

  1. Dalla directory del src/api/src/routes progetto aprire lists.ts.

  2. Impostare un punto di interruzione alla riga 16.

  3. Nella barra delle attività selezionare Esegui ed esegui debug configurazione debug>dell'API >Avvia debug freccia.

    Screenshot of setting the debug configuration to Debug API.

  4. Scegliere Console di debug dal menu Visualizza.

  5. Attendere il messaggio che indica che il debugger è in ascolto sulla porta 3100.

    Screenshot of the message in the Debug Console indicating the debugger is listening on port 3100.

  6. Nella shell del terminale preferito immettere il comando seguente: curl http://localhost:3100/lists

    Screenshot of using cURL to connect to the API server.

  7. Quando viene raggiunto il punto di interruzione impostato in precedenza, l'esecuzione dell'app verrà sospesa. A questo punto, è possibile eseguire attività di debug standard, ad esempio:

    • Esame delle variabili
    • Esaminare lo stack di chiamate
    • Impostare altri punti di interruzione.
  8. Premere <F5> per continuare a eseguire l'app. L'app di esempio restituisce un elenco vuoto.

Eseguire il debug di un'app Front-end React

Per usare la configurazione Web di debug, è necessario avviare entrambe le operazioni:

  • Server API
  • Server Web di sviluppo

Per testare questo modello, seguire questa procedura:

  1. Aprire il riquadro comandi ed eseguire l'attività Task: Esegui.

    Screenshot of running a Visual Studio Code Task.

  2. Immettere e selezionare Avvia API e Web

    Screenshot of selecting the option to Start API and Web.

    È possibile verificare se il server Web locale è in esecuzione passando all'URL seguente in un Web browser: http://localhost:3000.

  3. Nella directory del src/web/src/components progetto aprire todoItemListPane.tsx.

  4. Impostare un punto di interruzione sulla riga 150 (la prima riga della deleteItems funzione).

  5. Nella barra delle attività selezionare Esegui ed esegui debug debug configurazione debug>Web > la freccia Avvia debug.

    Screenshot of setting the debug configuration to Debug Web.

  6. Se si esegue l'app Web, il browser predefinito aprirà l'URL seguente: http://localhost:3000. È ora possibile eseguire il debug dell'app aggiungendo un elemento, selezionandolo dall'elenco e selezionando Elimina.

    Screenshot of the sample Node JS Mongo DB app.

  7. Quando viene raggiunto il punto di interruzione impostato in precedenza, l'esecuzione dell'app verrà sospesa. A questo punto, è possibile eseguire attività di debug standard, ad esempio:

    • Esame delle variabili
    • Esaminare lo stack di chiamate
    • Impostare altri punti di interruzione
  8. Premere <F5> per continuare a eseguire l'app e l'elemento selezionato verrà eliminato.

Eseguire ed eseguire il debug di app basate sul computer locale usando Visual Studio e l'interfaccia della riga di comando per sviluppatori di Azure (azd). In questa guida si userà il modello React Web App con l'API C# e MongoDB in Azure . È possibile applicare i principi appresi in questo articolo a uno dei modelli dell'interfaccia della riga di comando per sviluppatori di Azure.

Prerequisiti

Installare e abilitare la funzionalità di anteprima

  1. Installare Visual Studio Preview

    Nota

    Questo è diverso da Visual Studio. Se si dispone della versione non di anteprima di Visual Studio, è comunque necessario installarla.

  2. Aprire Visual Studio Preview.

  3. Dal menu Strumenti selezionare Opzioni>Funzionalità di anteprima.

  4. Assicurarsi che l'integrazione con azd, l'interfaccia della riga di comando per sviluppatori di Azure sia abilitata.

    Screenshot of the Visual Studio option to turn on integration with the Azure Developer CLI.

Aprire la soluzione API

  1. Aprire la Todo.Api.sln soluzione nella /src/api directory .

    Se è stata abilitata la azd funzionalità di integrazione, il azure.yaml file viene rilevato. Visual Studio inizializza automaticamente il modello di app ed esegue azd env refresh.

  2. Espandere servizi Connessione ed per visualizzare tutte le dipendenze.

    Anche se il front-end Web in esecuzione in app Azure Servizio non fa parte della soluzione API, viene rilevato e incluso in Dipendenze del servizio

    Screenshot of the message indicating the Azure Developer CLI is initialized.

Eseguire ed eseguire il debug

  1. Dalla directory del src/api progetto aprire ListController.cs.

  2. Impostare un punto di interruzione alla riga 20.

    Screenshot of the breakpoint set in the sample code.

  3. Premere <F5>.

  4. Attendere il messaggio che indica che il server Web è in ascolto sulla porta 3101.

    Screenshot of the status bar message indicating the debugger is listening on port 3101.

  5. Nel browser preferito immettere l'indirizzo seguente: https://localhost:3101/lists

  6. Quando viene raggiunto il punto di interruzione impostato in precedenza, l'esecuzione dell'app verrà sospesa. A questo punto, è possibile eseguire attività di debug standard, ad esempio:

    • Esame delle variabili
    • Esaminare lo stack di chiamate
    • Impostare altri punti di interruzione
  7. Premere <F5> per continuare a eseguire l'app.

    L'app di esempio restituisce un elenco (o un elenco vuoto [] se non è stato avviato il front-end Web in precedenza):

    [{"id":"fb9c1cb3811349b993421fc0e815c4c1","name":"My List","description":null,"createdDate":"2022-06-27T01:10:16.7721172+00:00","updatedDate":null}]
    

Altre azd integrazioni

Gestire l'ambiente azd

Per gestire l'ambiente azd :

  1. Selezionare ... nell'angolo superiore destro del riquadro Dipendenze del servizio.

  2. Selezionare una delle opzioni seguenti nel menu a discesa:

    • Creazione di un nuovo ambiente
    • Selezionare e impostare un ambiente specifico come ambiente attivo corrente
    • Eseguire il deprovisioning di un ambiente

    Screenshot of the options to manage the Azure Developer CLI environment in Visual Studio.

Effettuare il provisioning delle risorse dell'ambiente

È possibile effettuare il provisioning delle risorse di Azure nell'ambiente.

  1. In servizi Connessione ed fare clic sull'icona in alto a destra per ripristinare/effettuare il provisioning delle risorse dell'ambiente.

    Screenshot of option to provision Azure Developer CLI environment resources in Visual Studio.

  2. Confermare il nome dell'ambiente, la sottoscrizione e il percorso.

Pubblicare l'app

Se si apportano aggiornamenti, è possibile pubblicare l'app seguendo questa procedura:

  1. Nella Esplora soluzioni espandere Servizi Connessione ed.

  2. Seleziona Pubblica.

  3. Selezionare Aggiungi un profilo di pubblicazione.

  4. Selezionare una destinazione di Azure e selezionare Avanti.

  5. Selezionare Ambiente dell'interfaccia della riga di comando per sviluppatori di Azure e selezionare Avanti.

    Screenshot of message in Debug Console indicating debugger is listening on port 3100.

  6. Seleziona l'ambiente.

  7. Selezionare Fine.

Altre risorse

Richiedere assistenza

Per informazioni su come inviare un bug, richiedere assistenza o proporre una nuova funzionalità per l'interfaccia della riga di comando per sviluppatori di Azure, visitare la pagina relativa alla risoluzione dei problemi e al supporto tecnico.

Passaggi successivi