Guida introduttiva: Distribuire un'app Web ASP.NET

Se Visual Studio 2022 è già stato installato:

1. Installare gli aggiornamenti più recenti in Visual Studio selezionando ?>Controlla aggiornamenti.
2. Aggiungere il carico di lavoro selezionando Strumenti>Ottieni strumenti e funzionalità.

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
• Visual Studio Code.
• Estensione Strumenti di Azure.
• Versione più recente di .NET 8.0 SDK.
• (Facoltativo) Per provare GitHub Copilot, un account GitHub Copilot. È disponibile una versione di valutazione gratuita di 30 giorni.

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
• Interfaccia della riga di comando di Azure.
• Versione più recente di .NET 8.0 SDK.
• (Facoltativo) Per provare GitHub Copilot, un account GitHub Copilot. È disponibile una versione di valutazione gratuita di 30 giorni.

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
• Azure PowerShell.
• Versione più recente di .NET 8.0 SDK.

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
• Un account GitHub Creare gratuitamente un account.

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
• Azure Developer CLI
• Versione più recente di .NET 8.0 SDK.

1. Creare un'app Web ASP.NET

1. Inizializzare il modello di app Web ASP.NET

1. Aprire una finestra del terminale nel computer in una directory di lavoro. Creare una nuova app Web .NET usando il comando dotnet new webapp e quindi modificare le directory nell'app appena creata.

   dotnet new webapp -n MyFirstAzureWebApp --framework net8.0
   cd MyFirstAzureWebApp
   

2. Dalla stessa sessione del terminale eseguire l'applicazione in locale usando il comando dotnet run.

   dotnet run --urls=https://localhost:5001/
   

3. Aprire un Web browser e passare all'app all'indirizzo https://localhost:5001.

   Nella pagina verrà visualizzato il modello di app Web ASP.NET Core 8.0.

   

In questo passaggio si crea una copia tramite fork di un progetto demo da distribuire.

Questa guida introduttiva usa Azure Developer CLI (azd) per creare le risorse di Azure e distribuirvi il codice. Per altre informazioni su Azure Developer CLI, vedere la documentazione o il percorso di formazione.

Recuperare e inizializzare il modello di app Web ASP.NET Core per questa guida introduttiva seguendo questa procedura:

1. Aprire una finestra del terminale nel computer in una directory di lavoro vuota. Inizializzare il modello azd usando il comando azd init.

   azd init --template https://github.com/Azure-Samples/quickstart-deploy-aspnet-core-app-service.git
   

   Quando viene richiesto un nome di ambiente, immettere dev.

2. Dalla stessa sessione del terminale eseguire l'applicazione in locale usando il comando dotnet run. Usare il parametro --project per specificare la directory src del modello azd, ovvero la posizione in cui risiede il codice dell'applicazione.

   dotnet run --project src --urls=https://localhost:5001/
   

3. Aprire un Web browser e passare all'app all'indirizzo https://localhost:5001. Il modello di app Web core 8.0 di ASP.NET viene visualizzato nella pagina.

   

1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto MyFirstAzureWebApp e scegliere Pubblica.

2. In Pubblica selezionare Azure e quindi Avanti.

   

3. Scegliere la Destinazione specifica, Servizio app di Azure (Linux) o Servizio app di Azure (Windows). Quindi seleziona Avanti.

   Importante

   Per ASP.NET Framework 4.8, usare Servizio app di Azure (Windows).

4. Le opzioni disponibili variano a seconda che sia già stato eseguito l'accesso ad Azure e che si abbia un account di Visual Studio collegato a un account di Azure. Selezionare Aggiungi un account o Accedi per accedere alla sottoscrizione di Azure. Se è già stato effettuato l'accesso, selezionare l'account da usare.

   

5. A destra di Istanze del servizio app selezionare +.

   

6. Per Sottoscrizione, accettare la sottoscrizione elencata o sceglierne una nuova nell'elenco a discesa.

7. Per Gruppo di risorse selezionare Nuovo. In Nome nuovo gruppo di risorse immettere myResourceGroup e scegliere OK.

