Skapa en App Service-miljön med hjälp av en Azure Resource Manager-mall

  • Artikel

App Service-miljön kan skapas med hjälp av en Azure Resource Manager-mall så att du kan utföra repeterbar distribution.

Anteckning

Den här artikeln handlar om App Service-miljön v3, som används med isolerade v2-App Service planer.

Översikt

Azure App Service Environment kan skapas med en internettillgänglig slutpunkt eller en slutpunkt på en intern adress i en Azure-Virtual Network. När slutpunkten skapas med en intern slutpunkt tillhandahålls den av en Azure-komponent som kallas intern lastbalanserare (ILB). App Service-miljön på en intern IP-adress kallas för en ILB ASE. Den App Service-miljön med en offentlig slutpunkt kallas extern ASE.

Du kan skapa en ASE med hjälp av mallen Azure Portal eller Azure Resource Manager. Den här artikeln går igenom de steg och syntax du behöver för att skapa en extern ASE eller ILB ASE med Resource Manager mallar. Lär dig hur du skapar en App Service-miljön i Azure Portal.

När du skapar en App Service-miljön i Azure Portal kan du skapa ditt virtuella nätverk samtidigt eller välja ett befintligt virtuellt nätverk att distribuera till.

När du skapar en App Service-miljön från en mall måste du börja med:

  • En Azure-Virtual Network.
  • Ett undernät i det virtuella nätverket. Vi rekommenderar en undernätsstorlek på /24 med 256 adresser för framtida tillväxt- och skalningsbehov. När App Service-miljön har skapats kan du inte ändra storleken.
  • Den plats som du vill distribuera till.

Konfigurera App Service-miljön

Den grundläggande Resource Manager mallen som skapar en App Service-miljön ser ut så här:

{
    "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"
    }
}

Förutom kärnegenskaperna finns det andra konfigurationsalternativ som du kan använda för att konfigurera din App Service-miljön.

  • name: Krävs. Den här parametern definierar ett unikt App Service-miljön namn. Namnet får inte innehålla fler än 36 tecken.
  • virtualNetwork –> ID: Krävs. Anger resurs-ID för undernätet. Undernätet måste vara tomt och delegerat till Microsoft.Web/hostingEnvironments
  • internalLoadBalancingMode: Krävs. I de flesta fall anger du den här egenskapen till "Web, Publishing", vilket innebär att både HTTP/HTTPS-trafik och FTP-trafik finns på en intern VIP (intern Load Balancer). Om den här egenskapen är inställd på "Ingen" förblir all trafik på den offentliga VIP:en (extern Load Balancer).
  • zoneRedundant: Valfritt. Definierar med true/false om App Service-miljön ska distribueras till Tillgänglighetszoner (AZ). Mer information finns i Regioner och tillgänglighetszoner.
  • dedicatedHostCount: Valfritt. I de flesta fall anger du den här egenskapen till 0 eller utelämnas. Du kan ange 2 om du vill distribuera din App Service-miljön med fysisk maskinvaruisolering på dedikerade värdar.
  • upgradePreference: Valfritt. Definierar om uppgraderingen startas automatiskt eller om ett 15-dagars fönster för att starta distributionen anges. Giltiga värden är "None", "Early", "Late", "Manual". Mer information om uppgraderingsinställningar.
  • clusterSettings: Valfritt. Mer information finns i klusterinställningar.
  • networkingConfiguration –> allowNewPrivateEndpointConnections: Valfritt. Mer information finns i Nätverkskonfiguration.
  • networkingConfiguration –> remoteDebugEnabled: Valfritt. Mer information finns i Nätverkskonfiguration.
  • networkingConfiguration –> ftpEnabled: Valfritt. Mer information finns i Nätverkskonfiguration.
  • networkingConfiguration –> inboundIpAddressOverride: Valfritt. Gör att du kan skapa en App Service-miljön med din egen offentliga IP-adress i Azure (ange resurs-ID) eller definiera en statisk IP-adress för ILB-distributioner. Den här inställningen kan inte ändras när App Service-miljön har skapats.
  • customDnsSuffixConfiguration: Valfritt. Gör att du kan ange ett anpassat domänsuffix för App Service-miljön. Kräver ett giltigt certifikat från en Key Vault och åtkomst med hjälp av en hanterad identitet. Mer information om de specifika parametrarna finns i Suffix för konfiguration av anpassad domän.

Anteckning

Egenskaperna dnsSuffix, multiSize, frontEndScaleFactor, userWhitelistedIpRangesoch ipSslAddressCount stöds inte när du skapar App Service-miljön v3.

Distribuera App Service-miljön

När du har skapat ARM-mallen, till exempel med namnet azuredeploy.json och eventuellt en parameterfil med namnet azuredeploy.parameters.json, kan du skapa App Service-miljön med hjälp av Azure CLI-kodfragmentet. Ändra filsökvägarna så att de matchar Resource Manager mallfilsplatser på datorn. Kom ihåg att ange ett eget värde för resursgruppens namn:

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

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

Det tar vanligtvis ungefär en timme att skapa App Service-miljön, men om det är en zonredundant App Service-miljön eller om vi upplever en oväntad efterfrågan i en region kan det ta flera timmar att skapa den.

Nästa steg

Använda en App Service-miljön v3

App Service-miljön v3-nätverk

Certifikat i App Service-miljön v3