Maak een aangepaste probe aan voor Azure Application Gateway (classic) door PowerShell te gebruiken

In dit artikel voeg je een aangepaste probe toe aan een bestaande applicatiegateway met PowerShell. Aangepaste probes zijn nuttig voor applicaties met een specifieke health check-pagina of voor applicaties die geen succesvol antwoord geven op de standaard webapplicatie.

Important

Azure heeft twee verschillende implementatiemodellen voor het creëren en werken met resources: Resource Manager en Classic. Dit artikel behandelt het gebruik van het Classic deploymentmodel. Microsoft raadt aan dat de meeste nieuwe implementaties het Resource Manager-model gebruiken. Leer hoe je deze stappen uitvoert met behulp van het Resource Manager-model.

Prerequisite: Install the Azure PowerShell module

Om de stappen in dit artikel uit te voeren, moet je de Azure PowerShell-module installeren en configureren. Zorg ervoor dat je alle instructies invult. Na voltooiing van de installatie log je in bij Azure en selecteer je je abonnement.

Note

Je hebt een Azure-account nodig om deze stappen te voltooien. Als u geen Azure-account hebt, kunt u er gratis een maken.

Een toepassingsgateway maken

Om een applicatiegateway te maken:

  1. Maak een applicatiegateway-resource aan.
  2. Maak een configuratie-XML-bestand of een configuratieobject.
  3. Commit de configuratie naar de nieuw aangemaakte applicatiegateway-resource.

Maak een applicatiegateway-resource aan met een aangepaste probe

Om de gateway te maken, gebruik je de New-AzureApplicationGateway cmdlet en vervang je de waarden door je eigen waarde. De facturering voor de gateway begint op dit punt niet. De facturering begint in een latere stap, wanneer de gateway succesvol is gestart.

Het volgende voorbeeld creëert een applicatiegateway door gebruik te maken van een virtueel netwerk genaamd "testvnet1" en een subnet genaamd "subnet-1".

New-AzureApplicationGateway -Name AppGwTest -VnetName testvnet1 -Subnets @("Subnet-1")

Om te valideren dat de gateway is aangemaakt, kun je de Get-AzureApplicationGateway cmdlet gebruiken.

Get-AzureApplicationGateway AppGwTest

Note

De standaardwaarde voor InstanceCount is 2, met een maximale waarde van 10. De standaardwaarde voor GatewaySize is Medium. Je kunt kiezen tussen Klein, Medium en Groot.

VirtualIPs en DnsName worden als leeg weergegeven omdat de gateway nog niet is gestart. Deze waarden worden aangemaakt zodra de gateway in de running state is.

Configureer een applicatiegateway met XML

In het volgende voorbeeld gebruik je een XML-bestand om alle applicatiegateway-instellingen te configureren en deze te commiten naar de applicatiegateway-resource.

Kopieer de volgende tekst naar Notepad.

<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>

Bewerk de waarden tussen de haakjes voor de configuratie-items. Sla het bestand met extensie .xmlop.

Het volgende voorbeeld laat zien hoe je een configuratiebestand gebruikt om de applicatiegateway zo in te stellen dat HTTP-verkeer op publieke poort 80 in balans is en netwerkverkeer naar backendpoort 80 tussen twee IP-adressen stuurt met behulp van een aangepaste probe.

Important

Het protocolitem Http of Https is hoofdlettergevoelig.

Er wordt een nieuw configuratie-item <Probe> toegevoegd om aangepaste probes te configureren.

De configuratieparameters zijn:

Parameter Description
Name Referentienaam voor aangepaste probe.
Protocol Gebruikt protocol (mogelijke waarden zijn HTTP of HTTPS).
Gastheer en Pad Volledig URL-pad dat door de applicatiegateway wordt aangeroepen om de gezondheid van de instantie te bepalen. Als je bijvoorbeeld een website http://contoso.com/hebt, dan kan de aangepaste probe worden geconfigureerd voor "http://contoso.com/path/custompath.htm" voor probe-controles om een succesvolle HTTP-respons te geven.
Interval Stel de probe intervalchecks in seconden in.
Timeout Definieert de probe-time-out voor een HTTP-responscontrole.
UnhealthyThreshold Het aantal mislukte HTTP-antwoorden dat nodig is om de backend-instantie als ongezond te markeren.

De naam van de probe wordt genoemd in de <BackendHttpSettings-configuratie> om toe te wijzen welke backendpool aangepaste probe-instellingen gebruikt.

Voeg een aangepaste probe toe aan een bestaande applicatiegateway

Het wijzigen van de huidige configuratie van een applicatiegateway vereist drie stappen: haal het huidige XML-configuratiebestand op, verander het met een aangepaste probe, en configureer de applicatiegateway met de nieuwe XML-instellingen.

  1. Haal het XML-bestand op door gebruik te maken van Get-AzureApplicationGatewayConfig. Deze cmdlet exporteert de configuratie-XML die aangepast moet worden om een probe-instelling toe te voegen.

    Get-AzureApplicationGatewayConfig -Name "<application gateway name>" -Exporttofile "<path to file>"

  2. Open het XML-bestand in een teksteditor. Voeg een <probe> sectie toe na <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>

    Voeg in de backendHttpSettings-sectie van de XML de naam van de probe toe zoals weergegeven in het volgende voorbeeld:

     <BackendHttpSettings>
     <Name>setting1</Name>
     <Port>80</Port>
     <Protocol>Http</Protocol>
     <CookieBasedAffinity>Enabled</CookieBasedAffinity>
     <RequestTimeout>120</RequestTimeout>
     <Probe>Probe01</Probe>
 </BackendHttpSettings>

    Sla het XML-bestand op.

  3. Werk de applicatiegatewayconfiguratie bij met het nieuwe XML-bestand door gebruik te maken van Set-AzureApplicationGatewayConfig. Deze cmdlet werkt je applicatiegateway bij met de nieuwe configuratie.

Set-AzureApplicationGatewayConfig -Name "<application gateway name>" -Configfile "<path to file>"

Volgende stappen 

Als je Transport Layer Security (TLS) wilt configureren, voorheen bekend als Secure Sockets Layer (SSL) offload, zie Configure an application gateway for TLS offload.

Als je een applicatiegateway wilt configureren om te gebruiken met een interne load balancer, zie dan Create an application gateway with a internal load balancer (ILB).

  • Last updated on