8. Per Piano di hosting selezionare Nuovo.

9. Nella finestra di dialogo Piano di hosting: Crea nuovo immettere i valori specificati nella tabella seguente:

   Impostazione	Valore suggerito	Descrizione
   Piano di hosting	MyFirstAzureWebAppPlan	Nome del piano di servizio app.
   Location	Europa occidentale	Data center in cui è ospitata l'app Web.
   Dimensione	Scegliere il livello più basso.	Ipiani tariffari definiscono le funzionalità di hosting.

10. In Nome immettere un nome univoco per l'app che includa solo i caratteri validi, ossia a-z, A-Z, 0-9 e -. È possibile accettare il nome univoco generato automaticamente. L'URL dell'app Web è http://<app-name>.azurewebsites.net, dove <app-name> è il nome dell'app.

11. Selezionare Crea per creare le risorse di Azure.

    

    Al termine della procedura guidata, le risorse di Azure vengono create automaticamente e si è pronti per pubblicare il progetto ASP.NET Core.

12. Nella finestra di dialogo Pubblica verificare che la nuova app del servizio app sia selezionata, quindi selezionare Fine e poi Chiudi. Visual Studio crea automaticamente un profilo di pubblicazione per l'app del servizio app selezionata.

13. Nella pagina Pubblica selezionare Pubblica. Se viene visualizzato un messaggio di avviso, selezionare Continua.

    Visual Studio compila, crea il pacchetto e pubblica l'app in Azure, quindi la avvia nel browser predefinito.

    • .NET 8.0
    • .NET Framework 4.8

    Nella pagina viene visualizzata l'app Web ASP.NET Core 8.0.

    

1. Aprire Visual Studio Code dalla directory radice del progetto.

   code .
   

2. Se richiesto, selezionare Sì, considerare attendibili gli autori.

   Suggerimento

   Se si ha un account GitHub Copilot, provare a ottenere le funzionalità di GitHub Copilot per Visual Studio Code.

3. In Visual Studio Code aprire il riquadro comandi selezionando Visualizza>Riquadro comandi.

4. Cercare e selezionare "Servizio app di Azure: Crea nuova app Web (Avanzate)".

5. Rispondere alle richieste come segue:

   1. Se richiesto, accedere all'account di Azure.
   2. Selezionare la propria sottoscrizione.
   3. Selezionare Crea una nuova app Web... Avanzate.
   4. Per Immettere un nome univoco globale, usare un nome univoco in tutto Azure (i caratteri validi sono a-z, 0-9, e -). Un criterio valido consiste nell'usare una combinazione del nome della società e di un identificatore dell'app.
   5. Selezionare Crea nuovo gruppo di risorse e specificare un nome, ad esempio myResourceGroup.
   6. Quando viene richiesto di Selezionare uno stack di runtime, selezionare .NET 8 (LTS).
   7. Selezionare un sistema operativo (Windows o Linux).
   8. Selezionare una località nelle vicinanze.
   9. Selezionare Crea nuovo piano servizio app, specificare un nome e selezionare il piano tariffario Gratuito (F1).
   10. Per la risorsa di Application Insight, selezionare Ignora per adesso.
   11. Quando richiesto, selezionare Distribuisci.
   12. Selezionare MyFirstAzureWebApp come cartella per la distribuzione.
   13. Selezionare Aggiungi configurazione quando richiesto.

6. Nella finestra popup Distribuire sempre l'area di lavoro "MyFirstAzureWebApp" in <nome app>", selezionare Sì in modo che Visual Studio Code venga distribuito nella stessa app del servizio app ogni volta che si è in tale area di lavoro.

7. Al termine della pubblicazione, selezionare Esplora sito Web nella notifica e selezionare Apri quando richiesto.

   Nella pagina viene visualizzata l'app Web ASP.NET Core 8.0.

   

1. Accedere all'account Azure usando il comando az login e seguendo il prompt:

   az login
   

   • Se il comando az non è riconosciuto, assicurarsi di aver installato l'interfaccia della riga di comando di Azure come descritto in Prerequisiti.

