Esercitazione: Eseguire la distribuzione in App contenitore di Azure con Visual Studio

App contenitore di Azure consente di eseguire microservizi e applicazioni containerizzate su una piattaforma serverless. Con App contenitore si possono sfruttare i vantaggi dell'esecuzione di contenitori, senza doversi preoccupare della configurazione manuale dell'infrastruttura del cloud e di agenti di orchestrazione complessi.

In questa esercitazione si distribuisce un'applicazione ASP.NET Core 10.0 in contenitori in App contenitore di Azure usando Visual Studio. I passaggi descritti di seguito si applicano anche alle versioni precedenti di ASP.NET Core.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Se non si ha un account, è possibile crearne uno gratuito.
• Visual Studio 2026 o Visual Studio 2022 versione 17.2 o successiva, disponibile come download gratuito.

Creare il progetto

Creare l'applicazione ASP.NET Core in contenitori.

1. In Visual Studio selezionare File e quindi scegliere Nuovo>Project/Soluzione.

2. Nella finestra di dialogo cercare ASP.NET, quindi scegliere ASP.NET Core'app Web e selezionare Avanti.

3. Nel campo Nome progetto assegnare all'applicazione il nome MyContainerApp e quindi selezionare Avanti.

4. Nella schermata Informazioni aggiuntive selezionare Abilita supporto contenitori. Assicurarsi che Linux sia selezionato per l'impostazione Del sistema operativo contenitore .

   

   Per questa esercitazione, usare i contenitori Linux. Questa selezione garantisce che il modello di progetto supporti la containerizzazione per impostazione predefinita. Durante l'abilitazione, il progetto usa un contenitore durante l'esecuzione o la compilazione.

5. Per Tipo di compilazione contenitore selezionare Dockerfile.

6. Selezionare Crea e Visual Studio crea e carica il progetto.

Eseguire la distribuzione in App contenitore di Azure

L'applicazione include un Dockerfile perché il modello di progetto ha selezionato l'impostazione Abilita Docker . Visual Studio usa il Dockerfile per compilare l'immagine del contenitore eseguita in App contenitore di Azure.

Per altre informazioni sulle specifiche di questo processo, vedere Personalizzare i contenitori in Visual Studio.

A questo punto, sei pronto per distribuire l'applicazione in Azure Container Apps.

Creare le risorse

Le finestre Pubblica in Visual Studio consentono di scegliere le risorse Azure esistenti o di crearne di nuove per la distribuzione. Questo processo compila anche l'immagine del contenitore, esegue il push dell'immagine in Registro Azure Container e distribuisce la nuova immagine dell'app contenitore.

1. Fare clic con il pulsante destro del mouse sul nodo del progetto MyContainerApp e scegliere Pubblica.

2. Nella finestra di dialogo scegliere Azure dall'elenco delle opzioni di pubblicazione e quindi selezionare Avanti.

   

3. Nella schermata Destinazione specifica scegliere App contenitore di Azure (Linux) e quindi selezionare Avanti.

   

4. Creare un'app contenitore Azure per ospitare il progetto. Selezionare Crea nuovo accanto all'icona verde + . Nella finestra di dialogo Crea nuovo immettere i valori seguenti:

   • Nome dell'app contenitore: Immetti un nome di msdocscontainerapp.

   • Nome sottoscrizione: scegliere la sottoscrizione per ospitare l'app.

   • Gruppo di risorse: un gruppo di risorse funge da contenitore logico per organizzare le risorse correlate in Azure. È possibile selezionare un gruppo di risorse esistente oppure selezionare Nuovo per crearne uno con un nome selezionato, ad esempio msdocscontainerapps.

   • Ambiente di app contenitore: Ogni app contenitore deve far parte di un ambiente di app contenitore. Un ambiente fornisce una rete isolata per una o più app contenitore, consentendo loro di richiamarsi facilmente tra loro. Selezionare Nuovo per aprire la finestra di dialogo per l'ambiente dell'app contenitore. Lasciare i valori predefiniti e selezionare OK per chiudere la finestra di dialogo dell'ambiente.

   • Nome del contenitore: questo valore è il nome intuitivo del contenitore in esecuzione per questa app contenitore. Usa il nome msdocscontainer1 per questa guida introduttiva rapida. Un'app per contenitori esegue in genere un solo contenitore, ma ci sono casi in cui serve più di un contenitore. Un caso del genere si verifica quando è necessario un contenitore sidecar per svolgere un’attività, ad esempio la registrazione specializzata o le comunicazioni.

     

