Skapa en anpassad avsökning för Azure Application Gateway (klassisk) med hjälp av PowerShell

Artikel
10/24/2023

I den här artikeln lägger du till en anpassad avsökning till en befintlig programgateway med PowerShell. Anpassade avsökningar är användbara för program som har en specifik hälsokontrollsida eller för program som inte ger ett lyckat svar på standardwebbprogrammet.

Viktigt!

Azure har två olika distributionsmodeller för att skapa och arbeta med resurser: Resource Manager och Classic. Den här artikeln beskriver hur du använder den klassiska distributionsmodellen. Microsoft rekommenderar att de flesta nya distributioner använder Resource Manager-modellen. Lär dig hur du utför dessa steg med hjälp av Resource Manager-modellen.

Förutsättning: Installera Azure PowerShell-modulen

Om du vill utföra stegen i den här artikeln, måste du installera och konfigurera Azure PowerShell-modulen. Glöm inte att slutföra alla instruktionerna. När installationen är klar, loggar du in på Azure och väljer din prenumeration.

Kommentar

Du behöver ett Azure-konto för att kunna slutföra de här stegen. Om du inte har ett Azure-konto, kan du registrera dig för en kostnadsfri utvärdering.

Skapa en programgateway

Så här skapar du en programgateway:

Skapa en resurs för en programgateway.
Skapa en XML-konfigurationsfil eller ett konfigurationsobjekt.
Bekräfta konfigurationen för den nyligen skapade programgatewayresursen.

Skapa en programgatewayresurs med en anpassad avsökning

Du skapar en gateway genom att köra cmdleten New-AzureApplicationGateway, där du ersätter värdena med dina egna. Faktureringen för gatewayen börjar inte just nu. Faktureringen börjar i ett senare skede när gatewayen har startats.

I följande exempel skapar vi en programgateway genom att använda ett virtuellt nätverk med namnet ”testvnet1” och undernätet ”subnet-1”.

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

Du kontrollerar att gatewayen har skapats genom att köra cmdleten Get-AzureApplicationGateway.

Get-AzureApplicationGateway AppGwTest

Kommentar

Standardvärdet för InstanceCount är 2, och det högsta värdet är 10. Standardvärdet för GatewaySize är Medium. Du kan välja mellan Liten, Medel och Stor.

VirtualIPs och DnsName är tomma eftersom gatewayen inte har startat än. Dessa värden skapas när gatewayen är i körningstillståndet.

Konfigurera en programgateway med hjälp av XML

I följande exempel använder vi en XML-fil för att konfigurera alla inställningar för programgatewayen och för att skicka dem till programgatewayresursen.

Kopiera följande text till Anteckningar.

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

Redigera värdena mellan parenteserna för konfigurationsobjekten. Spara filen med filnamnstillägget .xml.

I följande exempel visas hur du använder en konfigurationsfil för att konfigurera programgatewayen för att belastningsutjämning av HTTP-trafik på offentlig port 80 och skicka nätverkstrafik till serverdelsport 80 mellan två IP-adresser med hjälp av en anpassad avsökning.

Viktigt!

Protokollobjekten Http och Https är skiftlägeskänsliga.

En ny konfigurationsobjektavsökning <> läggs till för att konfigurera anpassade avsökningar.

Konfigurationsparametrarna är:

Parameter	Description
Namn	Referensnamn för anpassad avsökning.
Protokoll	Protokoll som används (möjliga värden är HTTP eller HTTPS).
Värd och sökväg	Fullständig URL-sökväg som anropas av programgatewayen för att fastställa hälsotillståndet för instansen. Om du till exempel har en webbplats http://contoso.com/kan den anpassade avsökningen konfigureras för "http://contoso.com/path/custompath.htm" för att avsökningskontroller ska ha ett lyckat HTTP-svar.
Intervall	Konfigurerar avsökningsintervallkontroller i sekunder.
Tidsgräns	Definierar tidsgränsen för avsökningen för en HTTP-svarskontroll.
UnhealthyThreshold	Antalet misslyckade HTTP-svar som behövs för att flagga serverdelsinstansen som inte felfri.

Avsökningsnamnet refereras till i <backendHttpSettings-konfigurationen för att tilldela vilken serverdelspool som använder anpassade avsökningsinställningar> .

Lägga till en anpassad avsökning till en befintlig programgateway

För att ändra den aktuella konfigurationen för en programgateway krävs tre steg: Hämta den aktuella XML-konfigurationsfilen, ändra för att ha en anpassad avsökning och konfigurera programgatewayen med de nya XML-inställningarna.

Hämta XML-filen med hjälp Get-AzureApplicationGatewayConfigav . Den här cmdleten exporterar den konfigurations-XML som ska ändras för att lägga till en avsökningsinställning.
```
Get-AzureApplicationGatewayConfig -Name "<application gateway name>" -Exporttofile "<path to file>"
```

Öppna XML-filen i en textredigerare. Lägg till ett <probe> avsnitt efter <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>

I avsnittet backendHttpSettings i XML lägger du till avsökningsnamnet enligt följande exempel:

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

Spara XML-filen.

Uppdatera konfigurationen av programgatewayen med den nya XML-filen med hjälp Set-AzureApplicationGatewayConfigav . Den här cmdleten uppdaterar programgatewayen med den nya konfigurationen.

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

Nästa steg

Om du vill konfigurera TLS (Transport Layer Security), som tidigare kallades SSL-avlastning (Secure Sockets Layer), läser du Konfigurera en programgateway för TLS-avlastning.

Om du vill konfigurera en programgateway för användning med en intern lastbalanserare läser du Skapa en programgateway med en intern lastbalanserare (ILB).

Dela via