Creare un ambiente del servizio app usando un modello di Azure Resource Manager
ambiente del servizio app possibile creare usando un modello di Azure Resource Manager che consente di eseguire la distribuzione ripetibile.
Nota
Questo articolo riguarda l'ambiente del servizio app v3, usato con i piani di servizio app isolato v2.
Panoramica
app Azure'ambiente del servizio 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 ambiente del servizio app con bilanciamento del carico interno. Il ambiente del servizio app con un endpoint pubblico è denominato 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 in cui eseguire la distribuzione.
Quando si crea un ambiente del servizio app da un modello, è necessario iniziare con:
- Una rete virtuale di Azure.
- Una subnet nella rete virtuale. È consigliabile avere una dimensione della subnet con
/24
256 indirizzi per soddisfare le esigenze di crescita e ridimensionamento future. Dopo aver creato il 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 di ambiente del servizio app univoco. Il nome non può contenere più di 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 (Servizio di bilanciamento del carico interno). Se questa proprietà è impostata su "None", tutto il traffico rimane sull'indirizzo VIP pubblico (External Load Balancer).
- zoneRedundant: facoltativo. Definisce con true/false se il ambiente del servizio app verrà distribuito in zone di disponibilità (AZ). Per altre informazioni, vedere Aree geografiche e zone di disponibilità.
- dedicatedHostCount: 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. Consentire 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 con bilanciamento del carico interno. Questa impostazione non può essere modificata dopo la creazione del 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 insieme di credenziali delle chiavi e l'accesso usando un'identità gestita. Per altre informazioni sui parametri specifici, vedere Suffisso di dominio personalizzato di configurazione.
Nota
Le proprietà dnsSuffix
, multiSize
, frontEndScaleFactor
, userWhitelistedIpRanges
e ipSslAddressCount
non sono supportate durante la creazione di ambiente del servizio app v3.
Distribuzione del ambiente del servizio app
Dopo aver creato il modello di Resource Manager, 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 con ridondanza della zona o si verifica una domanda imprevista in un'area, il processo di creazione può richiedere diverse ore per il completamento.