Köra en anpassad container i Azure

Så här använder du hanterade identiteter för App Service och Azure Functions

Översikt över programövervakning för Azure App Service

Jag stötte på ett problem

Azure App Service på Linux tillhandahåller fördefinierade programstackar i Linux med stöd för språk som .NET, PHP, Node.js och andra. Du kan också använda en anpassad Docker-avbildning för att köra webbappen på en programstack som inte redan har definierats i Azure. Den här snabbstarten visar hur du distribuerar en avbildning från ett Azure Container Registry (ACR) till App Service.

Kommentar

Information om hur du kör containerbaserade program i en serverlös miljö finns i Container Apps.

Följande krävs för att slutföra den här snabbstarten:

Ett Azure-konto
Docker
Visual Studio Code
Azure App Service-tillägget för VS Code. Du kan använda det här tillägget för att skapa, hantera och distribuera Linux Web Apps på Azure Platform as a Service (PaaS).
Docker-tillägget för VS Code. Du kan använda det här tillägget för att förenkla hanteringen av lokala Docker-avbildningar och kommandon och för att distribuera byggda appavbildningar till Azure.

1 – Skapa ett containerregister

Den här snabbstarten använder Azure Container Registry som valfritt register. Du kan använda andra register, men stegen kan variera något.

Skapa ett containerregister genom att följa anvisningarna i Snabbstart: Skapa ett privat containerregister med hjälp av Azure-portalen.

Viktigt!

Se till att ange alternativet Administratörsanvändare till Aktivera när du skapar Azure-containerregistret. Du kan också ange den från avsnittet Åtkomstnycklar på registersidan i Azure-portalen. Den här inställningen krävs för App Service-åtkomst. Information om hanterad identitet finns i Självstudiekursen Distribuera från ACR.

Starta Visual Studio Code.
Välj Azure-logotypen i aktivitetsfältet, gå till APP SERVICE-utforskaren och välj sedan Logga in på Azure och följ anvisningarna.
I statusfältet längst ned kontrollerar du e-postadressen för ditt Azure-konto. I APP SERVICE-utforskaren ska din prenumeration visas.
I aktivitetsfältet väljer du Docker-logotypen . I REGISTRIES-utforskaren kontrollerar du att containerregistret som du skapade visas.

3 – Kontrollera kraven

Kontrollera att Du har Docker installerat och kört. Följande kommando visar Docker-versionen om den körs.

docker --version

4 – Skapa och skapa avbildning

Öppna en tom mapp i Visual Studio Code och lägg till en fil med namnet Dockerfile. I Dockerfile klistrar du in innehållet baserat på önskat språkramverk:

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

ENV PORT 8080
EXPOSE 8080

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

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

I den här Dockerfile är den överordnade avbildningen en av de inbyggda .NET-containrarna i App Service.

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"]

I den här Dockerfile är den överordnade avbildningen en av de inbyggda Node.js containrarna i App Service.

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"]

I den här Dockerfile är den överordnade avbildningen en av de inbyggda Python-containrarna i App Service.

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"]

I den här Dockerfile är den överordnade avbildningen en av de inbyggda Java-containrarna i App Service. Du hittar källfilerna för dem på GitHub-lagringsplatsen Azure-App-Service/java under java/tree/dev/java11-alpine. Dockerfile kopierar en enkel Java-app till /tmp/appservice. Dockerfile startar helt enkelt appen.

Öppna kommandopaletten och skriv Docker-avbildningar : Skapa avbildning. Skriv Retur för att köra kommandot.
I rutan avbildningstagg anger du den tagg som du vill använda i följande format: <acr-name>.azurecr.io/<image-name>:<tag>, där <acr-name> är namnet på det containerregister som du skapade. Tryck på Retur.
När avbildningen är klar klickar du på Uppdatera överst i IMAGES-utforskaren och kontrollerar att avbildningen har skapats.

5 – Distribuera till containerregistret

I aktivitetsfältet klickar du på Docker-ikonen . Leta reda på avbildningen som du skapade i IMAGES-utforskaren .
Expandera bilden, högerklicka på taggen du vill använda och klicka på Push.
Kontrollera att bildtaggen börjar med <acr-name>.azurecr.io och tryck på Retur.
När Visual Studio Code har överfört avbildningen till containerregistret klickar du på Uppdatera överst i REGISTRIES-utforskaren och kontrollerar att avbildningen har push-överförts.

6 – Distribuera till App Service

I utforskaren REGISTRIES expanderar du avbildningen, högerklickar på taggen och väljer Distribuera avbildning till Azure App Service.
Följ anvisningarna för att välja en prenumeration, ett globalt unikt appnamn, en resursgrupp och en App Service-plan. Välj B1 Basic för prisnivån och en region nära dig.

