Erstellen einer App Service Environment mithilfe einer Azure Resource Manager Vorlage

Eine App Service Environment v3 kann im Azure Portal oder mithilfe einer Azure Resource Manager Vorlage (ARM-Vorlage) erstellt werden.

Im Azure-Portal erstellen Sie eine App Service Environment mit einer bestimmten Konfiguration für die sofortige Bereitstellung. Wenn Sie die Umgebung im Portal erstellen, wählen Sie die unterstützenden Ressourcen gleichzeitig aus, einschließlich der Ressourcengruppe für die Bereitstellungsregion und des virtuellen Netzwerks mit Subnetz.

Wenn Sie eine App Service Environment aus einer Vorlage erstellen, greifen Sie auf eine Konfiguration zu, die für die wiederholbare Bereitstellung derselben Umgebung oder anderer App Service-Umgebungen verfügbar ist. Die Vorlage gibt den Eigenschaftensatz für die App Service Environment zusammen mit dem virtuellen Netzwerk und dem Subnetz an, das für die Bereitstellung verwendet werden soll.

In diesem Artikel werden die Schritte und die Syntax beschrieben, die Sie benötigen, um entweder ein externes App Service Environment oder ein internes Load Balancer (ILB) App Service Environment aus einer ARM-Vorlage zu erstellen.

Voraussetzungen

• Um die App Service Environment ARM-Vorlage zu erstellen, müssen Sie den zu konfigurierenden Umgebungstyp ermitteln. Sie können die Umgebung mit einem internetverwendlichen Endpunkt oder einem Endpunkt auf einer internen Adresse in einer Azure Virtual Network Instanz erstellen.

  Wenn die Umgebung mit einem internen Endpunkt erstellt wird, wird der Endpunkt von einer Azure Komponente, dem internen Lastenausgleich (ILB) bereitgestellt. Eine App Service-Umgebung mit einer internen IP-Adresse wird als ILB-App Service-Umgebung bezeichnet. Ein App Service Environment mit einem öffentlichen Endpunkt wird als External-App Service Environment bezeichnet.

• Das in der Vorlage angegebene virtuelle Netzwerk muss ein Subnetz definieren:

  • Die empfohlene Subnetzgröße besteht /24 aus 256 Adressen, um zukünftige Wachstums- und Skalierungsanforderungen zu erfüllen.
  • Das Subnetz muss leer sein, was bedeutet, dass keine Netzwerkschnittstellenkarten (NICs), virtuelle Computer, private Endpunkte usw. vorhanden sind.
  • Das Teilnetz muss an Microsoft.Web/hostingEnvironments delegiert werden.

  Denken Sie daran, dass Sie nach dem Erstellen einer App Service Environment mit der Vorlage die Subnetzgröße nicht ändern können.

• Wenn Sie eine App Service Environment aus einer ARM-Vorlage erstellen, muss sich die von Ihnen angegebene Ressourcengruppe in einer Region befinden, die über ausreichende Verfügbarkeit verfügt, um die Bereitstellung der umgebung zu unterstützen, die aus der Vorlage erstellt wurde.

Überprüfen der ARM-Vorlageneigenschaften

Der folgende JSON-Code zeigt eine einfache ARM-Vorlage, die eine App Service Environment erstellt.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "aseName": {
        "type": "string"
    },
    "subnetResourceId": {
        "type": "string"
    }
  },
  "variables": {},
  "resources": [
    "type": "Microsoft.Web/hostingEnvironments",
    "apiVersion": "2025-03-01",
    "name": "[parameters('aseName')]",
    "location": "[resourceGroup().location]",
    "kind": "ASEV3",
    "properties": {
        "internalLoadBalancingMode": "Web, Publishing",
        "virtualNetwork": {
            "id": "[parameters('subnetResourceId')]"
        },
        "networkingConfiguration": { },
        "customDnsSuffixConfiguration": { }
    },
    "identity": {
        "type": "SystemAssigned"
    }
}

In der folgenden Tabelle werden die Kerneigenschaften und andere Optionen beschrieben, die Sie zum Konfigurieren Ihrer App Service Environment verwenden können.

Erstellen der ARM-Vorlage

Erstellen Sie die Vorlage, indem Sie die folgenden Schritte ausführen:

1. Fügen Sie die ARM-Beispielvorlage in eine neue JSON-Datei ein, und ändern Sie die Eigenschaften für Ihre Konfiguration.

2. Speichern Sie die JSON-Datei, z. B. azuredeploy.json. Beachten Sie den Speicherort der Datei für die spätere Verwendung.

3. (Optional) Verschieben Sie die Parametereinstellungen aus der JSON-Vorlagendatei in eine PARAMETER-JSON-Datei, z. B. azuredeploy.parameters.json. Beachten Sie den Speicherort der Datei für die spätere Verwendung.

Bereitstellen der App-Dienstumgebung

Nachdem Sie die Vorlage vorbereitet haben, können Sie die App Service Environment mithilfe der Azure CLI aus der Vorlage erstellen.

Aktualisieren Sie die templatePath- und parameterPath-Werte, sodass sie auf die Speicherorte Ihrer ARM-Vorlagendatei und Parameterdatei auf Ihrem Rechner verweisen. Geben Sie den Namen Ihrer Ressourcengruppe für den <resource_group>-Wert ein.

templatePath="PATH/azuredeploy.json"
parameterPath="PATH/azuredeploy.parameters.json"

az deployment group create --resource-group <resource_group> --template-file $templatePath --parameters $parameterPath

Das Erstellen der App Service Environment dauert in der Regel etwa eine Stunde, aber wenn es sich um eine zonenredundante App Service Environment handelt oder die Zielregion unerwartete Anforderungen hat, kann der Erstellungsprozess mehrere Stunden dauern.

Verwandte Inhalte

• Hosten Sie eine App in einer App Service Environment
• App Service Environment Networking
• Zertifikate und die App Service Umgebung