2. Distribuire il codice nella directory locale MyFirstAzureWebApp usando il comando az webapp up :

   az webapp up --sku F1 --name <app-name> --os-type <os>
   

   • Sostituire <app-name> con un nome univoco nell'ambito di Azure (i caratteri validi sono a-z, 0-9 e -). Un criterio valido consiste nell'usare una combinazione del nome della società e di un identificatore dell'app.
   • L'argomento --sku F1 crea l'app Web nel piano tariffario Gratuito. Omettere questo argomento per usare un livello Premium più rapido, che però comporta un costo orario.
   • Sostituire <os> con linux o windows.
   • Facoltativamente, è possibile includere l'argomento --location <location-name>, dove <location-name> è un'area di Azure disponibile. Per recuperare un elenco di aree consentite per l'account Azure, è possibile eseguire il comando az account list-locations.

   Il completamento del comando può richiedere alcuni minuti. Durante l'esecuzione, il comando fornisce messaggi sulla creazione del gruppo di risorse, sul piano di servizio app e l'app di hosting, la configurazione della registrazione e quindi la distribuzione dello ZIP. Viene quindi visualizzato un messaggio con l'URL dell'app:

   You can launch the app at http://<app-name>.azurewebsites.net
   

3. Aprire un Web browser e passare all'URL:

   Nella pagina viene visualizzata l'app Web ASP.NET Core 8.0.

   

1. Accedere all'account Azure usando il comando Connect-AzAccount e seguendo il prompt:

   Connect-AzAccount
   

2. Creare una nuova app usando il comando New-AzWebApp:

   New-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -Location westeurope
   

   • Sostituire <app-name> con un nome univoco nell'ambito di Azure (i caratteri validi sono a-z, 0-9 e -). Un criterio valido consiste nell'usare una combinazione del nome della società e di un identificatore dell'app.
   • Facoltativamente, è possibile includere il parametro -Location <location-name>, dove <location-name> è un'area di Azure disponibile. Per recuperare un elenco di aree consentite per l'account Azure, è possibile eseguire il comando Get-AzLocation.

   Il completamento del comando può richiedere alcuni minuti. Durante l'esecuzione, il comando crea un gruppo di risorse, un piano di servizio app e la risorsa Servizio app.

3. Dalla cartella radice dell'applicazione preparare l'applicazione locale MyFirstAzureWebApp per la distribuzione usando il comando dotnet publish:

   dotnet publish --configuration Release
   

4. Passare alla directory di versione e creare un file ZIP dal contenuto:

   cd bin\Release\net8.0\publish
   Compress-Archive -Path * -DestinationPath deploy.zip
   

5. Pubblicare il file ZIP nell'app Azure usando il comando Publish-AzWebApp:

   Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
   

   Nota

   -ArchivePath richiede il percorso completo del file ZIP.

6. Aprire un Web browser e passare all'URL:

   Nella pagina viene visualizzata l'app Web ASP.NET Core 8.0.

   

1. Digitare Servizi app nella casella dii ricerca. In Servizi, selezionare Servizi app.

   

2. Nella pagina Servizi app selezionare Crea>App Web.

3. Nella scheda Informazioni di base:

   • .NET 8.0
   • .NET Framework 4.8

   • In Gruppo di risorse selezionare Crea nuovo. Per il nome digitare myResourceGroup.
   • In Nome, digitare un nome univoco globale per l'app Web.
   • In Pubblica, selezionare Codice.
   • In Stack di runtime selezionare .NET 8 (LTS).
   • Per Sistema operativo selezionare Windows. Se si seleziona Linux, non è possibile configurare la distribuzione di GitHub nel passaggio successivo, ma è comunque possibile farlo dopo aver creato l'app nella pagina Centro distribuzione.
   • Selezionare un'Area da cui si vuole gestire l'app.
   • In Piano di servizio app selezionare Crea nuovo e digitare myAppServicePlan per il nome.
   • In Piano tariffario selezionare F1 gratuito.

   

4. Selezionare la scheda Distribuzione nella parte superiore della pagina

5. In impostazioni di GitHub Actions impostare distribuzione continua su Abilita.