Efter distributionen är appen tillgänglig på http://<app-name>.azurewebsites.net.

En resursgrupp är en namngiven samling av alla programresurser i Azure. En resursgrupp kan till exempel innehålla en referens till en webbplats, en databas och en Azure-funktion.

En App Service-plan definierar de fysiska resurser som ska användas som värd för din webbplats. Den här snabbstarten använder en grundläggande värdplan för Linux-infrastruktur , vilket innebär att webbplatsen kommer att finnas på en Linux-dator tillsammans med andra webbplatser. Om du börjar med Basic-planen kan du använda Azure-portalen för att skala upp så att din är den enda platsen som körs på en dator. Priser finns i Priser för App Service.

7 – Bläddra på webbplatsen

Panelen Utdata visar status för distributionsåtgärderna. När åtgärden är klar väljer du Öppna webbplats i popup-meddelandet för att öppna webbplatsen i webbläsaren.

8 – Rensa resurser

I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte tror att du behöver dessa resurser i framtiden, kan du ta bort dem genom att ta bort resursgruppen.

På menyn eller startsidan i Azure-portalen väljer du Resursgrupper. Välj sedan myResourceGroup på sidan Resursgrupper.

På sidan myResourceGroup kontrollerar du att resurserna i listan är de som du vill ta bort.

Välj Ta bort resursgrupp, skriv myResourceGroup i textrutan för att bekräfta och välj sedan Ta bort.

Nästa steg

Grattis, du har slutfört den här snabbstarten.

App Service-appen hämtas från containerregistret varje gång den startas. Om du återskapar avbildningen behöver du bara push-överföra den till containerregistret och appen hämtar den uppdaterade avbildningen när den startas om. Starta om den om du vill be din app att hämta den uppdaterade avbildningen omedelbart.

Översikt över programövervakning för Azure App Service

Så här använder du hanterade identiteter för App Service och Azure Functions

Självstudie om sidovagnscontainer

Andra Azure-tillägg:

Azure Cosmos DB
Azure Functions
Azure CLI-verktyg
Azure Resource Manager-verktyg
Azure Tools-tilläggspaketet innehåller alla tillägg ovan.

Kommentar

Information om hur du kör containerbaserade program i en serverlös miljö finns i Container Apps.

Följande krävs för att slutföra den här snabbstarten:

1 – Klona exempellagringsplatsen

Klona exempelappen .NET 6.0 med följande kommando:

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

2 – Skicka avbildningen till Azure Container Registry

Kontrollera att du är i den klonade lagringsplatsens rotmapp. Den här lagringsplatsen innehåller en Dockerfile.linux-fil .

Logga in på Azure CLI.
```
az login
```
Logga in på Azure Container Registry.
```
az acr login -n <your_registry_name>
```

Skapa containeravbildningen. Vi namnger bilden dotnetcore-docs-hello-world-linux.

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

Skicka containeravbildningen till Azure Container Registry.
```
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux:latest
```
Kommentar

Dockerfile anger portnumret till 80 internt. Mer information om hur du konfigurerar containern finns i Konfigurera anpassad container.

3 – Distribuera till Azure

Logga in på Azure-portalen.

Skapa Azure-resurser

Skriv apptjänster i sökningen. Under Tjänster väljer du App Services.
På sidan App Services väljer du + Skapa.
På fliken Grundläggande information under Projektinformation kontrollerar du att rätt prenumeration har valts och väljer sedan Skapa ny resursgrupp. Skriv myResourceGroup som namn.
Under Instansinformation skriver du ett globalt unikt namn för webbappen och väljer Docker Container. Välj Linux för operativsystemet. Välj en region som du vill hantera din app från.
Under App Service-plan väljer du Skapa ny App Service-plan. Ange myAppServicePlan som namn. Om du vill ändra till den kostnadsfria nivån väljer du Ändra storlek, väljer fliken Dev/Test , väljer F1 och väljer knappen Använd längst ned på sidan.
Välj knappen Nästa: Docker > längst ned på sidan.
På fliken Docker väljer du Enskild container under Alternativ och Azure Container Registry som avbildningskälla. Under Alternativ för Azure-containerregister anger du följande värden:
- Register: Välj ditt Azure Container Registry.
- Bild: Välj dotnetcore-docs-hello-world-linux.
- Tagg: Välj senaste.
Välj knappen Granska + skapa längst ned på sidan.
När valideringen har körts väljer du knappen Skapa längst ned på sidan.
När distributionen är klar väljer du Gå till resurs.

