Creare un ambiente del servizio app usando un modello di Resource Manager di Azure
ambiente del servizio app può essere creato usando un modello di Resource Manager di Azure che consente di eseguire la distribuzione ripetibile.
Nota
Questo articolo riguarda ambiente del servizio app v3, usato con piani di servizio app isolati v2.
Panoramica
Servizio app di Azure Ambiente può essere creato con un endpoint accessibile da Internet o un endpoint in un indirizzo interno in un Rete virtuale di Azure. Quando viene creato con un endpoint interno, tale endpoint dispone di un componente Azure denominato servizio di bilanciamento del carico interno (ILB). Il ambiente del servizio app in un indirizzo IP interno viene chiamato un ambiente del servizio app ilB. Il ambiente del servizio app con un endpoint pubblico viene chiamato un ambiente del servizio app esterno.
È possibile creare un ambiente del servizio app usando il portale di Azure o un modello di Azure Resource Manager. Questo articolo illustra i passaggi e la sintassi necessari per creare un ambiente del servizio app esterno o con bilanciamento del carico interno con i modelli di Resource Manager. Informazioni su come creare un ambiente del servizio app in portale di Azure.
Quando si crea un ambiente del servizio app nella portale di Azure, è possibile creare la rete virtuale contemporaneamente o scegliere una rete virtuale preesistente da distribuire.
Quando si crea un ambiente del servizio app da un modello, è necessario iniziare con:
- Una rete virtuale di Azure.
- Subnet nella rete virtuale. È consigliabile una dimensione della subnet di
/24con 256 indirizzi per soddisfare le esigenze di crescita e scalabilità future. Dopo aver creato la ambiente del servizio app, non è possibile modificare le dimensioni. - La località in cui si vuole eseguire la distribuzione.
Configurazione del ambiente del servizio app
Il modello di Resource Manager di base che crea un ambiente del servizio app è simile al seguente:
{
"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"
}
}
Oltre alle proprietà principali, sono disponibili altre opzioni di configurazione che è possibile usare per configurare il ambiente del servizio app.
- name: Obbligatorio. Questo parametro definisce un nome univoco ambiente del servizio app. Il nome deve essere diverso da 36 caratteri.
- virtualNetwork -> id: obbligatorio. Specifica l'ID risorsa della subnet. La subnet deve essere vuota e delegata a Microsoft.Web/hostingEnvironments
- internalLoadBalancingMode: obbligatorio. Nella maggior parte dei casi, impostare questa proprietà su "Web, Pubblicazione", il che significa che il traffico HTTP/HTTPS e il traffico FTP si trova in un indirizzo VIP interno (Load Balancer interno). Se questa proprietà è impostata su "Nessuno", tutto il traffico rimane sull'indirizzo VIP pubblico (Load Balancer esterno).
- zoneRedundant: facoltativo. Definisce con true/false se la ambiente del servizio app verrà distribuita in zone di disponibilità (AZ). Per altre informazioni, vedere Aree e zone di disponibilità.
- dedicatoHostCount: facoltativo. Nella maggior parte dei casi, impostare questa proprietà su 0 o a sinistra. È possibile impostarlo su 2 se si vuole distribuire il ambiente del servizio app con isolamento hardware fisico in host dedicati.
- upgradePreference: facoltativo. Definisce se l'aggiornamento viene avviato automaticamente o viene specificata una finestra di 15 giorni per avviare la distribuzione. I valori validi sono "None", "Early", "Late", "Manual". Altre informazioni sulle preferenze di aggiornamento.
- clusterSettings: facoltativo. Per altre informazioni, vedere Impostazioni del cluster.
- networkingConfiguration :> allowNewPrivateEndpointConnections: facoltativo. Per altre informazioni, vedere Configurazione di rete.
- networkingConfiguration -> remoteDebugEnabled: Facoltativo. Per altre informazioni, vedere Configurazione di rete.
- networkingConfiguration -> ftpEnabled: facoltativo. Per altre informazioni, vedere Configurazione di rete.
- networkingConfiguration -> inboundIpAddressOverride: facoltativo. Consente di creare un ambiente del servizio app con il proprio indirizzo IP pubblico di Azure (specificare l'ID risorsa) o definire un INDIRIZZO IP statico per le distribuzioni ilB. Questa impostazione non può essere modificata dopo la creazione della ambiente del servizio app.
- customDnsSuffixConfiguration: facoltativo. Consente di specificare un suffisso di dominio personalizzato per il ambiente del servizio app. Richiede un certificato valido da un Key Vault e l'accesso usando un'identità gestita. Per altre informazioni sui parametri specifici, vedere suffisso di dominio personalizzato di configurazione.
Nota
Le proprietà dnsSuffix, , multiSizefrontEndScaleFactor, userWhitelistedIpRangese ipSslAddressCount non sono supportate durante la creazione di ambiente del servizio app v3.
Distribuzione del ambiente del servizio app
Dopo aver creato il modello arm, ad esempio denominato azuredeploy.json e facoltativamente un file di parametri denominato azuredeploy.parameters.json, è possibile creare il ambiente del servizio app usando il frammento di codice dell'interfaccia della riga di comando di Azure. Modificare i percorsi dei file per fare in modo che corrispondano alle posizioni dei file dei modelli di Resource Manager nel computer. Ricordarsi di specificare il proprio valore per il nome del gruppo di risorse:
templatePath="PATH/azuredeploy.json"
parameterPath="PATH/azuredeploy.parameters.json"
az deployment group create --resource-group "YOUR-RG-NAME-HERE" --template-file $templatePath --parameters $parameterPath
La creazione del ambiente del servizio app richiede in genere circa un'ora, ma se si tratta di un ambiente del servizio app ridondante della zona o si verifica una domanda imprevista in un'area, il processo di creazione può richiedere diverse ore per completare.