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

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

Kommentar

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

Översikt

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

En ASE kan skapas med hjälp av Azure Portal eller en Azure Resource Manager-mall. 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:

• Ett virtuellt Azure-nätverk.
• Ett undernät i det virtuella nätverket. Vi rekommenderar en undernätsstorlek /24 på 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 lastbalanserare). Om den här egenskapen är inställd på "Ingen" förblir all trafik på den offentliga VIP:en (extern lastbalanserare).
• zoneRedundant: Valfritt. Definierar med true/false om App Service-miljön 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ämnad. Du kan ange den till 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. Det går inte att ändra den här inställningen 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 ett Key Vault och åtkomst med hjälp av en hanterad identitet. Mer information om de specifika parametrarna finns i konfigurationssuffix för anpassad domän.

Kommentar

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 Kodfragmentet i Azure CLI. Ändra filsökvägarna så att de matchar resource manager-mallfilplatserna på datorn. Kom ihåg att ange ditt 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 processen.

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