6. In Dettagli di GitHub Actions eseguire l'autenticazione con l'account GitHub e selezionare le opzioni seguenti:

   • .NET 8.0
   • .NET Framework 4.8

   • Per Organizzazione selezionare l'organizzazione in cui è stato creato il fork del progetto demo.
   • Per Repository selezionare il progetto dotnetcore-docs-hello-world.
   • Per Ramo selezionare principale.

   

   Nota

   Per impostazione predefinita, la procedura guidata per la creazione disabilita l'autenticazione di base e la distribuzione di GitHub Actions viene creata usando un'identità assegnata dall'utente. Se durante la creazione della risorsa si riceve un errore di autorizzazione, l'account Azure potrebbe non disporre di autorizzazioni sufficienti. È possibile configurare la distribuzione di GitHub Actions in un secondo momento con un'identità generata automaticamente da un amministratore di Azure, o in alternativa è anche possibile abilitare l'autenticazione di base.

7. Selezionare quindi il pulsante Rivedi e crea nella parte inferiore della pagina.

8. Dopo l'esecuzione della convalida, seleziona il pulsante Create in fondo alla pagina.

9. Al termine della distribuzione, selezionare Vai alla risorsa.

   

10. Passare all'applicazione distribuita nel Web browser all'URL http://<app-name>.azurewebsites.net. Se viene visualizzato il messaggio "L'app Web è in esecuzione e in attesa del contenuto", la distribuzione di GitHub è ancora in esecuzione. Attendere un paio di minuti e aggiornare la pagina.

    • .NET 8.0
    • .NET Framework 4.8

    

Il modello AZD contiene file che generano le risorse necessarie seguenti per l'esecuzione dell'applicazione nel servizio app:

• Un nuovo gruppo di risorse che conterrà tutte le risorse di Azure per il servizio.
• Un nuovo Piano di servizio app che specifica la località, le dimensioni e le funzionalità della server farm Web che ospita l'app.
• Nuova istanza di App del servizio app per eseguire l'applicazione distribuita.

1. Accedere all'account Azure usando il comando azd auth login e seguendo il prompt:

   azd auth login
   

2. Creare le risorse di Azure e distribuire l'app usando il comando azd up:

   azd up
   

   Il completamento del comando azd up potrebbe richiedere alcuni minuti. azd up usa i file Bicep nei progetti per creare il gruppo di risorse, il piano di servizio app e l'app di hosting. Esegue anche determinate configurazioni, ad esempio l'abilitazione della registrazione e la distribuzione del codice dell'app compilato. Durante l'esecuzione, il comando fornisce messaggi sul processo di provisioning e distribuzione, incluso un collegamento alla distribuzione in Azure. Al termine, il comando visualizza anche un collegamento all'applicazione di distribuzione.

3. Aprire un Web browser e passare all'URL:

   Nella pagina viene visualizzata l'app Web ASP.NET Core 8.0.

   

1. Nel progetto in Esplora soluzioni aprire Index.cshtml.

2. Sostituire il primo elemento <div> con il codice seguente:

   <div class="jumbotron">
       <h1>.NET 💜 Azure</h1>
       <p class="lead">Example .NET app to Azure App Service.</p>
   </div>
   

   Suggerimento

   Con GitHub Copilot abilitato in Visual Studio, provare a eseguire le operazioni seguenti:

   1. Selezionare l'elemento <div> e digitare Alt+/.
   2. Chiedere a Copilot: "Passa a una scheda Bootstrap che indica .NET 💜 Azure".

   Salva le modifiche.

3. Per la ridistribuzione in Azure, fare clic con il pulsante destro del mouse sul progetto MyFirstAzureWebApp in Esplora soluzioni e scegliere Pubblica.

4. Nella pagina di riepilogo Pubblica selezionare Pubblica.

   Al termine del processo di pubblicazione, Visual Studio avvia un browser sull'URL dell'app Web.

   • .NET 8.0
   • .NET Framework 4.8

   Nella pagina viene visualizzata l'app Web ASP.NET Core 8.0 aggiornata.

   

1. Aprire Pages/Index.cshtml.

