Eseguire un contenitore personalizzato in Azure

Panoramica del monitoraggio delle applicazioni per app Azure Service

Come usare le identità gestite nel servizio app e in Funzioni di Azure

Si è verificato un problema

app Azure Servizio in Linux fornisce stack di applicazioni predefiniti in Linux con supporto per linguaggi come .NET, PHP, Node.js e altri. È anche possibile usare un'immagine Docker personalizzata per eseguire l'app Web in uno stack di applicazioni non già definito in Azure. Questo argomento di avvio rapido illustra come distribuire un'immagine da un Registro Azure Container al servizio app.

Nota

Per informazioni sull'esecuzione di applicazioni in contenitori in un ambiente serverless, vedere App contenitore.

Per completare l'esercitazione introduttiva, sono necessari gli elementi seguenti:

Un account Azure
Docker
Visual Studio Code
Estensione Servizio app di Azure per VS Code. È possibile usare questa estensione per creare, gestire e distribuire app Web Linux nella piattaforma distribuita come servizio (PaaS) di Azure.
Estensione Docker per VS Code. È possibile usare questa estensione per semplificare la gestione delle immagini e dei comandi Docker locali e per distribuire in Azure immagini di app compilate.

1 - Creare un registro contenitori

Questa guida introduttiva usa Registro Azure Container come registro preferito. È possibile usare altri registri, ma i passaggi possono variare leggermente.

Creare un registro contenitori seguendo le istruzioni riportate in Avvio rapido: Creare un registro contenitori privato usando il portale di Azure.

Importante

Assicurarsi di impostare l'opzione utente Amministrazione su Abilita quando si crea il Registro Azure Container. È anche possibile impostare questa opzione dalla sezione Chiavi di accesso della pagina del registro nel portale di Azure. Questa impostazione è obbligatoria per l'accesso al servizio app. Per l'identità gestita, vedere l'esercitazione Distribuire da Registro Azure Container.

Avviare Visual Studio Code.
Selezionare il logo di Azure nella barra delle attività, passare ad APP edizione Standard RVICE Explorer, quindi selezionare Accedi ad Azure e seguire le istruzioni.
Nella barra di stato nella parte inferiore verificare l'indirizzo di posta elettronica dell'account Azure. Nello strumento di esplorazione app edizione Standard RVICE la sottoscrizione deve essere visualizzata.
Nella barra delle attività selezionare il logo Docker . Nello strumento di esplorazione REGISTRIES verificare che venga visualizzato il registro contenitori creato.

3 - Controllare i prerequisiti

Verificare che Docker sia installato e in esecuzione. Il comando seguente visualizzerà la versione di Docker se è in esecuzione.

docker --version

4 - Creare e creare un'immagine

In Visual Studio Code aprire una cartella vuota e aggiungere un file denominato Dockerfile. Nel Dockerfile incollare il contenuto in base al framework di linguaggio desiderato:

FROM mcr.microsoft.com/appsvc/dotnetcore:lts

ENV PORT 8080
EXPOSE 8080

ENV ASPNETCORE_URLS "http://*:${PORT}"

ENTRYPOINT ["dotnet", "/defaulthome/hostingstart/hostingstart.dll"]

In questo Dockerfile l'immagine padre è uno dei contenitori .NET predefiniti di servizio app. È possibile trovare i file di origine nel repository GitHub Azure-App-Service/ImageBuilder, in GenerateDockerFiles/dotnetcore. Il Dockerfile copia una semplice app .NET in /defaulthome/hostingstart. Il Dockerfile avvia semplicemente l'app.

FROM mcr.microsoft.com/appsvc/node:10-lts

ENV HOST 0.0.0.0
ENV PORT 8080
EXPOSE 8080

ENTRYPOINT ["pm2", "start", "--no-daemon", "/opt/startup/default-static-site.js"]

In questo Dockerfile l'immagine padre è uno dei contenitori di Node.js predefiniti di servizio app. È possibile trovare i file di origine nel repository GitHub Azure-App-Service/ImageBuilder, in GenerateDockerFiles/node/node-template. Il Dockerfile copia un'app Node.js semplice in /opt/startup. Il Dockerfile avvia semplicemente l'app usando PM2, già installata dall'immagine padre.

FROM mcr.microsoft.com/appsvc/python:latest

ENV PORT 8080
EXPOSE 8080

ENTRYPOINT ["gunicorn", "--timeout", "600", "--access-logfile", "'-'", "--error-logfile", "'-'", "--chdir=/opt/defaultsite", "application:app"]