4 – Bläddra till appen

Bläddra till det distribuerade programmet i webbläsaren på URL:en http://<app-name>.azurewebsites.net.

Skärmbild som visar den distribuerade appen.

5 – Rensa resurser

I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte tror att du behöver dessa resurser i framtiden, kan du ta bort dem genom att ta bort resursgruppen.

På menyn eller startsidan i Azure-portalen väljer du Resursgrupper. Välj sedan myResourceGroup på sidan Resursgrupper.

På sidan myResourceGroup kontrollerar du att resurserna i listan är de som du vill ta bort.

Välj Ta bort resursgrupp, skriv myResourceGroup i textrutan för att bekräfta och välj sedan Ta bort.

Nästa steg

Grattis, du har slutfört den här snabbstarten.

Översikt över programövervakning för Azure App Service

Så här använder du hanterade identiteter för App Service och Azure Functions

Självstudie om sidovagnscontainer

Den här snabbstarten visar hur du distribuerar en ASP.NET app i en Windows-avbildning från Azure Container Registry till Azure App Service.

Följande krävs för att slutföra den här snabbstarten:

1 – Klona exempellagringsplatsen

Klona exempelappen .NET 6.0 med följande kommando:

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

2 – Skicka avbildningen till Azure Container Registry

Kontrollera att du är i den klonade lagringsplatsens rotmapp. Den här lagringsplatsen innehåller en Dockerfile.windows-fil . Vi kommer att använda Windows Nano Server Long Term Servicing Channel (LTSC) 2022 som basoperativsystem och uttryckligen anropa vår Windows-bas.

Kommentar

Även om det här är en Windows-container måste sökvägarna fortfarande använda snedstreck. Mer information finns i Skriva en Dockerfile .

Logga in på Azure CLI.
```
az login
```
Logga in på Azure Container Registry.
```
az acr login -n <your_registry_name>
```

Skapa containeravbildningen. Vi namnger bilden dotnetcore-docs-hello-world-windows.

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

Skicka containeravbildningen till Azure Container Registry.
```
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows:latest
```
Kommentar

Dockerfile anger portnumret till 80 internt. Mer information om hur du konfigurerar containern finns i Konfigurera anpassad container.

3 – Distribuera till Azure

Logga in på Azure-portalen.

Skapa Azure-resurser

Skriv apptjänster i sökningen. Under Tjänster väljer du App Services.
På sidan App Services väljer du + Skapa.
På fliken Grundläggande information under Projektinformation kontrollerar du att rätt prenumeration har valts och väljer sedan Skapa ny resursgrupp. Skriv myResourceGroup som namn.
Under Instansinformation skriver du ett globalt unikt namn för webbappen och väljer Docker Container. Välj Windows för operativsystemet. Välj en region som du vill hantera din app från.
Under App Service-plan väljer du Skapa ny App Service-plan. Ange myAppServicePlan som namn. Om du vill ändra till den kostnadsfria nivån väljer du Ändra storlek, väljer fliken Dev/Test , väljer P1v3 och väljer knappen Använd längst ned på sidan.
Välj knappen Nästa: Docker > längst ned på sidan.
På fliken Docker väljer du Azure Container Registry som avbildningskälla. Under Alternativ för Azure-containerregister anger du följande värden:
- Register: Välj ditt Azure Container Registry.
- Bild: Välj dotnetcore-docs-hello-world-windows.
- Tagg: Välj senaste.
Välj knappen Granska + skapa längst ned på sidan.
När valideringen har körts väljer du knappen Skapa längst ned på sidan.
När distributionen är klar väljer du Gå till resurs.

4 – Bläddra till appen

Bläddra till det distribuerade programmet i webbläsaren på URL:en http://<app-name>.azurewebsites.net.

Skärmbild av Windows App Service med meddelanden som containrar utan en port exponeras kommer att köras i bakgrundsläge.

Observera att värdoperativsystemet visas i sidfoten och bekräftar att vi körs i en Windows-container.

5 – Rensa resurser

I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte tror att du behöver dessa resurser i framtiden, kan du ta bort dem genom att ta bort resursgruppen.

På menyn eller startsidan i Azure-portalen väljer du Resursgrupper. Välj sedan myResourceGroup på sidan Resursgrupper.

På sidan myResourceGroup kontrollerar du att resurserna i listan är de som du vill ta bort.

Välj Ta bort resursgrupp, skriv myResourceGroup i textrutan för att bekräfta och välj sedan Ta bort.

Nästa steg

Grattis, du har slutfört den här snabbstarten.

