Criar uma investigação personalizada para o Gateway de Aplicativo (clássico) pelo uso do PowerShell
Neste artigo, você adiciona uma investigação personalizada a um gateway de aplicativo existente com o PowerShell. As investigações personalizadas são úteis para aplicativos que tenham uma página de verificação de integridade específica ou para aplicativos que não forneçam uma resposta bem-sucedida no aplicativo Web padrão.
Importante
O Azure tem dois modelos de implantação diferentes para criar e trabalhar com recursos: Resource Manager e Clássico. Este artigo aborda o uso do modelo de implantação Clássica. A Microsoft recomenda que a maioria das implantações novas use o modelo do Gerenciador de Recursos. Saiba como executar estas etapas usando o modelo do Resource Manager.
Pré-requisito: instalar o módulo do Azure PowerShell
Para seguir as etapas deste artigo, será necessário instalar e configurar o módulo do Azure PowerShell. Certifique-se de concluir todas as instruções. Depois que a instalação for concluída, entre no Azure e selecione sua assinatura.
Observação
É necessária uma conta do Azure para concluir essas etapas. Se não tiver uma conta do Azure, você poderá assinar uma versão de avaliação gratuita.
Criar um Gateway de Aplicativo
Para criar um Application Gateway:
- Criar um recurso de gateway de aplicativo.
- Crie um arquivo XML de configuração ou um objeto de configuração.
- Confirme a configuração do recurso de gateway de aplicativo recém-criado.
Criar um recurso de gateway de aplicativo com uma investigação personalizada
Para criar o gateway, use o cmdlet New-AzureApplicationGateway, substituindo os valores pelos seus próprios. A cobrança pelo gateway não é iniciada neste momento. A cobrança é iniciada em uma etapa posterior, quando o gateway é iniciado com êxito.
O exemplo a seguir cria um novo Application Gateway usando uma rede virtual chamada "testvnet1" e uma sub-rede chamada "subnet-1".
New-AzureApplicationGateway -Name AppGwTest -VnetName testvnet1 -Subnets @("Subnet-1")
Para validar esse gateway que foi criado, você pode usar o cmdlet Get-AzureApplicationGateway.
Get-AzureApplicationGateway AppGwTest
Observação
O valor padrão para InstanceCount é 2, com um valor máximo de 10. O valor padrão para GatewaySize é Medium. Você pode escolher entre Small, Medium e Large.
VirtualIPs e DnsName são mostrados em branco porque o gateway ainda não foi iniciado. Esses valores serão criados depois que o gateway estiver em estado de execução.
Configurar um Application Gateway usando XML
No exemplo a seguir, você usará um arquivo XML para definir todas as configurações do Application Gateway e confirmá-las para o recurso do Application Gateway.
Copie o seguinte texto no bloco de notas.
<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>
Edite os valores entre parênteses para os itens de configuração. Salve o arquivo com a extensão .xml.
O exemplo a seguir mostra como usar um arquivo de configuração para configurar o gateway de aplicativo para balancear a carga do tráfego HTTP na porta pública 80 e enviar o tráfego de rede para a porta 80 do back-end entre dois endereços IP usando uma investigação personalizada.
Importante
O item de protocolo Http ou Https diferencia maiúsculas de minúsculas.
Um novo item de configuração <Probe> é adicionado para configurar investigações personalizadas.
Os parâmetros de configuração são:
| Parâmetro | Descrição |
|---|---|
| Nome | Nome de referência da investigação personalizada. |
| Protocolo | Protocolo usado (os valores possíveis são HTTP ou HTTPS). |
| Host e Path | Caminho de URL completo que é invocado pelo Gateway de Aplicativo para determinar a integridade da instância. Por exemplo, se você tiver um site http://contoso.com/, a investigação personalizada poderá ser configurada para "http://contoso.com/path/custompath.htm" para verificações de investigação com uma resposta HTTP bem-sucedida. |
| Intervalo | Configura as verificações de intervalo de investigação em segundos. |
| Tempo limite | Define o tempo limite da investigação para uma verificação de resposta HTTP. |
| UnhealthyThreshold | O número de respostas HTTP com falha necessárias para sinalizar a instância de back-end como não íntegra. |
O nome da investigação é referenciado na configuração <BackendHttpSettings> para atribuir o pool de back-end que usa as configurações da investigação personalizada.
Adicionar uma investigação personalizada a um gateway de aplicativo existente
Alterar a configuração atual de um Application Gateway exige três etapas: obter o arquivo de configuração XML atual, modificar para ter uma investigação personalizada e configurar o Application Gateway com as novas configurações de XML.
Obtenha o arquivo XML usando
Get-AzureApplicationGatewayConfig. Este cmdlet exporta o XML de configuração a ser modificado para adicionar uma configuração de investigação.Get-AzureApplicationGatewayConfig -Name "<application gateway name>" -Exporttofile "<path to file>"Abra o arquivo XML em um editor de texto. Adicione uma seção
<probe>após<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>Na seção backendHttpSettings do XML, adicione o nome da investigação como mostrado no exemplo a seguir:
<BackendHttpSettings> <Name>setting1</Name> <Port>80</Port> <Protocol>Http</Protocol> <CookieBasedAffinity>Enabled</CookieBasedAffinity> <RequestTimeout>120</RequestTimeout> <Probe>Probe01</Probe> </BackendHttpSettings>Salve o arquivo XML.
Atualize a configuração do Gateway de Aplicativo com o novo arquivo XML usando
Set-AzureApplicationGatewayConfig. Este cmdlet atualiza seu Gateway de Aplicativo com a nova configuração.
Set-AzureApplicationGatewayConfig -Name "<application gateway name>" -Configfile "<path to file>"
Próximas etapas
Se você quiser configurar o protocolo TLS, anteriormente conhecido como descarregamento protocolo SSL, veja Configurar um gateway de aplicativo para descarregamento de protocolo TLS.
Para configurar um gateway de aplicativo para usar com um balanceador de carga interno, confira Criar um gateway de aplicativo com um ILB (balanceador de carga interno).