5. Selezionare Crea per finalizzare la creazione dell'app contenitore. Visual Studio e Azure creano le risorse necessarie per conto dell'utente. Questo processo potrebbe richiedere alcuni minuti. Lasciare che venga eseguito prima di continuare.

6. Dopo aver creato le risorse, scegliere Avanti.

   

7. Nella schermata Registro di sistema è possibile selezionare un Registro di sistema esistente, se disponibile, oppure crearne uno nuovo. Per crearne uno nuovo, selezionare Crea nuovo accanto all'icona verde + . Nella schermata Crea nuovo immettere i valori seguenti:

   • Prefisso DNS: immetti un valore di msdocscontainerregistry o un nome a tua scelta.
   • Nome sottoscrizione: selezionare la sottoscrizione da usare. Potrebbe essere necessario sceglierne solo uno.
   • Gruppo di risorse: scegliere il gruppo di risorse msdocs creato in precedenza.
   • Sku: selezionare Standard.
   • Posizione del Registro di sistema: selezionare un'area geograficamente vicina all'utente.

   

8. Dopo aver popolato questi valori, selezionare Crea. Visual Studio e Azure richiedono qualche minuto per creare il Registro di sistema.

9. Dopo aver creato il registro contenitori, assicurarsi che sia selezionato e quindi scegliere Fine. Visual Studio richiede qualche minuto per creare il profilo di pubblicazione. Questo profilo di pubblicazione è la posizione in cui Visual Studio archivia le opzioni di pubblicazione e le risorse scelte in modo da poter pubblicare di nuovo rapidamente ogni volta che si desidera. È possibile chiudere la finestra di dialogo al termine.

   

Pubblicare l'app con Visual Studio

Mentre vengono create le risorse e il profilo di pubblicazione, è comunque necessario pubblicare e distribuire l'app in Azure.

Scegliere Pubblica in alto a destra nella schermata del profilo di pubblicazione per la distribuzione nell'app contenitore creata in Azure. Questo processo potrebbe richiedere qualche minuto, quindi attendere il completamento.

Al termine della distribuzione dell'app, Visual Studio apre un browser all'URL del sito distribuito. Questa pagina potrebbe inizialmente visualizzare un errore se non viene eseguito il provisioning di tutte le risorse appropriate. Aggiornare periodicamente il browser per verificare se la distribuzione viene completata completamente.

Pubblicare l'app con GitHub Actions

È anche possibile distribuire app contenitore usando CI/CD tramite GitHub Actions. GitHub Actions è uno strumento potente per automatizzare, personalizzare ed eseguire flussi di lavoro di sviluppo direttamente tramite il repository GitHub del progetto.

Se Visual Studio rileva che il progetto che si sta pubblicando è ospitato in GitHub, il flusso di pubblicazione presenta un altro passaggio Tipo di distribuzione. Questa fase consente agli sviluppatori di scegliere se pubblicare direttamente tramite Visual Studio usando i passaggi illustrati in precedenza nella guida introduttiva o tramite un flusso di lavoro di GitHub Actions.

Se si seleziona il flusso di lavoro GitHub Actions, Visual Studio crea una cartella .github nella directory radice del progetto, incluso un file YAML generato. Il file YAML contiene configurazioni di GitHub Actions per compilare e distribuire l'app in Azure ogni volta che si esegue il push del codice.

Dopo aver apportato una modifica ed eseguito il push del codice, è possibile visualizzare lo stato di avanzamento del processo di compilazione e distribuzione in GitHub nella scheda Azioni . Questa pagina fornisce log e indicatori dettagliati relativi allo stato di avanzamento e all'integrità del flusso di lavoro.

Il flusso di lavoro è completo quando viene visualizzato un segno di spunta verde accanto ai processi di compilazione e distribuzione. Quando accedi al sito di Container Apps, dovresti visualizzare le modifiche più recenti. È sempre possibile trovare l'URL per l'app contenitore usando la pagina portale di Azure.

Pulire le risorse

Se non si prevede di usare questa applicazione, è possibile eliminare l'istanza di App contenitore di Azure e tutti i servizi associati rimuovendo il gruppo di risorse.

Per rimuovere le risorse create, seguire questa procedura nel portale di Azure:

1. Selezionare il gruppo di risorse msdocscontainerapps nella sezione Panoramica .

2. Selezionare il pulsante Elimina gruppo di risorse nella parte superiore della pagina di Panoramica del gruppo di risorse.

3. Immettere il nome del gruppo di risorse msdocscontainerapps per confermare l'eliminazione.

4. Selezionare Elimina.

   Il completamento del processo di eliminazione del gruppo di risorse potrebbe richiedere alcuni minuti.

Passo successivo