Een aangepaste container uitvoeren in Azure
Azure App Service biedt vooraf gedefinieerde toepassingsstacks in Windows, zoals ASP.NET of Node.js, die worden uitgevoerd in IIS. De vooraf geconfigureerde toepassingsstacks vergrendelen het besturingssysteem echter en voorkomen toegang op laag niveau. Aangepaste Windows-containers hebben deze beperkingen niet en stellen ontwikkelaars in staat om de containers volledig aan te passen en toepassingen in containers volledige toegang te geven tot Windows-functionaliteit.
In deze quickstart ziet u hoe u vanuit Visual Studio een ASP.NET-app in een Windows-installatiekopieën implementeert in Azure Container Registry . U voert de app uit in een aangepaste container in Azure App Service.
U hebt het volgende nodig om deze snelstartgids te voltooien:
- Docker voor Windows installeren
- Docker overschakelen om Windows-containers uit te voeren
- Installeer Visual Studio 2022 met de ASP.NET- en webontwikkelingsworkloads en Azure-ontwikkelworkloads . Zorg ervoor dat in de Visual Studio 2022-community het onderdeel .NET Framework-project- en itemsjablonen is geselecteerd met ASP.NET- en webontwikkelingsworkload. Als u Visual Studio 2022 al hebt geïnstalleerd:
- Installeer de nieuwste updates in Visual Studio door Help>Controleren op updates te selecteren.
- Voeg de workloads toe in Visual Studio door Extra>Hulpprogramma’s en functies ophalen te selecteren.
1 - Een ASP.NET-web-app maken
Maak een ASP.NET-web-app door de volgende stappen uit te voeren:
Open Visual Studio en selecteer Een nieuw project maken.
Kies in Een nieuw project maken de optie ASP.NET-webtoepassing (.NET Framework) voor #C. Selecteer vervolgens Volgende.
Geef in Configure your new project, under Project name, the application myfirstazurewebapp. Selecteer onder Framework .NET Framework 4.8 en selecteer vervolgens Maken.
U kunt elk type ASP.NET-web-app implementeren in Azure. Kies voor deze quickstart de sjabloon MVC.
Selecteer Geen onder Verificatie. Selecteer onder Geavanceerd docker-ondersteuning en schakel Configureren voor HTTPS uit. Selecteer Maken.
Als het bestand Dockerfile niet automatisch wordt geopend, opent u het vanuit Solution Explorer.
U hebt een ondersteunde bovenliggende installatiekopie nodig. Wijzig de bovenliggende installatiekopie door de regel
FROM
te vervangen door de volgende code en het bestand op te slaan:FROM mcr.microsoft.com/dotnet/framework/aspnet:4.8-windowsservercore-ltsc2019
Selecteer in het menu van Visual Studio de optie Foutopsporing>Starten zonder foutopsporing om de web-app lokaal uit te voeren.
2 - Publiceren naar Azure Container Registry
Klik in Solution Explorer met de rechtermuisknop op het project myfirstazurewebapp en selecteer Publiceren.
Selecteer In Target Docker Container Registry en selecteer vervolgens Volgende.
Selecteer In Specifiek doel Azure Container Registry en selecteer vervolgens Volgende.
Zorg ervoor dat in Publiceren het juiste abonnement is gekozen. Selecteer in containerregisters de + knop om een nieuwe Azure Container Registry te maken.
Zorg ervoor dat in Nieuw maken het juiste abonnement is gekozen. Selecteer onder Resourcegroep Nieuw en typ myResourceGroup voor de naam en selecteer OK. Selecteer Basic onder SKU. Selecteer onder Registerlocatie een locatie van het register en selecteer vervolgens Maken.
Selecteer in Publiceren onder Container Registry het register dat u hebt gemaakt en selecteer vervolgens Voltooien.
Wacht totdat de installatie is voltooid. Op de pagina Publiceren wordt nu de naam van de opslagplaats weergegeven. Selecteer de knop Kopiëren om de naam van de opslagplaats voor later te kopiëren.
3 - Een aangepaste Windows-container maken
Meld u aan bij het Azure-portaal.
Kies in de linkerbovenhoek van de Azure-portal Een resource maken.
Selecteer Onder Populaire services maken onder Web-app.
Kies in Create Web App uw abonnement en een resourcegroep. U kunt een nieuwe resourcegroep maken, indien nodig.
Geef een app-naam op, zoals win-container-demo. Kies Docker-container voor publiceren en Windows voor het besturingssysteem. Selecteer Volgende: Docker om door te gaan.
Voor De bron van de installatiekopieën kiest u Docker Hub en voor installatiekopieën en tags, voert u de naam van de opslagplaats in die u hebt gekopieerd in Publish to Azure Container Registry.
Als u elders een aangepaste installatiekopie voor de webtoepassing hebt, bijvoorbeeld in Azure Container Registry of in een andere privéopslagplaats, kunt u deze hier configureren. Selecteer Beoordelen en maken om door te gaan.
Controleer alle details en selecteer Vervolgens Maken en wachten tot azure de vereiste resources heeft gemaakt.
4 - Bladeren naar de aangepaste container
Als de bewerking in Azure is voltooid, wordt er een melding weergegeven.
Klik op Ga naar resource.
Klik in het overzicht van deze resource op de koppeling naast URL.
Er wordt een nieuwe browserpagina geopend met de volgende pagina:
Wacht enkele minuten en probeer het opnieuw totdat u de startpagina van ASP.NET ziet:
Gefeliciteerd U voert nu uw eerste aangepaste Windows-container uit in Azure App Service.
5 - Bekijk opstartlogboeken van containers
Het kan enige tijd duren voordat de Windows-container is geladen. Als u de voortgang wilt zien, gaat u naar de volgende URL door app_name> te vervangen <door de naam van uw app.
https://<app_name>.scm.azurewebsites.net/api/logstream
De gestreamde logboeken zien er als volgt uit:
2018-07-27T12:03:11 Welcome, you are now connected to log-streaming service.
27/07/2018 12:04:10.978 INFO - Site: win-container-demo - Start container succeeded. Container: facbf6cb214de86e58557a6d073396f640bbe2fdec88f8368695c8d1331fc94b
27/07/2018 12:04:16.767 INFO - Site: win-container-demo - Container start complete
27/07/2018 12:05:05.017 INFO - Site: win-container-demo - Container start complete
27/07/2018 12:05:05.020 INFO - Site: win-container-demo - Container started successfully
6 - Lokaal bijwerken en opnieuw implementeren
Open in Visual Studio, in Solution Explorer, achtereenvolgens Weergaven>Start>Index.cshtml.
Zoek ergens bovenaan de HTML-tag
<div class="jumbotron">
en vervang het volledige element door de volgende code:<div class="jumbotron"> <h1>ASP.NET in Azure!</h1> <p class="lead">This is a simple app that we've built that demonstrates how to deploy a .NET app to Azure App Service.</p> </div>
Als u opnieuw wilt implementeren in Azure, klikt u in Solution Explorer met de rechtermuisknop op het project myfirstazurewebapp, en kiest u Publiceren.
Selecteer op de pagina Publiceren de knop Publiceren en wacht tot het publiceren is voltooit.
Als u wilt dat App Service de nieuwe installatiekopie ophaalt uit Docker Hub, moet u de app opnieuw starten. Klik als u terugbent in de app-pagina in de portal op Opnieuw starten>Ja.
Blader opnieuw naar de aangepaste container . Nadat de webpagina is vernieuwd, moet de app eerst teruggaan naar de pagina 'Starting up' en dan na een paar minuten opnieuw de bijgewerkte webpagina weergeven.
7 - Resources opschonen
In de voorgaande stappen hebt u Azure-resources in een resourcegroep gemaakt. Als u deze resources in de toekomst waarschijnlijk niet nodig hebt, kunt u ze verwijderen door de resourcegroep te verwijderen.
Selecteer Resourcegroepen in het menu of op de beginpagina van de Azure-portal. Selecteer myResourceGroup op de pagina Resourcegroepen.
Controleer op de pagina myResourceGroup of de weergegeven resources de resources zijn die u wilt verwijderen.
Selecteer Resourcegroep verwijderen, typ myResourceGroup in het tekstvak om dit te bevestigen en selecteer Verwijderen.
Volgende stappen
Azure-app Service op Linux biedt vooraf gedefinieerde toepassingsstacks op Linux met ondersteuning voor talen zoals .NET, PHP, Node.js en andere. U kunt ook een aangepaste Docker-installatiekopieën gebruiken om uw web-app uit te voeren op een toepassingsstack die nog niet is gedefinieerd in Azure. In deze quickstart ziet u hoe u een installatiekopie van een Azure Container Registry (ACR) implementeert in App Service.
Notitie
Zie Container Apps voor informatie over het uitvoeren van toepassingen in containers in een serverloze omgeving.
U hebt het volgende nodig om deze snelstartgids te voltooien:
- Een Azure-account
- Docker
- Visual Studio Code
- De Azure App Service-extensie voor VS Code. U kunt deze extensie gebruiken voor het maken, beheren en implementeren van Linux-web-apps in het Platform-as-a-Service van Azure (PaaS).
- De Docker-extensie voor VS Code. U kunt deze extensie gebruiken om het beheer te vereenvoudigen van lokale Docker-installatiekopieën en -opdrachten en om installatiekopieën van gebouwde apps te implementeren in Azure.
1 - Een containerregister maken
In deze quickstart wordt Azure Container Registry gebruikt als het gewenste register. U kunt andere registers gebruiken, maar de stappen kunnen enigszins verschillen.
Maak een containerregister door de instructies in quickstart te volgen: Een privécontainerregister maken met behulp van Azure Portal.
Belangrijk
Zorg ervoor dat u de optie Gebruiker met beheerdersrechten instelt op Inschakelen wanneer u het Azure-containerregister maakt. U kunt deze optie ook instellen in de sectie Toegangssleutels van de registerpagina in Azure Portal. Deze instelling is vereist voor toegang tot App Service. Zie Implementeren vanuit ACR-zelfstudie voor beheerde identiteiten.
2 - Aanmelden
Start Visual Studio Code.
Selecteer het Azure-logo op de activiteitenbalk, navigeer naar de APP SERVICE-verkenner en selecteer vervolgens Aanmelden bij Azure en volg de instructies.
Controleer op de statusbalk onderaan het e-mailadres van uw Azure-account. In de APP SERVICE-verkenner moet uw abonnement worden weergegeven.
Selecteer in de activiteitenbalk het Docker-logo . Controleer in de verkenner van REGISTERS of het containerregister dat u hebt gemaakt, wordt weergegeven.
3 - Vereisten controleren
Controleer of Docker is geïnstalleerd en wordt uitgevoerd. Met de volgende opdracht wordt de Docker-versie weergegeven als deze wordt uitgevoerd.
docker --version
4 - Installatiekopieën maken en bouwen
- Open in Visual Studio Code een lege map en voeg een bestand toe met de naam
Dockerfile
. Plak in het Dockerfile de inhoud op basis van het gewenste taalframework:
FROM mcr.microsoft.com/appsvc/dotnetcore:lts
ENV PORT 8080
EXPOSE 8080
ENV ASPNETCORE_URLS "http://*:${PORT}"
ENTRYPOINT ["dotnet", "/defaulthome/hostingstart/hostingstart.dll"]
In dit Dockerfile is de bovenliggende installatiekopie een van de ingebouwde .NET-containers van App Service.
Open het opdrachtpalet en typ Docker-installatiekopieën: build-installatiekopie. Typ Enter om de opdracht uit te voeren.
Geef in het vak afbeeldingstag de gewenste tag op in de volgende indeling:
<acr-name>.azurecr.io/<image-name>:<tag>
, waar<acr-name>
is de naam van het containerregister dat u hebt gemaakt. Druk op Enter.Wanneer de installatiekopie is voltooid, klikt u op Vernieuwen bovenaan de AFBEELDINGENverkenner en controleert u of de installatiekopie is gemaakt.
5 - Implementeren in containerregister
Klik op de activiteitenbalk op het Docker-pictogram . Zoek in images explorer de installatiekopie die u hebt gemaakt.
Vouw de afbeelding uit, klik met de rechtermuisknop op de gewenste tag en klik op Push.
Zorg ervoor dat de afbeeldingstag begint en
<acr-name>.azurecr.io
druk op Enter.Wanneer Visual Studio Code klaar is met het pushen van de installatiekopieën naar uw containerregister, klikt u boven aan de verkenner van REGISTERS op Vernieuwen en controleert u of de installatiekopieën zijn gepusht.
6 - Implementeren in App Service
- Vouw in REGISTRIES Explorer de installatiekopieën uit, klik met de rechtermuisknop op de tag en selecteer Installatiekopieën implementeren in Azure-app Service.
- Volg de aanwijzingen om een abonnement, een wereldwijd unieke app-naam, een resourcegroep en een App Service-plan te kiezen. Kies B1 Basic voor de prijscategorie en een regio bij u in de buurt.
Na de implementatie is uw app beschikbaar op http://<app-name>.azurewebsites.net
.
Een resourcegroep is een benoemde verzameling van alle resources van uw toepassing in Azure. Een resourcegroep kan bijvoorbeeld een verwijzing naar een website, een database en een Azure-functie bevatten.
Een App Service-plan definieert de fysieke resources die worden gebruikt voor het hosten van uw website. In deze quickstart wordt gebruikgemaakt van een Basic-hostingsabonnement op Linux-infrastructuur, wat betekent dat de site wordt gehost op een Linux-computer naast andere websites. Als u begint met het Basic-abonnement, kunt u omhoog schalen met behulp van Azure Portal zodat u de enige site bent die op een computer wordt uitgevoerd. Zie App Service-prijzen voor prijzen.
7 - Door de website bladeren
In het deelvenster Uitvoer ziet u de status van de implementatiebewerkingen. Wanneer de bewerking is voltooid, selecteert u Site openen in de pop-upmelding om de site in uw browser te openen.
8 - Resources opschonen
In de voorgaande stappen hebt u Azure-resources in een resourcegroep gemaakt. Als u deze resources in de toekomst waarschijnlijk niet nodig hebt, kunt u ze verwijderen door de resourcegroep te verwijderen.
Selecteer Resourcegroepen in het menu of op de beginpagina van de Azure-portal. Selecteer myResourceGroup op de pagina Resourcegroepen.
Controleer op de pagina myResourceGroup of de weergegeven resources de resources zijn die u wilt verwijderen.
Selecteer Resourcegroep verwijderen, typ myResourceGroup in het tekstvak om dit te bevestigen en selecteer Verwijderen.
Volgende stappen
Gefeliciteerd, u hebt deze quickstart voltooid.
De App Service-app haalt elke keer dat deze wordt gestart uit het containerregister op. Als u de installatiekopie opnieuw opbouwt, hoeft u deze alleen naar het containerregister te pushen en wordt de app opgehaald in de bijgewerkte installatiekopie wanneer deze opnieuw wordt opgestart. Als u wilt weten dat uw app de bijgewerkte installatiekopie onmiddellijk moet ophalen, start u deze opnieuw.
Andere Azure-extensies:
- Azure Cosmos DB
- Azure Functions
- Azure CLI-hulpprogramma's
- Azure Resource Manager-hulpprogramma’s
- Het uitbreidingspakket voor Azure Tools bevat alle bovenstaande extensies.
Azure-app Service op Linux biedt vooraf gedefinieerde toepassingsstacks op Linux met ondersteuning voor talen zoals .NET, PHP, Node.js en andere. U kunt ook een aangepaste Docker-installatiekopieën gebruiken om uw web-app uit te voeren op een toepassingsstack die nog niet is gedefinieerd in Azure. In deze quickstart ziet u hoe u een installatiekopieën van Azure Container Registry implementeert in Azure-app Service.
Notitie
Zie Container Apps voor informatie over het uitvoeren van toepassingen in containers in een serverloze omgeving.
U hebt het volgende nodig om deze snelstartgids te voltooien:
1 - Kloon de voorbeeldopslagplaats
Kloon de .NET 6.0-voorbeeld-app met de volgende opdracht:
git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git
2 - Push de installatiekopieën naar Azure Container Registry
Zorg ervoor dat u zich in de hoofdmap van de gekloonde opslagplaats bevindt. Deze opslagplaats bevat een Dockerfile.linux-bestand .
Meld u aan bij de Azure CLI.
az login
Meld u aan bij Azure Container Registry.
az acr login -n <your_registry_name>
Bouw de containerinstallatiekopieën. We noemen de installatiekopie dotnetcore-docs-hello-world-linux.
docker build -f Dockerfile.linux -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux .
Push de containerinstallatiekopieën naar Azure Container Registry.
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux:latest
3 - Implementeren in Azure
Meld u aan bij de Azure-portal
Meld u aan bij het Azure-portaal.
Azure-resources maken
Typ app-services in de zoekopdracht. Selecteer App Services onder Services.
Selecteer + Maken op de pagina App Services.
Controleer op het tabblad Basisbeginselen onder Projectdetails of het juiste abonnement is geselecteerd en selecteer vervolgens om een nieuwe resourcegroep te maken. Typ myResourceGroup als de naam.
Typ onder Instantiedetails een wereldwijd unieke naam voor uw web-app en selecteer Docker-container. Selecteer Linux voor het besturingssysteem. Selecteer een regio waaruit u uw app wilt leveren.
Selecteer onder App Service-plan het nieuwe App Service-plan maken. Typ myAppServicePlan als naam. Als u wilt overschakelen naar de gratis laag, selecteert u Grootte wijzigen, selecteert u het tabblad Dev/Test, selecteert u F1 en selecteert u de knop Toepassen onder aan de pagina.
Selecteer de knop Volgende: Docker > onderaan de pagina.
Selecteer op het tabblad Docker enkele container onder Opties en Azure Container Registry voor de installatiekopieënbron. Stel onder Azure Container Registry-opties de volgende waarden in:
- Register: Selecteer uw Azure Container Registry.
- Afbeelding: Selecteer dotnetcore-docs-hello-world-linux.
- Tag: Selecteer de meest recente.
Selecteer de knop Beoordelen en maken onder aan de pagina.
Nadat de validatie is uitgevoerd, selecteert u de knop Maken onder aan de pagina.
Nadat de implementatie is voltooid, selecteert u Ga naar de resource.
4 - Blader naar de app
Blader naar de geïmplementeerde toepassing in uw webbrowser op de URL http://<app-name>.azurewebsites.net
.
5 - Resources opschonen
In de voorgaande stappen hebt u Azure-resources in een resourcegroep gemaakt. Als u deze resources in de toekomst waarschijnlijk niet nodig hebt, kunt u ze verwijderen door de resourcegroep te verwijderen.
Selecteer Resourcegroepen in het menu of op de beginpagina van de Azure-portal. Selecteer myResourceGroup op de pagina Resourcegroepen.
Controleer op de pagina myResourceGroup of de weergegeven resources de resources zijn die u wilt verwijderen.
Selecteer Resourcegroep verwijderen, typ myResourceGroup in het tekstvak om dit te bevestigen en selecteer Verwijderen.
Volgende stappen
Gefeliciteerd, u hebt deze quickstart voltooid.
De App Service-app haalt elke keer dat deze wordt gestart uit het containerregister op. Als u de installatiekopie opnieuw opbouwt, hoeft u deze alleen naar het containerregister te pushen en wordt de app opgehaald in de bijgewerkte installatiekopie wanneer deze opnieuw wordt opgestart. Als u wilt weten dat uw app de bijgewerkte installatiekopie onmiddellijk moet ophalen, start u deze opnieuw.
Azure App Service biedt vooraf gedefinieerde toepassingsstacks in Windows, zoals ASP.NET of Node.js, die worden uitgevoerd in IIS. De vooraf geconfigureerde toepassingsstacks vergrendelen het besturingssysteem echter en voorkomen toegang op laag niveau. Aangepaste Windows-containers hebben deze beperkingen niet en stellen ontwikkelaars in staat om de containers volledig aan te passen en toepassingen in containers volledige toegang te geven tot Windows-functionaliteit.
In deze quickstart ziet u hoe u een ASP.NET-app in een Windows-installatiekopieën implementeert vanuit Azure Container Registry naar Azure-app Service.
U hebt het volgende nodig om deze snelstartgids te voltooien:
- Een Azure-account
- Een Azure-containerregister
- Azure-CLI
- Docker voor Windows installeren
- Docker overschakelen om Windows-containers uit te voeren
1 - Kloon de voorbeeldopslagplaats
Kloon de .NET 6.0-voorbeeld-app met de volgende opdracht:
git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git
2 - Push de installatiekopieën naar Azure Container Registry
Zorg ervoor dat u zich in de hoofdmap van de gekloonde opslagplaats bevindt. Deze opslagplaats bevat een Dockerfile.windows-bestand . We gebruiken Windows Nano Server Long Term Servicing Channel (LTSC) 2022 als het basisbesturingssysteem, waarbij we onze Windows-basis expliciet aanroepen.
Notitie
Hoewel dit een Windows-container is, moeten de paden nog steeds slashes gebruiken. Zie Een Dockerfile schrijven voor meer informatie.
Meld u aan bij de Azure CLI.
az login
Meld u aan bij Azure Container Registry.
az acr login -n <your_registry_name>
Bouw de containerinstallatiekopieën. We noemen de afbeelding dotnetcore-docs-hello-world-windows.
docker build -f Dockerfile.windows -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows .
Push de containerinstallatiekopieën naar Azure Container Registry.
docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows:latest
3 - Implementeren in Azure
Meld u aan bij de Azure-portal
Meld u aan bij het Azure-portaal.
Azure-resources maken
Typ app-services in de zoekopdracht. Selecteer App Services onder Services.
Selecteer + Maken op de pagina App Services.
Controleer op het tabblad Basisbeginselen onder Projectdetails of het juiste abonnement is geselecteerd en selecteer vervolgens om een nieuwe resourcegroep te maken. Typ myResourceGroup als de naam.
Typ onder Instantiedetails een wereldwijd unieke naam voor uw web-app en selecteer Docker-container. Selecteer Windows voor het besturingssysteem. Selecteer een regio waaruit u uw app wilt leveren.
Selecteer onder App Service-plan het nieuwe App Service-plan maken. Typ myAppServicePlan als naam. Als u wilt overschakelen naar de gratis laag, selecteert u Grootte wijzigen, selecteert u het tabblad Dev/Test, selecteert u P1v3 en selecteert u de knop Toepassen onder aan de pagina.
Selecteer de knop Volgende: Docker > onderaan de pagina.
Selecteer op het tabblad Docker Azure Container Registry voor de installatiekopieënbron. Stel onder Azure Container Registry-opties de volgende waarden in:
- Register: Selecteer uw Azure Container Registry.
- Afbeelding: Selecteer dotnetcore-docs-hello-world-windows.
- Tag: Selecteer de meest recente.
Selecteer de knop Beoordelen en maken onder aan de pagina.
Nadat de validatie is uitgevoerd, selecteert u de knop Maken onder aan de pagina.
Nadat de implementatie is voltooid, selecteert u Ga naar de resource.
4 - Blader naar de app
Blader naar de geïmplementeerde toepassing in uw webbrowser op de URL http://<app-name>.azurewebsites.net
.
Houd er rekening mee dat het hostbesturingssysteem wordt weergegeven in de voettekst, waarbij wordt bevestigd dat we worden uitgevoerd in een Windows-container.
5 - Resources opschonen
In de voorgaande stappen hebt u Azure-resources in een resourcegroep gemaakt. Als u deze resources in de toekomst waarschijnlijk niet nodig hebt, kunt u ze verwijderen door de resourcegroep te verwijderen.
Selecteer Resourcegroepen in het menu of op de beginpagina van de Azure-portal. Selecteer myResourceGroup op de pagina Resourcegroepen.
Controleer op de pagina myResourceGroup of de weergegeven resources de resources zijn die u wilt verwijderen.
Selecteer Resourcegroep verwijderen, typ myResourceGroup in het tekstvak om dit te bevestigen en selecteer Verwijderen.
Volgende stappen
Gefeliciteerd, u hebt deze quickstart voltooid.
De App Service-app haalt elke keer dat deze wordt gestart uit het containerregister op. Als u de installatiekopie opnieuw opbouwt, hoeft u deze alleen naar het containerregister te pushen en wordt de app opgehaald in de bijgewerkte installatiekopie wanneer deze opnieuw wordt opgestart. Als u wilt weten dat uw app de bijgewerkte installatiekopie onmiddellijk moet ophalen, start u deze opnieuw.
Azure App Service biedt vooraf gedefinieerde toepassingsstacks in Windows, zoals ASP.NET of Node.js, die worden uitgevoerd in IIS. De vooraf geconfigureerde toepassingsstacks vergrendelen het besturingssysteem echter en voorkomen toegang op laag niveau. Aangepaste Windows-containers hebben deze beperkingen niet en stellen ontwikkelaars in staat om de containers volledig aan te passen en toepassingen in containers volledige toegang te geven tot Windows-functionaliteit.
In deze quickstart ziet u hoe u een ASP.NET-app in een Windows-installatiekopieën implementeert van Microsoft-artefactregister naar Azure-app Service.
U hebt het volgende nodig om deze snelstartgids te voltooien:
- Een Azure-account met een actief abonnement. Gratis een account maken
- Azure PowerShell.
1 - Verbinding maken met Azure
Meld u aan bij uw Azure-account met behulp van de Connect-AzAccount
opdracht en volg de prompt:
Connect-AzAccount
2 - Een resourcegroep maken
Maak een resourcegroep met de opdracht New-AzResourceGroup. Een Azure-resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd.
In het volgende voorbeeld wordt een resourcegroep met de naam myResourceGroup gemaakt op de locatie VS - oost. Als u alle ondersteunde locaties voor App Service wilt zien, voert u de opdracht Get-AzLocation
uit.
New-AzResourceGroup -Name myResourceGroup -Location eastus
De opdracht retourneert Login Succeeded
nadat deze is voltooid.
3 - Uw App Service-plan maken
Maak een nieuw App Service-plan met behulp van de opdracht New-AzAppServicePlan .
In het volgende voorbeeld wordt een App Service-plan gemaakt met de naam myAppServicePlan
in de prijscategorie PremiumV3 (-Tier PremiumV3
). Met de -HyperV
parameter wordt een Windows-container opgegeven.
New-AzAppServicePlan -Name myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -Tier PremiumV3 -HyperV
4 - Uw web-app maken
Maak een nieuwe app met behulp van de opdracht New-AzWebApp :
New-AzWebApp -Name myWebApp -AppServicePlan myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -ContainerImageName mcr.microsoft.com/azure-app-service/windows/parkingpage:latest
- Met de parameter Naam geeft u de naam van de web-app op.
- De parameter AppServicePlan geeft de naam van het App Service-plan op.
- De parameter Locatie geeft de locatie op.
- De parameter ResourceGroupName geeft de naam van de resourcegroep op.
- De parameter ContainerImageName geeft een containerinstallatiekopienaam en een optionele tag op.
Het kan enkele minuten duren voordat de opdracht is voltooid.
5 - Blader naar de app
Blader naar de geïmplementeerde toepassing in uw webbrowser op de URL http://<app-name>.azurewebsites.net
.
6 - Resources opschonen
Verwijder de resourcegroep met behulp van de opdracht Remove-AzResourceGroup :
Remove-AzResourceGroup myResourceGroup
Volgende stappen
Gefeliciteerd, u hebt deze quickstart voltooid.
De App Service-app haalt elke keer dat deze wordt gestart uit het containerregister op. Als u de installatiekopie opnieuw opbouwt, hoeft u deze alleen naar het containerregister te pushen en wordt de app opgehaald in de bijgewerkte installatiekopie wanneer deze opnieuw wordt opgestart. Als u wilt weten dat uw app de bijgewerkte installatiekopie onmiddellijk moet ophalen, start u deze opnieuw.
Azure App Service biedt vooraf gedefinieerde toepassingsstacks in Windows, zoals ASP.NET of Node.js, die worden uitgevoerd in IIS. De vooraf geconfigureerde toepassingsstacks vergrendelen het besturingssysteem echter en voorkomen toegang op laag niveau. Aangepaste Windows-containers hebben deze beperkingen niet en stellen ontwikkelaars in staat om de containers volledig aan te passen en toepassingen in containers volledige toegang te geven tot Windows-functionaliteit.
In deze quickstart ziet u hoe u een ASP.NET-app in een Windows-installatiekopieën implementeert van Microsoft-artefactregister naar Azure-app Service.
U hebt het volgende nodig om deze snelstartgids te voltooien:
- Een Azure-account met een actief abonnement. Gratis een account maken
- Azure-CLI
1 - Verbinding maken met Azure
Meld u aan bij uw Azure-account met behulp van de az login
opdracht en volg de prompt:
az login
2 - Een resourcegroep maken
Maak een resourcegroep met de opdracht az group create
. Een Azure-resourcegroep is een logische container waarin Azure-resources worden geïmplementeerd en beheerd.
In het volgende voorbeeld wordt een resourcegroep met de naam myResourceGroup gemaakt op de locatie VS - oost. Als u alle ondersteunde locaties voor App Service wilt zien, voert u de opdracht az appservice list-locations
uit.
az group create --name myResourceGroup --location eastus
3 - Uw App Service-plan maken
Maak een App Service-plan in de resourcegroep met de az appservice plan create
opdracht.
In het volgende voorbeeld wordt een App Service-plan gemaakt met de naam myAppServicePlan
in de P1V3-prijscategorie (--sku P1V3
).
az appservice plan create --resource-group myResourceGroup --location eastus --name myAppServicePlan --hyper-v --sku p1v3
Notitie
Als u de fout 'Het gedrag van deze opdracht is gewijzigd door de volgende extensie: appservice-kube', verwijdert u de appservice-kube
extensie.
4 - Uw web-app maken
Maak een aangepaste containerweb-app in het myAppServicePlan
App Service-plan met de opdracht az webapp create. Vergeet niet om myContainerApp te vervangen door een unieke app-naam (geldige tekens zijn a-z
, 0-9
en -
).
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
- Met de parameter Naam geeft u de naam van de web-app op.
- De parameter AppServicePlan geeft de naam van het App Service-plan op.
- De parameter Locatie geeft de locatie op.
- De parameter ResourceGroupName geeft de naam van de resourcegroep op.
- De parameter deployment-container-image-name geeft een containerinstallatiekopieënnaam en optionele tag op.
5 - Blader naar de app
Blader naar de geïmplementeerde toepassing in uw webbrowser op de URL http://<app-name>.azurewebsites.net
.
6 - Resources opschonen
Verwijder de resourcegroep met behulp van de opdracht az group delete :
az group delete --no-wait --name <resource_group>
Volgende stappen
Gefeliciteerd, u hebt deze quickstart voltooid.
De App Service-app haalt elke keer dat deze wordt gestart uit het containerregister op. Als u de installatiekopie opnieuw opbouwt, hoeft u deze alleen naar het containerregister te pushen en wordt de app opgehaald in de bijgewerkte installatiekopie wanneer deze opnieuw wordt opgestart. Als u wilt weten dat uw app de bijgewerkte installatiekopie onmiddellijk moet ophalen, start u deze opnieuw.