Creare un probe personalizzato per il gateway applicazione di Azure (classico) con PowerShell
Questo articolo illustra come aggiungere un probe personalizzato a un gateway applicazione esistente con PowerShell. I probe personalizzati sono utili per le applicazioni che dispongono di una pagina di controllo dell'integrità specifica o per quelle che non rispondono in modo corretto all'applicazione Web predefinita.
Importante
Azure offre due diversi modelli di distribuzione per creare e usare le risorse: Gestione risorse e la distribuzione classica. Questo articolo illustra l'uso del modello di distribuzione classica. Microsoft consiglia di usare il modello di Gestione risorse per le distribuzioni più recenti. Informazioni su come eseguire questa procedura con il modello di Resource Manager.
Prerequisito: installare il modulo Azure PowerShell
Per eseguire i passaggi indicati in questo articolo, è necessario installare e configurare il modulo Azure PowerShell. Assicurarsi di completare tutte le istruzioni. Al termine dell'installazione, accedere ad Azure e selezionare la sottoscrizione.
Nota
Per completare questi passaggi, è necessario un account Azure. Se non si ha un account Azure, è possibile iscriversi per ottenere una versione di valutazione gratuita.
Creare un gateway applicazione
Per creare un gateway applicazione:
- Creare una risorsa del gateway applicazione.
- Creare un file XML di configurazione o un oggetto di configurazione.
- Eseguire il commit della configurazione nella risorsa del gateway applicazione appena creata.
Creare una risorsa del gateway applicazione con un probe personalizzato
Per creare il gateway, usare il cmdlet New-AzureApplicationGateway, sostituendo i valori esistenti con quelli personalizzati. La fatturazione per il gateway non inizia a questo punto. La fatturazione viene applicata a partire da un passaggio successivo, dopo l'avvio corretto del gateway.
L'esempio seguente mostra come creare un gateway applicazione usando una rete virtuale denominata "testvnet1" e una subnet denominata "subnet-1".
New-AzureApplicationGateway -Name AppGwTest -VnetName testvnet1 -Subnets @("Subnet-1")
Per convalidare la creazione del gateway, è possibile usare il cmdlet Get-AzureApplicationGateway.
Get-AzureApplicationGateway AppGwTest
Nota
Il valore predefinito per InstanceCount è 2, con un valore massimo pari a 10. Il valore predefinito per GatewaySize è Medium. È possibile scegliere tra Small, Medium e Large.
VirtualIPs e DnsName vengono visualizzati vuoti perché il gateway non è stato ancora avviato. Questi valori vengono creati quando il gateway è in esecuzione.
Configurare un gateway applicazione usando XML
Nell'esempio seguente viene usato un file XML per configurare tutte le impostazioni del gateway applicazione ed eseguirne il commit nella risorsa del gateway applicazione.
Copiare il testo seguente in Blocco note.
<ApplicationGatewayConfiguration xmlns:i="https://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/windowsazure">
<FrontendIPConfigurations>
<FrontendIPConfiguration>
<Name>fip1</Name>
<Type>Private</Type>
</FrontendIPConfiguration>
</FrontendIPConfigurations>
<FrontendPorts>
<FrontendPort>
<Name>port1</Name>
<Port>80</Port>
</FrontendPort>
</FrontendPorts>
<Probes>
<Probe>
<Name>Probe01</Name>
<Protocol>Http</Protocol>
<Host>contoso.com</Host>
<Path>/path/custompath.htm</Path>
<Interval>15</Interval>
<Timeout>15</Timeout>
<UnhealthyThreshold>5</UnhealthyThreshold>
</Probe>
</Probes>
<BackendAddressPools>
<BackendAddressPool>
<Name>pool1</Name>
<IPAddresses>
<IPAddress>1.1.1.1</IPAddress>
<IPAddress>2.2.2.2</IPAddress>
</IPAddresses>
</BackendAddressPool>
</BackendAddressPools>
<BackendHttpSettingsList>
<BackendHttpSettings>
<Name>setting1</Name>
<Port>80</Port>
<Protocol>Http</Protocol>
<CookieBasedAffinity>Enabled</CookieBasedAffinity>
<RequestTimeout>120</RequestTimeout>
<Probe>Probe01</Probe>
</BackendHttpSettings>
</BackendHttpSettingsList>
<HttpListeners>
<HttpListener>
<Name>listener1</Name>
<FrontendIP>fip1</FrontendIP>
<FrontendPort>port1</FrontendPort>
<Protocol>Http</Protocol>
</HttpListener>
</HttpListeners>
<HttpLoadBalancingRules>
<HttpLoadBalancingRule>
<Name>lbrule1</Name>
<Type>basic</Type>
<BackendHttpSettings>setting1</BackendHttpSettings>
<Listener>listener1</Listener>
<BackendAddressPool>pool1</BackendAddressPool>
</HttpLoadBalancingRule>
</HttpLoadBalancingRules>
</ApplicationGatewayConfiguration>
Modificare i valori tra parentesi per gli elementi di configurazione. Salvare il file con estensione XML.
L'esempio seguente mostra come usare un file di configurazione per impostare il gateway applicazione per il bilanciamento del carico del traffico HTTP sulla porta pubblica 80 e inviare il traffico di rete alla porta back-end 80 tra due indirizzi IP usando un probe personalizzato.
Importante
L'elemento del protocollo HTTP o HTTPS deve rispettare la distinzione tra maiuscole e minuscole.
Viene aggiunto un nuovo elemento di configurazione <Probe> per configurare i probe personalizzati.
I parametri di configurazione sono:
| Parametro | Description |
|---|---|
| Nome | Nome di riferimento del probe personalizzato. |
| Protocollo | Protocollo usato. I valori possibili sono HTTP o HTTPS. |
| Host e Path | Percorso URL completo richiamato dal gateway applicazione per determinare l'integrità dell'istanza. Se si ha un sito Web http://contoso.com/, ad esempio, il probe personalizzato può essere configurato per "http://contoso.com/path/custompath.htm"" in modo che i controlli del probe ottengano una risposta HTTP corretta. |
| Intervallo | Configura i controlli dell'intervallo di probe, in secondi. |
| Timeout | Definisce il timeout del probe per un controllo della risposta HTTP. |
| UnhealthyThreshold | Numero di risposte HTTP non riuscite necessario per contrassegnare l'istanza back-end come non integra. |
Nella configurazione <BackendHttpSettings> viene fatto riferimento al nome del probe per assegnare il pool back-end che userà le impostazioni del probe personalizzato.
Aggiungere un probe personalizzato a un gateway applicazione esistente
Per modificare la configurazione corrente di un gateway applicazione sono necessari tre passaggi: ottenere il file di configurazione XML corrente, apportare modifiche per avere un probe personalizzato e configurare il gateway applicazione con le nuove impostazioni XML.
Ottenere il file XML usando
Get-AzureApplicationGatewayConfig. Questo cmdlet esporta il file XML di configurazione, che potrà quindi essere modificato per aggiungere un'impostazione di probe.Get-AzureApplicationGatewayConfig -Name "<application gateway name>" -Exporttofile "<path to file>"Aprire il file XML in un editor di testo. Aggiungere una sezione
<probe>dopo<frontendport>.<Probes> <Probe> <Name>Probe01</Name> <Protocol>Http</Protocol> <Host>contoso.com</Host> <Path>/path/custompath.htm</Path> <Interval>15</Interval> <Timeout>15</Timeout> <UnhealthyThreshold>5</UnhealthyThreshold> </Probe> </Probes>Nella sezione backendHttpSettings del file XML aggiungere il nome del probe, come nell'esempio seguente:
<BackendHttpSettings> <Name>setting1</Name> <Port>80</Port> <Protocol>Http</Protocol> <CookieBasedAffinity>Enabled</CookieBasedAffinity> <RequestTimeout>120</RequestTimeout> <Probe>Probe01</Probe> </BackendHttpSettings>Salvare il file XML.
Aggiornare la configurazione del gateway applicazione con il nuovo file XML usando
Set-AzureApplicationGatewayConfig. Questo cmdlet aggiorna il gateway applicazione con la nuova configurazione.
Set-AzureApplicationGatewayConfig -Name "<application gateway name>" -Configfile "<path to file>"
Passaggi successivi
Per configurare Transport Layer Security (TLS), noto in precedenza come offload SSL (Secure Sockets Layer), vedere Configurare un gateway applicazione per l'offload TLS.
Per configurare un gateway applicazione da usare con un servizio di bilanciamento del carico interno, vedere Creare un gateway applicazione con un servizio di bilanciamento del carico interno (ILB).