Distribuera hanterad instans på Azure App Service

Managed Instance i Azure App Service kombinerar enkelheten i plattform som en tjänst med flexibiliteten i kontrollen på infrastrukturnivå. Managed Instance är utformad för applikationer som kräver OS-anpassning, privat nätverk och säker integration med Azure-tjänster.

Viktigt!

Managed Instance finns generellt tillgängligt för Windows-webbappar i utvalda regioner och är begränsat till prisplaner för Pv4 och Pmv4. Microsoft kommer att lägga till fler regioner över tid. Managed Instance stöder inte Linux och containrar.

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 Managed Instance på Azure App Service.
3. Distribuera en exempelapp.
4. Kontrollera driftsättningen.

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.

• Hanterad identitet

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

• Valfritt konfigurationsskript (installations-)skript: Denna quickstart använder ett PowerShell-skript namngivet Install.ps1 i en komprimerad .zip fil för att installera typsnitt. Konfigurationsskript är inte obligatoriska för Managed Instance. Använd ett konfigurationsskript när din applikation kräver beroenden, operativsystemsnivåroller, funktioner eller konfiguration, eller persistenta ändringar som annars skulle gå förlorade efter en omstart av instansen. Använd RDP för diagnostik istället för persistent konfiguration.

Distribuera exempelresurser

Du kan snabbt distribuera alla nödvändiga resurser i denna quickstart genom att använda Azure Developer CLI (AZD). AZD-mallen som används i den här snabbstarten kommer från Azure-exempel.

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 Storage-Blob-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-typsnittsfiler till C:\Windows\Fonts. Exempelappen du använder använder dessa typsnitt.

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

Slutresultatet från azd up 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 en 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 Web App (för Managed Instance) i resultaten.
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

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

Cloud Shell

1. Följande kommando skapar Managed Instance-planen med ett konfigurationsskript (installationsskript).

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

Driftsättningen tar flera minuter medan resurserna etableras.

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 abonnemanget för Managed Instance

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