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

Eine App Service-Umgebung kann mithilfe einer Azure Resource Manager-Vorlage erstellt werden, mit der Sie wiederholbare Bereitstellungen durchführen können.

Hinweis

In diesem Artikel wird die App Service-Umgebung v3 beschrieben, die mit isolierten v2-App Service-Plänen verwendet wird.

Übersicht

Eine Azure App Service-Umgebung kann mit einem über das Internet zugänglichen Endpunkt oder einem Endpunkt an einer internen Adresse in einem virtuellen Azure-Netzwerk erstellt werden. Beim Erstellen mit einem internen Endpunkt wird dieser Endpunkt über eine Azure-Komponente, den sogenannten internen Lastenausgleich (Internal Load Balancer, ILB), bereitgestellt. Eine App Service-Umgebung an einer internen IP-Adresse wird als ILB ASE bezeichnet. Eine App Service-Umgebung mit einem öffentlichen Endpunkt wird als externe ASE bezeichnet.

Eine ASE kann über das Azure-Portal oder mit einer Azure Resource Manager-Vorlage erstellt werden. In diesem Artikel werden die Schritte und Syntaxelemente beschrieben, die Sie zum Erstellen einer externen ASE oder einer ILB-ASE mit Resource Manager-Vorlagen benötigen. Erfahren Sie, wie Sie eine App Service-Umgebung im Azure-Portal erstellen.

Beim Erstellen einer App Service-Umgebung im Azure-Portal können Sie entweder gleichzeitig Ihr virtuelles Netzwerk erstellen oder ein bereits vorhandenes virtuelles Netzwerk auswählen, in dem die Bereitstellung erfolgen soll.

Wenn Sie eine App Service-Umgebung aus einer Vorlage erstellen, müssen Sie mit Folgendem beginnen:

• Ein Azure Virtual Network.
• Ein Subnetz in dem virtuellen Netzwerk Wir empfehlen eine Subnetzgröße von /24 mit 256 Adressen, um genügend Platz für zukünftiges Wachstum und Skalierungsanforderungen zu haben. Nachdem die App Service-Umgebung erstellt wurde, können Sie die Größe nicht mehr ändern.
• Der Speicherort, in dem die Bereitstellung erfolgen soll.

Konfigurieren der App Service-Umgebung

Die grundlegende Resource Manager-Vorlage, mit der eine App Service-Umgebung erstellt wird, sieht wie folgt aus:

{
    "type": "Microsoft.Web/hostingEnvironments",
    "apiVersion": "2022-03-01",
    "name": "[parameters('aseName')]",
    "location": "[resourceGroup().location]",
    "kind": "ASEV3",
    "properties": {
        "internalLoadBalancingMode": "Web, Publishing",
        "virtualNetwork": {
            "id": "[parameters('subnetResourceId')]"
        },
        "networkingConfiguration": { },
        "customDnsSuffixConfiguration": { }
    },
    "identity": {
        "type": "SystemAssigned"
    }
}

Zusätzlich zu den Kerneigenschaften gibt es weitere Konfigurationsoptionen, mit denen Sie Ihre App Service-Umgebung konfigurieren können.