In questo Dockerfile l'immagine padre è uno dei contenitori Python predefiniti di servizio app. È possibile trovare i file di origine nel repository GitHub Azure-App-Service/ImageBuilder, in GenerateDockerFiles/python/template-3.9. Il Dockerfile copia una semplice app Python in /opt/defaultsite. Il Dockerfile avvia semplicemente l'app usando Gunicorn, già installata dall'immagine padre.

FROM mcr.microsoft.com/azure-app-service/java:11-java11_stable

ENV PORT 80
EXPOSE 80

ENTRYPOINT ["java", "-Dserver.port=80", "-jar", "/tmp/appservice/parkingpage.jar"]

In questo Dockerfile l'immagine padre è uno dei contenitori Java predefiniti di servizio app. È possibile trovare i file di origine nel repository GitHub Azure-App-Service/java, in java/tree/dev/java11-alpine. Il Dockerfile copia una semplice app Java in /tmp/appservice. Il Dockerfile avvia semplicemente l'app.

Aprire il riquadro comandi e digitare Immagini Docker: Compila immagine. Digitare INVIO per eseguire il comando.
Nella casella tag immagine specificare il tag desiderato nel formato seguente: <acr-name>.azurecr.io/<image-name>/<tag>, dove <acr-name> è il nome del registro contenitori creato. Premere INVIO.
Al termine della compilazione dell'immagine, fare clic su Aggiorna nella parte superiore di Esplora IMMAGINI e verificare che l'immagine sia stata compilata correttamente.

5 - Distribuire nel registro contenitori

Nella barra delle attività fare clic sull'icona Docker . In Esplora IMMAGINI trovare l'immagine creata.
Espandere l'immagine, fare clic con il pulsante destro del mouse sul tag desiderato e scegliere Push.
Assicurarsi che il tag immagine inizi con <acr-name>.azurecr.io e premere INVIO.
Al termine del push dell'immagine nel registro contenitori di Visual Studio Code, fare clic su Aggiorna nella parte superiore dello strumento di esplorazione REGISTRIES e verificare che l'immagine venga inserita correttamente.

6 - Eseguire la distribuzione in servizio app

Nello strumento di esplorazione REGISTRIES espandere l'immagine, fare clic con il pulsante destro del mouse sul tag e selezionare Deploy image to app Azure Service (Distribuisci immagine nel servizio app Azure).
Seguire le istruzioni per scegliere una sottoscrizione, un nome di app univoco globale, un gruppo di risorse e un piano di servizio app. Scegliere B1 Basic per il piano tariffario e un'area nelle vicinanze.

Dopo la distribuzione, l'app è disponibile all'indirizzo http://<app-name>.azurewebsites.net.

Un gruppo di risorse è una raccolta denominata di tutte le risorse dell'applicazione in Azure. Può contenere ad esempio un riferimento a un sito Web, a un database e a una funzione di Azure.

Un piano di servizio app definisce le risorse fisiche che verranno usate per ospitare il sito Web. Questa guida di avvio rapido usa un piano di hosting Basic nell'infrastruttura Linux, il che significa che il sito verrà ospitato in un computer Linux insieme ad altri siti Web. Se si inizia con il piano Basic, è possibile usare il portale di Azure per aumentare le prestazioni in modo che il proprio sia l'unico sito in esecuzione su un computer. Per i prezzi, vedere prezzi servizio app.

7 - Sfoglia il sito Web

Il pannello Output mostra lo stato delle operazioni di distribuzione. Al termine dell'operazione, selezionare Apri sito nella notifica popup per aprire il sito nel browser.

8 - Pulire le risorse

Nel menu del portale di Azure o nella pagina Home selezionare Gruppi di risorse. Quindi, nella pagina Gruppi di risorse selezionare myResourceGroup.

Nella pagina myResourceGroup assicurarsi che le risorse elencate siano quelle da eliminare.

Selezionare Elimina gruppo di risorse, digitare myResourceGroup nella casella di testo per confermare e quindi selezionare Elimina.

Passaggi successivi

L'avvio rapido è stato completato correttamente.

L'app servizio app esegue il pull dal registro contenitori ogni volta che viene avviata. Se si ricompila l'immagine, è sufficiente eseguirne il push nel registro contenitori e l'app esegue il pull nell'immagine aggiornata al riavvio. Per indicare all'app di eseguire immediatamente il pull dell'immagine aggiornata, riavviarla.

Proteggere con dominio e certificato personalizzati

Eseguire la migrazione al contenitore Windows in Azure

Panoramica del monitoraggio delle applicazioni per app Azure Service

Come usare le identità gestite nel servizio app e in Funzioni di Azure

Proteggere con dominio e certificato personalizzati