2. Sostituire il primo elemento <div> con il codice seguente:

   <div class="jumbotron">
       <h1>.NET 💜 Azure</h1>
       <p class="lead">Example .NET app to Azure App Service.</p>
   </div>
   

   Suggerimento

   Provare a usare GitHub Copilot:

   1. Selezionare l'intero elemento <div> e fare clic su .
   2. Chiedere a Copilot: "Passa a una scheda Bootstrap che indica .NET 💜 Azure".

   Salva le modifiche.

3. In Visual Studio Code aprire il Riquadro comandi, CTRL+MAIUSC+P.

4. Cercare e selezionare "Servizio app di Azure: Distribuisci nell'app Web".

5. Selezionare la sottoscrizione e l'app Web usata in precedenza.

6. Quando richiesto, selezionare Distribuisci.

7. Al termine della pubblicazione, selezionare Esplora sito Web nella notifica.

   Nella pagina viene visualizzata l'app Web ASP.NET Core 8.0 aggiornata.

   

Nella directory locale aprire il file Pages/Index.cshtml. Sostituire il primo elemento <div>:

<div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

Salvare le modifiche, quindi ridistribuire l'app usando di nuovo il comando az webapp up e sostituire <os> con linux o windows.

az webapp up --os-type <os>

Questo comando usa i valori memorizzati nella cache in locale nel file .azure/config, inclusi il nome dell'app, il gruppo di risorse e il piano di servizio app.

Al termine della distribuzione, tornare alla finestra del browser aperta nel passaggio Passare all'app e fare clic su Aggiorna.

Nella pagina viene visualizzata l'app Web ASP.NET Core 8.0 aggiornata.

1. Nella directory locale aprire il file Pages/Index.cshtml. Sostituire il primo elemento <div>:

   <div class="jumbotron">
       <h1>.NET 💜 Azure</h1>
       <p class="lead">Example .NET app to Azure App Service.</p>
   </div>
   

2. Dalla cartella radice dell'applicazione preparare l'applicazione locale MyFirstAzureWebApp per la distribuzione usando il comando dotnet publish:

   dotnet publish --configuration Release
   

3. Passare alla directory di versione e creare un file ZIP dal contenuto:

   cd bin\Release\net8.0\publish
   Compress-Archive -Path * -DestinationPath deploy.zip
   

4. Pubblicare il file ZIP nell'app Azure usando il comando Publish-AzWebApp:

   Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
   

   Nota

   -ArchivePath richiede il percorso completo del file ZIP.

5. Al termine della distribuzione, tornare alla finestra del browser aperta nel passaggio Passare all'app e fare clic su Aggiorna.

   Nella pagina viene visualizzata l'app Web ASP.NET Core 8.0 aggiornata.

   

1. Passare alla copia tramite fork GitHub del codice di esempio.

2. Nella pagina del repository creare un codespace selezionando Code>Create codespace on main.

   • .NET 8.0
   • .NET Framework 4.8

   

   Suggerimento

   Se si ha un account GitHub Copilot, provare a ottenere le funzionalità di GitHub Copilot nel codespace.

3. Aprire Index.cshtml.

   • .NET 8.0
   • .NET Framework 4.8

   Il file Index.cshtml si trova nella cartella Pages.

   

4. Sostituire il primo elemento <div> con il codice seguente:

   <div class="jumbotron">
       <h1>.NET 💜 Azure</h1>
       <p class="lead">Example .NET app to Azure App Service.</p>
   </div>
   

   Le modifiche vengono salvate automaticamente.

   Suggerimento

   Provare a usare GitHub Copilot:

   1. Selezionare l'intero elemento <div> e fare clic su .
   2. Chiedere a Copilot: "Passa a una scheda Bootstrap che indica .NET 💜 Azure".

5. Dal menu Controllo del codice sorgente immettere un messaggio di commit, ad esempio Modify homepage. Selezionare quindi Commit e confermare la gestione temporanea delle modifiche selezionando Sì.

   • .NET 8.0
   • .NET Framework 4.8

   

   Suggerimento

   Consentire a GitHub Copilot di creare automaticamente un messaggio di commit selezionando nella finestra di messaggio.