• name: Erforderlich. Dieser Parameter definiert einen eindeutigen Namen der App Service-Umgebung. Der Name darf nicht mehr als 36 Zeichen umfassen.
• virtualNetwork -> ID: Erforderlich. Gibt die Ressourcen-ID des Subnetzes an. Das Subnetz muss leer und an „Microsoft.Web/hostingEnvironments“ delegiert sein.
• internalLoadBalancingMode: Erforderlich. In den meisten Fällen legen Sie diese Eigenschaft auf „Web, Publishing“ fest, was bedeutet, dass sowohl HTTP/HTTPS-Datenverkehr als auch FTP-Datenverkehr über eine interne virtuelle IP-Adresse (interner Load Balancer) erfolgt. Wenn diese Eigenschaft auf „None“ (Keine) festgelegt ist, fließt der gesamte Datenverkehr über die öffentliche virtuelle IP-Adresse (externer Load Balancer).
• zoneRedundant: Optional. Definiert mit „true/false“, ob die App Service-Umgebung in Verfügbarkeitszonen (VZ) bereitgestellt wird. Weitere Informationen finden Sie unter Regionen und Verfügbarkeitszonen.
• dedicatedHostCount: Optional. In den meisten Fällen legen Sie diese Eigenschaft auf 0 fest oder lassen sie weg. Sie können sie auf 2 festlegen, wenn Sie Ihre App Service-Umgebung mit physischer Hardwareisolation auf dedizierten Hosts bereitstellen möchten.
• upgradePreference: Optional. Definiert, ob ein Upgrade automatisch gestartet wird, oder ob ein 15-Tage-Fenster bis zum Starten der Bereitstellung eingehalten wird. Gültige Werte sind „None“, „Early“, „Late“, „Manual“ (Keine, Früh, Spät, Manuell). Weitere Informationen: Informationen zur Upgradepräferenz.
• clusterSettings: Optional. Weitere Informationen finden Sie unter Clustereinstellungen.
• networkingConfiguration –> allowNewPrivateEndpointConnections: Optional. Weitere Informationen finden Sie unter Netzwerkkonfiguration.
• networkingConfiguration –> remoteDebugEnabled: Optional. Weitere Informationen finden Sie unter Netzwerkkonfiguration.
• networkingConfiguration –> ftpEnabled: Optional. Weitere Informationen finden Sie unter Netzwerkkonfiguration.
• networkingConfiguration –> inboundIpAddressOverride: Optional. Gestattet Ihnen, eine App Service-Umgebung mit Ihrer eigenen öffentlichen Azure-IP-Adresse zu erstellen (Ressourcen-ID angeben) oder eine statische IP-Adresse für ILB-Bereitstellungen zu definieren. Diese Einstellung kann nach dem Erstellen der App Service-Umgebung nicht mehr geändert werden.
• customDnsSuffixConfiguration: Optional. Ermöglicht es Ihnen, ein benutzerdefiniertes Domänensuffix für die App Service-Umgebung anzugeben. Erfordert ein gültiges Zertifikat aus einem Key Vault sowie Zugriff mit einer verwalteten Identität. Weitere Informationen zu den spezifischen Parametern finden Sie unter Konfiguration eines benutzerdefinierten Domänensuffixes.

Hinweis

Die Eigenschaften dnsSuffix, multiSize, frontEndScaleFactor, userWhitelistedIpRanges und ipSslAddressCount werden beim Erstellen in App Service-Umgebung v3 nicht unterstützt.

Bereitstellen des App Service-Umgebung

Nachdem Sie die ARM-Vorlage erstellt haben, z. B. namens azuredeploy.json und optional eine Parameterdatei namens azuredeploy.parameters.json, können Sie die App Service-Umgebung mithilfe des Azure CLI-Codeausschnitts erstellen. Ändern Sie die Dateipfade in die Speicherorte, die in der Azure Resource Manager-Vorlagendatei auf Ihrem Computer angegeben sind. Denken Sie daran, Ihren eigenen Wert für den Ressourcengruppennamen anzugeben:

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

az deployment group create --resource-group "YOUR-RG-NAME-HERE" --template-file $templatePath --parameters $parameterPath

Das Erstellen der App Service-Umgebung dauert in der Regel etwa eine Stunde, wenn es sich jedoch um eine zonenredundante App Service-Umgebung handelt oder eine unerwartete Nachfrage in einer Region auftritt, kann der Erstellungsprozess mehrere Stunden dauern.

Nächste Schritte

Verwenden der App Service-Umgebung v3

Netzwerk in der App Service-Umgebung v3

Zertifikate in der App Service-Umgebung v3