Altre estensioni di Azure:

Azure Cosmos DB
Funzioni di Azure
Strumenti dell'interfaccia della riga di comando di Azure
Strumenti di Azure Resource Manager
Il pacchetto di estensione Strumenti di Azure include tutte le estensioni precedenti.

app Azure Servizio in Linux fornisce stack di applicazioni predefiniti in Linux con supporto per linguaggi come .NET, PHP, Node.js e altri. È anche possibile usare un'immagine Docker personalizzata per eseguire l'app Web in uno stack di applicazioni non già definito in Azure. Questa guida introduttiva illustra come distribuire un'immagine da Registro Azure Container al servizio app Azure.

Nota

Per informazioni sull'esecuzione di applicazioni in contenitori in un ambiente serverless, vedere App contenitore.

Per completare l'esercitazione introduttiva, sono necessari gli elementi seguenti:

Un account Azure
Registro Azure Container
Interfaccia della riga di comando di Azure
Docker

1 - Clonare il repository di esempio

Clonare l'app di esempio .NET 6.0 con il comando seguente:

git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git

2 - Eseguire il push dell'immagine in Registro Azure Container

Assicurarsi di essere nella cartella radice del repository clonato. Questo repository contiene un file Dockerfile.linux .

Accedere all'interfaccia della riga di comando di Azure.
```
az login
```
Accedere a Registro Azure Container.
```
az acr login -n <your_registry_name>
```

Compilare l'immagine del contenitore. Si assegna un nome all'immagine dotnetcore-docs-hello-world-linux.

docker build -f Dockerfile.linux -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux .

Eseguire il push dell'immagine del contenitore in Registro Azure Container.
```
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux:latest
```
Nota

Il Dockerfile imposta internamente il numero di porta su 80. Per altre informazioni sulla configurazione del contenitore, vedere Configurare un contenitore personalizzato.

3 - Distribuire in Azure

Accedere al portale di Azure.

Creare risorse Azure

Digitare i servizi app nella ricerca. In Servizi selezionare servizio app.
Nella pagina servizio app selezionare + Crea.
Nella scheda Informazioni di base, in Dettagli progetto, verificare che la sottoscrizione corretta sia selezionata e quindi selezionare Crea nuovo gruppo di risorse. Per il nome digitare myResourceGroup.
In Dettagli istanza digitare un nome univoco globale per l'app Web e selezionare Contenitore Docker. Selezionare Linux per Sistema operativo. Selezionare un'area da cui si vuole gestire l'app.
In Piano servizio app selezionare Crea nuovo piano servizio app. Digitare myAppServicePlan come nome. Per passare al livello Gratuito, selezionare Modifica dimensioni, selezionare la scheda Sviluppo/Test , selezionare F1 e selezionare il pulsante Applica nella parte inferiore della pagina.
Selezionare il pulsante Avanti: Docker > nella parte inferiore della pagina.
Nella scheda Docker selezionare Contenitore singolo in Opzioni e Registro Azure Container per Origine immagine. In Opzioni del Registro Azure Container impostare i valori seguenti:
- Registro di sistema: selezionare il Registro Azure Container.
- Immagine: selezionare dotnetcore-docs-hello-world-linux.
- Tag: selezionare la versione più recente.
Selezionare quindi il pulsante Rivedi e crea nella parte inferiore della pagina.
Dopo l'esecuzione della convalida, seleziona il pulsante Create in fondo alla pagina.
Al termine della distribuzione, selezionare Vai alla risorsa.

4 - Passare all'app

Passare all'applicazione distribuita nel Web browser all'URL http://<app-name>.azurewebsites.net.

Screenshot che mostra l'applicazione distribuita.

5 - Pulire le risorse

Nel menu del portale di Azure o nella pagina Home selezionare Gruppi di risorse. Quindi, nella pagina Gruppi di risorse selezionare myResourceGroup.

Nella pagina myResourceGroup assicurarsi che le risorse elencate siano quelle da eliminare.

Selezionare Elimina gruppo di risorse, digitare myResourceGroup nella casella di testo per confermare e quindi selezionare Elimina.

Passaggi successivi

L'avvio rapido è stato completato correttamente.

Eseguire la migrazione al contenitore Windows in Azure

Panoramica del monitoraggio delle applicazioni per app Azure Service

Come usare le identità gestite nel servizio app e in Funzioni di Azure

Proteggere con dominio e certificato personalizzati

Questa guida introduttiva illustra come distribuire un'app ASP.NET in un'immagine di Windows da Registro Azure Container al servizio app Azure.

Per completare l'esercitazione introduttiva, sono necessari gli elementi seguenti:

1 - Clonare il repository di esempio

Clonare l'app di esempio .NET 6.0 con il comando seguente:

git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git

2 - Eseguire il push dell'immagine in Registro Azure Container

Assicurarsi di essere nella cartella radice del repository clonato. Questo repository contiene un file Dockerfile.windows . Verrà usato Windows Nano Server Long Term Servicing Channel (LTSC) 2022 come sistema operativo di base, chiamando in modo esplicito la base di Windows.

Nota

Anche se si tratta di un contenitore Windows, i percorsi devono comunque usare barre. Per altri dettagli, vedere Scrivere un Dockerfile .

Accedere all'interfaccia della riga di comando di Azure.
```
az login
```
Accedere a Registro Azure Container.
```
az acr login -n <your_registry_name>
```
Compilare l'immagine del contenitore. Stiamo assegnando un nome all'immagine dotnetcore-docs-hello-world-windows.
```
docker build -f Dockerfile.windows -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows . 
```
Eseguire il push dell'immagine del contenitore in Registro Azure Container.
```
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows:latest
```
Nota

Il Dockerfile imposta internamente il numero di porta su 80. Per altre informazioni sulla configurazione del contenitore, vedere Configurare un contenitore personalizzato.

3 - Distribuire in Azure

Accedere al portale di Azure.

Creare risorse Azure

Digitare i servizi app nella ricerca. In Servizi selezionare servizio app.
Nella pagina servizio app selezionare + Crea.
Nella scheda Informazioni di base, in Dettagli progetto, verificare che la sottoscrizione corretta sia selezionata e quindi selezionare Crea nuovo gruppo di risorse. Per il nome digitare myResourceGroup.
In Dettagli istanza digitare un nome univoco globale per l'app Web e selezionare Contenitore Docker. Selezionare Windows per sistema operativo. Selezionare un'area da cui si vuole gestire l'app.
In Piano servizio app selezionare Crea nuovo piano servizio app. Digitare myAppServicePlan come nome. Per passare al livello gratuito, selezionare Modifica dimensioni, selezionare la scheda Sviluppo/Test , selezionare P1v3 e selezionare il pulsante Applica nella parte inferiore della pagina.
Selezionare il pulsante Avanti: Docker > nella parte inferiore della pagina.
Nella scheda Docker selezionare Registro Azure Container per Origine immagine. In Opzioni del Registro Azure Container impostare i valori seguenti:
- Registro di sistema: selezionare il Registro Azure Container.
- Immagine: selezionare dotnetcore-docs-hello-world-windows.
- Tag: selezionare la versione più recente.
Selezionare quindi il pulsante Rivedi e crea nella parte inferiore della pagina.
Dopo l'esecuzione della convalida, seleziona il pulsante Create in fondo alla pagina.
Al termine della distribuzione, selezionare Vai alla risorsa.

4 - Passare all'app

Passare all'applicazione distribuita nel Web browser all'URL http://<app-name>.azurewebsites.net.

Screenshot del servizio app di Windows con la messaggistica che i contenitori senza una porta esposta verranno eseguiti in modalità in background.

Si noti che il sistema operativo host viene visualizzato nel piè di pagina, confermando che è in esecuzione in un contenitore Windows.

5 - Pulire le risorse

Nel menu del portale di Azure o nella pagina Home selezionare Gruppi di risorse. Quindi, nella pagina Gruppi di risorse selezionare myResourceGroup.

Nella pagina myResourceGroup assicurarsi che le risorse elencate siano quelle da eliminare.

Selezionare Elimina gruppo di risorse, digitare myResourceGroup nella casella di testo per confermare e quindi selezionare Elimina.

Passaggi successivi

L'avvio rapido è stato completato correttamente.

Eseguire la migrazione al contenitore Windows in Azure

Panoramica del monitoraggio delle applicazioni per app Azure Service

Come usare le identità gestite nel servizio app e in Funzioni di Azure

Proteggere con dominio e certificato personalizzati

Questa guida introduttiva illustra come distribuire un'app ASP.NET in un'immagine di Windows da Registro artefatti Microsoft al servizio app Azure.

Per completare l'esercitazione introduttiva, sono necessari gli elementi seguenti:

Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
Azure PowerShell.

1 - Connessione in Azure

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

Connect-AzAccount

2 - Creare un gruppo di risorse

Creare un gruppo di risorse con il comando New-AzResourceGroup. Un gruppo di risorse di Azure è un contenitore logico in cui le risorse di Azure vengono distribuite e gestite.

L'esempio seguente crea un gruppo di risorse denominato myResourceGroup nella località stati uniti orientali. Per visualizzare tutte le località supportate per il servizio app, eseguire il comando Get-AzLocation.

