Bereitstellen der verwalteten Instanz im Azure App Service (Vorschau)

Verwaltete Instanz in Azure App Service kombiniert die Einfachheit der Plattform als Dienst mit der Flexibilität der Steuerung auf Infrastrukturebene. Verwaltete Instanz wurde für Anwendungen entwickelt, die eine Isolation auf Planebene, Anpassung und sichere Netzwerkintegration erfordern.

In dieser Schnellstartanleitung führen Sie die folgenden Schritte aus:

1. Verwenden Sie Azure Developer CLI, um Beispielressourcen bereitzustellen.
2. Erstellen Sie eine verwaltete Instanz in Azure App Service (Vorschau).
3. Bereitstellen einer Beispiel-App.
4. Überprüfen der Bereitstellung

Voraussetzungen

• Azure-Konto: Sie benötigen ein Azure-Konto mit einem aktiven Abonnement. Falls Sie noch über keins verfügen, können Sie ein kostenloses Konto erstellen.

• Zugriff auf die genehmigten Regionen: Während der Vorschau umfassen Regionen für verwaltete Instanzen: Asien, Osten, USA, Osten, Nordeuropa und USA, Westen-Mitte. Weitere zu befolgende Regionen.

• Verwaltete Identität

• Schnellstart: Hochladen, Herunterladen und Auflisten von Blobs mit dem Azure-Portal

• Konfigurationsskripts (Installation) (PowerShell-Skript namens Install.ps1) in einer komprimierten .zip Datei

Bereitstellen von Beispielressourcen

Sie können schnell alle erforderlichen Ressourcen in dieser Schnellstartanleitung mithilfe der Azure Developer CLI (AZD) bereitstellen. Die in dieser Schnellstartanleitung verwendete AZD-Vorlage stammt aus Azure-Beispielen. Führen Sie einfach die folgenden Befehle in Azure Cloud Shell aus, und befolgen Sie die Prompts:

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

Der Befehl azd up bewirkt Folgendes:

1. Erstellen einer benutzerseitig zugewiesenen verwalteten Identität
2. Erstellt ein Azure Storage Blob.
3. Weist die verwaltete Identität dem Speichercontainer und dem Plan für verwaltete Instanzen zu.
4. Gewährt Mitwirkenden an Storage-Blobdaten Zugriff auf den Speichercontainer.
5. Komprimiert werden eingebettete Schriftarten und Install.ps1 in scripts.zip.
6. Laden Sie scripts.zip in den Speichercontainer hoch.

Der folgende PowerShell-Code ist das Konfigurationsskript (Installationsskript), das in der Vorlage verwendet wird.

# 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

Die endgültige Ausgabe sollte azd up ähnlich wie im folgenden Beispiel aussehen.

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

Die Werte für Storage Account, Container Name, Managed Identity Client name, Resource Group und Script URI werden später verwendet.

Bereitstellen eines Plans für verwaltete Instanzen

Führen Sie die folgenden Schritte aus, um einen Verwalteten Instanzplan zu erstellen und eine App dafür bereitzustellen:

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

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

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

Bereitstellen einer Beispiel-App in verwalteter Instanz

In diesem Schritt verwenden Sie Cloud Shell, um eine Beispiel-App bereitzustellen, die in der AZD-Vorlage für die verwaltete Instanz enthalten war.

• Mit dem folgenden Befehl wird die Web-App in Ihrem Plan für verwaltete Instanzen bereitgestellt. Aktualisieren Sie <app-name> und <resource-group> mit Ihren Werten.

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

Navigieren zur App

Um zur erstellten App zu navigieren, wählen Sie die Standarddomäne auf der Seite "Übersicht" aus.

Die .NET-App wird auf einem verwalteten Instanzplan ausgeführt. Die App verwendet Schriftarten aus dem Verzeichnis "C:\Windows\Fonts".

Verwalten des Plans für verwaltete Instanzen

Wechseln Sie zum Verwalten Ihrer Web-App zum Azure-Portal, und suchen Sie nach App Services. Wählen Sie diese Option anschließend aus.

Wählen Sie auf der Seite App Services den Namen Ihrer Web-App aus.

Wählen Sie auf der Seite Übersicht den Namen Ihres App Service-Plans aus. Wählen Sie unter "Aktueller App Service-Plan" den Plannamen aus.

Wählen Sie im linken Menü unter "Einstellungen" die Option "Konfiguration " aus, um die Konfigurationsdetails anzuzeigen.

Bereinigen von Ressourcen

In den vorherigen Schritten haben Sie Azure-Ressourcen in einer Ressourcengruppe erstellt. Wenn Sie diese Ressourcen in Zukunft nicht mehr benötigen, können Sie sie löschen, indem Sie die Ressourcengruppe löschen.

az group delete

Verwandte Inhalte

• Konfigurieren einer verwalteten Instanz
• Übersicht über den App-Dienst
• Sicherheit im App-Dienst
• Vergleich der App-Dienstumgebung