Erstellen einer App Service-Umgebung mithilfe einer Azure Resource Manager Vorlage

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

Im Azure-Portal erstellen Sie eine App Service-Umgebung 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.

Das Erstellen einer App Service-Umgebung und das Erstellen einer Webanwendung im Azure-Portal sind getrennte Operationen. Sie müssen warten, bis die Umgebungsbereitstellung abgeschlossen ist, bevor Sie eine Webanwendung und deren App-Service-Plan in dieser Umgebung erstellen.

Wenn Sie eine App Service-Umgebung 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-Umgebung zusammen mit dem virtuellen Netzwerk und dem Subnetz an, das für die Bereitstellung verwendet werden soll.

Im Gegensatz zum Workflow zur Erstellung von Portal-Webanwendungen kann eine ARM- oder Bicep-Vorlage die App Service-Umgebung, den App-Service-Plan und die Web-App gemeinsam in einer einzigen Bereitstellung bereitstellen, wobei Ressourcenabhängigkeiten die Erstellungsreihenfolge steuern. Beispiele finden sich in den App Service-Umgebung-Beispielen in Azure Resource Manager-Vorlagen für App Service und Bicep-Dateien für App Service.

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

Voraussetzungen

• Um die App Service-Umgebung 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-Umgebung mit einem öffentlichen Endpunkt wird als External-App Service-Umgebung 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-Umgebung mit der Vorlage die Subnetzgröße nicht ändern können.

• Wenn Sie eine App Service-Umgebung 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-Umgebung 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-Umgebung 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-Umgebung 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-Umgebung dauert in der Regel etwa eine Stunde, aber wenn es sich um eine zonenredundante App Service-Umgebung handelt oder die Zielregion unerwartete Anforderungen hat, kann der Erstellungsprozess mehrere Stunden dauern.

Verwandte Inhalte

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