New-AzResourceGroup -Name myResourceGroup -Location eastus

Il comando restituisce Login Succeeded al termine dell'esecuzione.

3 - Creare il piano di servizio app

Creare un nuovo piano di servizio app usando il comando New-AzAppServicePlan .

L'esempio seguente crea un piano servizio app denominato myAppServicePlan nel piano tariffario PremiumV3 (-Tier PremiumV3). Il -HyperV parametro specifica il contenitore di Windows.

New-AzAppServicePlan -Name myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -Tier PremiumV3 -HyperV

4 - Creare l'app Web

Creare una nuova app usando il comando New-AzWebApp :

New-AzWebApp -Name myWebApp -AppServicePlan myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -ContainerImageName mcr.microsoft.com/azure-app-service/windows/parkingpage:latest

Il parametro Name specifica il nome dell'app Web.
Il parametro AppServicePlan specifica il servizio app Nome piano.
Il parametro Location consente di specificare la posizione.
Il parametro ResourceGroupName specifica il nome del gruppo di risorse.
Il parametro ContainerImageName specifica un nome immagine contenitore e un tag facoltativo.

Il completamento del comando potrebbe richiedere alcuni minuti.

5 - Passare all'app

Passare all'applicazione distribuita nel Web browser all'URL http://<app-name>.azurewebsites.net.

Screenshot del servizio app di Windows con la messaggistica che i contenitori senza una porta esposta verranno eseguiti in modalità in background.

6 - Pulire le risorse

Rimuovere il gruppo di risorse usando il comando Remove-AzResourceGroup :

Remove-AzResourceGroup myResourceGroup

Passaggi successivi

L'avvio rapido è stato completato correttamente.

Eseguire la migrazione al contenitore Windows in Azure

Panoramica del monitoraggio delle applicazioni per app Azure Service

Come usare le identità gestite nel servizio app e in Funzioni di Azure

Proteggere con dominio e certificato personalizzati

Questa guida introduttiva illustra come distribuire un'app ASP.NET in un'immagine di Windows da Registro artefatti Microsoft al servizio app Azure.

Per completare l'esercitazione introduttiva, sono necessari gli elementi seguenti:

Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
Interfaccia della riga di comando di Azure

1 - Connessione in Azure

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

az login

2 - Creare un gruppo di risorse

Creare un gruppo di risorse con il comando az group create. Un gruppo di risorse di Azure è un contenitore logico in cui le risorse di Azure vengono distribuite e gestite.

az group create --name myResourceGroup --location eastus

3 - Creare il piano di servizio app

Creare un piano servizio app nel gruppo di risorse con il az appservice plan create comando .

L'esempio seguente crea un piano servizio app denominato myAppServicePlan nel piano tariffario P1V3 (--sku P1V3).

az appservice plan create --resource-group myResourceGroup --location eastus --name myAppServicePlan --hyper-v --sku p1v3

Nota

Se si verifica l'errore "Il comportamento di questo comando è stato modificato dall'estensione seguente: appservice-kube" rimuovere l'estensione appservice-kube .

4 - Creare l'app Web

Creare un'app Web contenitore personalizzata nel myAppServicePlan piano di servizio app con il comando az webapp create. Non dimenticare di sostituire myContainerApp con un nome univoco dell'app (i caratteri validi sono a-z, 0-9e -).

az webapp create --name myContainerApp --plan myAppServicePlan --location eastus --resource-group myResourceGroup --deployment-container-image-name mcr.microsoft.com/azure-app-service/windows/parkingpage:latest

Il parametro Name specifica il nome dell'app Web.
Il parametro AppServicePlan specifica il servizio app Nome piano.
Il parametro Location consente di specificare la posizione.
Il parametro ResourceGroupName specifica il nome del gruppo di risorse.
Il parametro deployment-container-image-name specifica un nome di immagine del contenitore e un tag facoltativo.

5 - Passare all'app

Passare all'applicazione distribuita nel Web browser all'URL http://<app-name>.azurewebsites.net.

Screenshot del servizio app di Windows con la messaggistica che i contenitori senza una porta esposta verranno eseguiti in modalità in background.

6 - Pulire le risorse

Rimuovere il gruppo di risorse usando il comando az group delete :

az group delete --no-wait --name <resource_group>

Passaggi successivi

L'avvio rapido è stato completato correttamente.

Eseguire la migrazione al contenitore Windows in Azure

Panoramica del monitoraggio delle applicazioni per app Azure Service

Come usare le identità gestite nel servizio app e in Funzioni di Azure