Så här använder du hanterade identiteter för App Service och Azure Functions

Översikt över programövervakning för Azure App Service

Den här snabbstarten visar hur du distribuerar en ASP.NET app i en Windows-avbildning från Microsoft Artifact Registry till Azure App Service.

Följande krävs för att slutföra den här snabbstarten:

Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
Azure PowerShell.

1 – Ansluta till Azure

Logga in på ditt Azure-konto med hjälp Connect-AzAccount av kommandot och följ kommandotolken:

Connect-AzAccount

2 – Skapa en resursgrupp

Skapa en resursgrupp med kommandot New-AzResourceGroup. En Azure-resursgrupp är en logisk container där Azure-resurser distribueras och hanteras.

I följande exempel skapas en resursgrupp med namnet myResourceGroup i regionen eastus. Om du vill se alla platser som stöds för App Service kör du kommandot Get-AzLocation.

New-AzResourceGroup -Name myResourceGroup -Location eastus

Kommandot returnerar Login Succeeded när det har slutförts.

3 – Skapa din App Service-plan

Skapa en ny App Service-plan med kommandot New-AzAppServicePlan .

I följande exempel skapas en App Service-plan med namnet myAppServicePlan på prisnivån PremiumV3 (-Tier PremiumV3). Parametern -HyperV anger Windows-container.

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

4 – Skapa din webbapp

Skapa en ny app med kommandot New-AzWebApp :

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

Parametern Namn anger webbappens namn.
Parametern AppServicePlan anger apptjänstplanens namn.
Parametern Plats anger platsen.
Parametern ResourceGroupName anger namnet på resursgruppen.
Parametern ContainerImageName anger ett containeravbildningsnamn och en valfri tagg.

Det kan ta några minuter att slutföra kommandot.

5 – Bläddra till appen

Bläddra till det distribuerade programmet i webbläsaren på URL:en http://<app-name>.azurewebsites.net.

Skärmbild av Windows App Service med meddelanden som containrar utan en port exponeras kommer att köras i bakgrundsläge.

6 – Rensa resurser

Ta bort resursgruppen med kommandot Remove-AzResourceGroup :

Remove-AzResourceGroup myResourceGroup

Nästa steg

Grattis, du har slutfört den här snabbstarten.

Så här använder du hanterade identiteter för App Service och Azure Functions

Översikt över programövervakning för Azure App Service

Den här snabbstarten visar hur du distribuerar en ASP.NET app i en Windows-avbildning från Microsoft Artifact Registry till Azure App Service.

Följande krävs för att slutföra den här snabbstarten:

Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
Azure CLI

1 – Ansluta till Azure

Logga in på ditt Azure-konto med hjälp az login av kommandot och följ kommandotolken:

az login

2 – Skapa en resursgrupp

Skapa en resursgrupp med kommandot az group create. En Azure-resursgrupp är en logisk container där Azure-resurser distribueras och hanteras.

I följande exempel skapas en resursgrupp med namnet myResourceGroup i regionen eastus. Om du vill se alla platser som stöds för App Service kör du kommandot az appservice list-locations.

az group create --name myResourceGroup --location eastus

3 – Skapa din App Service-plan

Skapa en App Service-plan i resursgruppen med az appservice plan create kommandot .

I följande exempel skapas en App Service-plan med namnet myAppServicePlan på prisnivån P1V3 (--sku P1V3).

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

Kommentar

Om du stöter på felet "Beteendet för det här kommandot har ändrats av följande tillägg: appservice-kube" tar du bort appservice-kube tillägget.

4 – Skapa din webbapp

Skapa en anpassad containerwebbapp i myAppServicePlan App Service-planen med kommandot az webapp create. Glöm inte att ersätta myContainerApp med ett unikt appnamn (giltiga tecken är a-z, 0-9och -).

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

Parametern Namn anger webbappens namn.
Parametern AppServicePlan anger apptjänstplanens namn.
Parametern Plats anger platsen.
Parametern ResourceGroupName anger namnet på resursgruppen.
Parametern deployment-container-image-name anger ett containeravbildningsnamn och en valfri tagg.

5 – Bläddra till appen

Bläddra till det distribuerade programmet i webbläsaren på URL:en http://<app-name>.azurewebsites.net.

Skärmbild av Windows App Service med meddelanden som containrar utan en port exponeras kommer att köras i bakgrundsläge.

6 – Rensa resurser

Ta bort resursgruppen med kommandot az group delete :

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

Nästa steg

Grattis, du har slutfört den här snabbstarten.

Så här använder du hanterade identiteter för App Service och Azure Functions

Översikt över programövervakning för Azure App Service