Distribuera hanterad instans i Azure App Service (förhandsversion)

Managed Instance i Azure App Service kombinerar enkelheten i plattform som en tjänst med flexibiliteten i kontrollen på infrastrukturnivå. Managed Instance är utformat för program som kräver isolering på plannivå, anpassning och säker nätverksintegrering.

Viktigt!

Hanterad instans är i förhandsversion, tillgänglig för Windows-webbappar i utvalda regioner och begränsad till Pv4- och Pmv4-prisplaner. Fler regioner att följa. Linux och containrar stöds inte.

I den här snabbstarten slutför du följande steg:

1. Använd Azure Developer CLI för att distribuera exempelresurser.
2. Skapa en hanterad instans i Azure App Service (förhandsversion).
3. Distribuera en exempelapp.
4. Verifiera distributionen.

Förutsättningar

• Azure-konto: Du behöver ett Azure-konto med en aktiv prenumeration. Om du inte redan har ett konto kan du skapa ett konto kostnadsfritt.

• Åtkomst till de godkända regionerna: Under förhandsversionen omfattar regioner för Hanterad instans: Asien, östra, USA, östra, Europa, norra och USA, västra centrala. Fler regioner att följa.

• Hanterad identitet

• Snabbstart: Ladda upp, ladda ned och lista blobar med Azure-portalen

• Konfigurationsskript (installera) (PowerShell-skript med namnet Install.ps1) i en komprimerad .zip fil

Distribuera exempelresurser

Du kan snabbt distribuera alla nödvändiga resurser i den här snabbstarten med Hjälp av Azure Developer CLI (AZD). AZD-mallen som används i den här snabbstarten kommer från Azure-exempel. Kör bara följande kommandon i Azure Cloud Shell och följ anvisningarna:

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

Kommandot azd up utför följande åtgärder:

1. Skapar en användartilldelad hanterad identitet.
2. Skapar en Azure Storage-blob.
3. Tilldelar den hanterade identiteten till lagringscontainern och managed instance-planen.
4. Ger lagringsblob–Data-Contributor åtkomst till lagringscontainern.
5. Komprimerar inkluderade teckensnitt och Install.ps1 i scripts.zip.
6. Ladda upp scripts.zip till lagringscontainern.

Anmärkning

Konfigurationsskriptpaketet (scripts.zip) som distribueras med exempelresurserna innehåller Install.ps1, som kopierar Microsoft Aptos-teckensnittsfiler till C:\Windows\Fonts. Exempelappen som du distribuerar senare renderar text till en bild med hjälp av dessa teckensnitt. Den här processen visar hur ett konfigurationsskript för hanterad instans (installation) kan fastställa beroenden på operativsystemnivå eller ramverk innan appkoden körs.

Följande PowerShell-kod är konfigurationsskriptet (installera) som används i mallen.

# 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 slutliga utdata azd up för bör se ut ungefär som i följande exempel.

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

Värdena för Storage Account, Container Name, Managed Identity Client name, Resource Groupoch Script URI används senare.

Distribuera en plan för hanterad instans

Följ dessa steg för att skapa en hanterad instansplan och distribuera en app till den:

Azure Portal

1. Logga in på Azure-portalen.
2. Välj + Skapa en resurs.
3. Sök efter hanterad instans
4. Välj Webbapp (för Hanterad instans) (förhandsversion) i resultatet.
5. Välj Skapa för att starta skapandeprocessen.
6. På fliken Grundläggande anger du följande information.

Projektinformation

Inställning	Värde
Subscription	Din Azure-prenumeration
Resursgrupp	rg-managed-instance

Appinformation

Inställning	Värde
Namn	contoso-mi-app
Körningstack	ASPNET V4.8
Region	En region nära dig

Prisplaner

Inställning	Värde
Windows-plan	Använd standardplanen eller skapa en ny (till exempel "contoso-mi-plan")
Prisplaner*	Välj en prisplan. Om Pv4 eller Pmv4 inte visas i prisplaner bekräftar du regionens tillgänglighet eller begär mer kvot.

Ange följande information på fliken Avancerat.

Konfigurationsskript (installation)

Inställning	Värde
Lagringskonto	Använd standardplanen eller skapa en ny (till exempel "contoso-mi-plan")
Container	Skript
Zip-fil	scripts.zip
Värde	Kontrollera att url:en för .zip är korrekt
Identitet	Välj den hanterade identitet som skapades tidigare

1. Välj Granska + skapa och välj därpå Skapa.

Cloud Shell

1. Följande kommando skapar planen för hanterad instans med ett konfigurationsskript (installera).

az deployment group create \
  --resource-group "<resource-group-name>" \
  --template-file infra/app-service-plan-managed-instance.json \
  --parameters \
    location="<location>" \
    appServicePlanName="<plan-name>" \
    userAssignedIdentityResourceId="<identity-id>" \
    installScriptSourceUri="<script-URI>" \
    skuName=P1V4 \
    skuCapacity=1

Distributionen tar flera minuter medan resurserna har etablerats.

1. Följande kommando skapar en webbapp i planen för hanterad instans.

az webapp create \
  --name "<app-name>" \
  --resource-group "<resource-group-name>" \
  --plan "<plan-name>" \
  --runtime "ASPNET:V4.8"

1. Följande kommando tilldelar en hanterad identitet till webbappen.

az webapp identity assign \
  --name "<app-name>" \
  --resource-group "<resource-group-name>" \
  --identities "<identity-id>"

Distribuera en exempelapp till Managed Instance

I det här steget använder du Cloud Shell för att distribuera en exempelapp som ingick i AZD-mallen till Managed Instance.

• Följande kommando distribuerar webbappen till din managed instance-plan. Uppdatera <app-name> och <resource-group> med dina värden.

az webapp deploy \
  --resource-group "<resource-group-name>" \
  --name "<app-name>" \
  --src-path app.zip \
  --type zip

Bläddra till appen

Om du vill bläddra till den skapade appen väljer du standarddomänen på sidan Översikt .

.NET-appen körs på en hanterad instansplan. Appen använder teckensnitt från katalogen C:\Windows\Fonts.

Hantera planen för hanterad instans

Om du vill hantera din webbapp går du till Azure Portal och söker efter och väljer App Services.

På sidan App Services väljer du namnet på din webbapp.

På sidan Översikt väljer du namnet på din App Service-plan. Under Aktuell App Service-plan väljer du plannamnet.

I den vänstra menyn under Inställningar väljer du Konfiguration för att visa konfigurationsinformationen.

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.

Azure Portal

1. Från ditt webbprograms Översiktsida i Azure portal väljer du länken myResourceGroup under resursgruppen.
2. Kontrollera att resurser på resursgruppsidan är de som du vill ta bort.
3. Välj Ta bort resursgrupp, skriv myResourceGroup i textrutan och välj sedan Ta bort.
4. Bekräfta igen genom att välja Ta bort.

Cloud Shell

az group delete

Relaterat innehåll

• Konfigurera hanterad instans
• Översikt över App Service
• Säkerhet i App Service
• Jämförelse av App Service Environment