6. Selezionare Sincronizza modifiche 1, quindi confermare selezionando OK.

7. L'esecuzione della distribuzione richiede alcuni minuti. Per visualizzare lo stato di avanzamento, passare a https://github.com/<your-github-alias>/dotnetcore-docs-hello-world/actions.

8. Tornare alla finestra del browser aperta durante il passaggio Passare all'app e aggiornare la pagina.

   • .NET 8.0
   • .NET Framework 4.8

   Nella pagina viene visualizzata l'app Web ASP.NET Core 8.0 aggiornata.

   

Nella directory locale aprire il file src/Pages/Index.cshtml. Sostituire il primo elemento <div>:

<div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

Salvare le modifiche, quindi ridistribuire l'app usando di nuovo il comando azd up:

azd up

azd up ignora il passaggio di provisioning delle risorse questa volta e ridistribuisce solo il codice, poiché non sono state apportate modifiche ai file Bicep.

Al termine della distribuzione, il browser si apre all'app Web ASP.NET Core 8.0 aggiornata.

Pulire le risorse

Nei passaggi precedenti sono state create risorse di Azure in un gruppo di risorse. Se non si prevede di aver bisogno di queste risorse in futuro, è possibile eliminarle eliminando il gruppo di risorse.

1. Dalla pagina Panoramica dell'app Web nel portale di Azure selezionare il collegamento myResourceGroup in Gruppo di risorse.
2. Nella pagina del gruppo di risorse assicurarsi che le risorse elencate siano quelle da eliminare.
3. Selezionare Elimina gruppo di risorse, digitare myResourceGroup nella casella di testo e quindi selezionare Elimina.
4. Confermare di nuovo selezionando Elimina.

Pulire le risorse

Nei passaggi precedenti sono state create risorse di Azure in un gruppo di risorse. Se non si prevede di aver bisogno di queste risorse in futuro, è possibile eliminarle eliminando il gruppo di risorse.

1. Dalla pagina Panoramica dell'app Web nel portale di Azure selezionare il collegamento myResourceGroup in Gruppo di risorse.
2. Nella pagina del gruppo di risorse assicurarsi che le risorse elencate siano quelle da eliminare.
3. Selezionare Elimina gruppo di risorse, digitare myResourceGroup nella casella di testo e quindi selezionare Elimina.
4. Confermare di nuovo selezionando Elimina.

Nei passaggi precedenti sono state create risorse di Azure in un gruppo di risorse. Se si ritiene che queste risorse non saranno necessarie in futuro, eliminare il gruppo di risorse eseguendo questo comando in Cloud Shell:

az group delete

Per praticità, il comando az webapp up eseguito in precedenza in questo progetto salva il nome del gruppo di risorse come valore predefinito ogni volta che si eseguono comandi az da questo progetto.

Pulire le risorse

Nei passaggi precedenti sono state create risorse di Azure in un gruppo di risorse. Se non si prevede di usare queste risorse in futuro, eliminare i gruppi di risorse eseguendo questo comando PowerShell:

Remove-AzResourceGroup -Name myResourceGroup

L'esecuzione del comando può richiedere un minuto.

Pulire le risorse

Nei passaggi precedenti sono state create risorse di Azure in un gruppo di risorse. Se non si prevede di aver bisogno di queste risorse in futuro, è possibile eliminarle eliminando il gruppo di risorse.

1. Dalla pagina Panoramica dell'app Web nel portale di Azure selezionare il collegamento myResourceGroup in Gruppo di risorse.
2. Nella pagina del gruppo di risorse assicurarsi che le risorse elencate siano quelle da eliminare.
3. Selezionare Elimina gruppo di risorse, digitare myResourceGroup nella casella di testo e quindi selezionare Elimina.
4. Confermare di nuovo selezionando Elimina.

Pulire le risorse

Usare il comando azd down per rimuovere il gruppo di risorse e tutte le risorse correlate:

azd down

Per i passaggi successivi sull'uso dei modelli di azd e altre funzionalità, vedere la documentazione di Azure Developer CLI.