Delen via


Managed Instance implementeren in Azure App Service (preview)

Managed Instance in Azure App Service combineert de eenvoud van platform als een service met de flexibiliteit van beheer op infrastructuurniveau. Managed Instance is ontworpen voor toepassingen waarvoor isolatie op planniveau, aanpassing en beveiligde netwerkintegratie is vereist.

Belangrijk

Managed Instance is in preview, beschikbaar voor Windows-web-apps in bepaalde regio's en beperkt tot Pv4- en Pmv4-prijsplannen. Meer regio's om te volgen. Linux en containers worden niet ondersteund.

In deze quickstart voert u de volgende stappen uit:

  1. Gebruik Azure Developer CLI om voorbeeldbronnen te implementeren.
  2. Een beheerd exemplaar maken in Azure App Service (preview).
  3. Een voorbeeld-app implementeren.
  4. De implementatie controleren.

Vereiste voorwaarden

Voorbeeldbronnen implementeren

U kunt snel alle benodigde resources in deze quickstart implementeren met behulp van Azure Developer CLI (AZD). De AZD-sjabloon die in deze quickstart wordt gebruikt, is afkomstig uit Azure-voorbeelden. Voer de volgende opdrachten uit in Azure Cloud Shell en volg de aanwijzingen:

mkdir managed-instance-quickstart
cd managed-instance-quickstart
azd init --template https://github.com/Azure-Samples/managed-instance-azure-app-service-quickstart.git
azd env set AZURE_LOCATION northeurope
azd up

Met de opdracht azd up worden de volgende acties uitgevoerd:

  1. Hiermee maakt u een door de gebruiker toegewezen beheerde identiteit.
  2. Hiermee maakt u een Azure Storage-blob.
  3. Hiermee wordt de beheerde identiteit toegewezen aan de opslagcontainer en het beheerde exemplaarplan.
  4. Verleent Storage-Blob-Data-Contributor toegang tot de opslagcontainer.
  5. Comprimeert opgenomen lettertypen en Install.ps1 in scripts.zip.
  6. Upload scripts.zip naar de opslagcontainer.

Opmerking

Het configuratiescriptpakket (scripts.zip) dat is geïmplementeerd met de voorbeeldbronnen bevat Install.ps1, waarmee Microsoft Aptos-lettertypebestanden worden gekopieerd naar C:\Windows\Fonts. De voorbeeld-app die u later implementeert, geeft tekst weer in een afbeelding met behulp van deze lettertypen. Dit proces laat zien hoe een script voor de configuratie (installatie) van een beheerd exemplaar afhankelijkheden op besturingssysteem- of frameworkniveau kan vastleggen voordat de app-code wordt uitgevoerd.

De volgende PowerShell-code is het configuratiescript (installeren) dat in de sjabloon wordt gebruikt.

# Install.ps1 - Copy and register fonts on Managed Instance
Write-Host "Installing custom fonts on Managed Instance..." -ForegroundColor Green

# Copy all TTF and OTF fonts to Windows Fonts folder and register them
Get-ChildItem -Recurse -Include *.ttf, *.otf | ForEach-Object {
    $FontFullName = $_.FullName
    $FontName = $_.BaseName + " (TrueType)"
    $Destination = "$env:windir\Fonts\$($_.Name)"

    Write-Host "Installing font: $($_.Name)"
    Copy-Item $FontFullName -Destination $Destination -Force
    New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts" -Name $FontName -PropertyType String -Value $_.Name -Force | Out-Null
}

Write-Host "Font installation completed." -ForegroundColor Green

De uiteindelijke uitvoer moet azd up er ongeveer uitzien als in het volgende voorbeeld.

=== Deployment Complete ===
Storage Account: stgpjqep6fdlfv6
Container Name: scripts
Managed Identity Client name: id-gpjqep6fdlfv6
Resource Group: rg-managed-instance

De waarden voorStorage Account, Container Name, , Managed Identity Client nameen Resource GroupScript URI worden later gebruikt.

Een beheerd exemplaarplan implementeren

Volg deze stappen om een beheerd exemplaarplan te maken en er een app in te implementeren:

  1. Meld u aan bij het Azure-portaal.
  2. Selecteer + Maak een resource aan.
  3. Zoeken naar een beheerd exemplaar
  4. Selecteer Web App (voor Managed Instance) (preview) in de resultaten.
  5. Selecteer Maken om het proces te starten.
  6. Geef op het tabblad Basis de volgende details op.

Projectgegevens

Configuratie Waarde
Subscription Uw Azure-abonnement
Resourcegroep Beheerd exemplaar van rg

App-details

Configuratie Waarde
Naam contoso-mi-app
Runtimestack ASPNET V4.8
Regio Een regio bij u in de buurt

Prijsplannen

Configuratie Waarde
Windows-abonnement Gebruik het standaardplan of maak een nieuw plan (bijvoorbeeld 'contoso-mi-plan')
Prijsplannen* Selecteer een prijsplan. Als Pv4 of Pmv4 niet zichtbaar is in prijsplannen, bevestigt u de beschikbaarheid van regio's of vraagt u meer quotum aan.

Geef op het tabblad Geavanceerd de volgende details op.

Configuratiescript (installeren)

Configuratie Waarde
Opslagaccount Gebruik het standaardplan of maak een nieuw plan (bijvoorbeeld 'contoso-mi-plan')
Container Scripts
Zipfile scripts.zip
Waarde Controleer of de .zip-URL juist is
Identiteit Selecteer de beheerde identiteit die eerder is gemaakt
  1. Selecteer Beoordelen en maken en selecteer vervolgens Maken.

Een voorbeeld-app implementeren in Managed Instance

In deze stap gebruikt u Cloud Shell om een voorbeeld-app te implementeren die is opgenomen in de AZD-sjabloon in Managed Instance.

  • Met de volgende opdracht wordt de web-app geïmplementeerd in uw Managed Instance-plan. Werk <app-name> en <resource-group> bij met uw waarden.
az webapp deploy \
  --resource-group "<resource-group-name>" \
  --name "<app-name>" \
  --src-path app.zip \
  --type zip

Navigeer naar de app

Als u naar de gemaakte app wilt bladeren, selecteert u het standaarddomein op de pagina Overzicht .

De .NET-app wordt uitgevoerd op een beheerd exemplaarplan. De app maakt gebruik van lettertypen uit de map C:\Windows\Fonts.

Schermopname van de voorbeeld-app met C:\Windows\Fonts\Aptos.TTF.

Het beheerde exemplaarplan beheren

Als u uw web-app wilt beheren, gaat u naar Azure Portal en zoekt en selecteert u App Services.

Selecteer op de pagina App Services de naam van uw web-app.

Selecteer op de pagina Overzicht de naam van uw App Service-plan. Selecteer onder Huidig App Service-plan de naam van het plan.

Selecteer In het linkermenu onder Instellingende optie Configuratie om de configuratiedetails weer te geven.

De hulpbronnen 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.

  1. Selecteer op de overzichtspagina van uw web-app in Azure Portal de koppeling myResourceGroup onder Resourcegroep.
  2. Controleer op de pagina van de resourcegroep of de weergegeven resources de resources zijn die u wilt verwijderen.
  3. Selecteer Resourcegroep verwijderen, typ myResourceGroup in het tekstvak en selecteer vervolgens Verwijderen.
  4. Bevestig het opnieuw door Verwijderen te selecteren.