Azure リソースマネージャーで PowerShell を使用して Azure Application Gateway のカスタムプローブを作成する

2023-04-09

この記事では、PowerShell を使用して既存の Application Gateway にカスタムプローブを追加します。カスタムプローブは、特定の正常性チェックページがあるアプリケーションや、既定の Web アプリケーションに対して正常な応答を返さないアプリケーションに役立ちます。

注意

Azure を操作するには、Azure Az PowerShell モジュールを使用することをお勧めします。作業を始めるには、「Azure PowerShell をインストールする」を参照してください。 Az PowerShell モジュールに移行する方法については、「AzureRM から Az への Azure PowerShell の移行」を参照してください。

前提条件: Azure PowerShell モジュールのインストール

この記事の手順を実行するには、Azure PowerShell モジュールをインストールして構成する必要があります。必ず、すべての手順を完了してください。インストールが完了したら、Azure にサインインし、サブスクリプションを選択します。

Note

これらの手順を完了するには Azure アカウントが必要です。 Azure アカウントを持っていない場合、無料試用版でサインアップできます。

カスタムプローブを設定した Application Gateway の作成

Connect-AzAccount を使用して認証を行います。
```
Connect-AzAccount
```
アカウントのサブスクリプションを取得します。
```
Get-AzSubscription
```
使用する Azure サブスクリプションを選択します。
```
Select-AzSubscription -Subscriptionid '{subscriptionGuid}'
```
リソースグループを作成する。既存のリソースグループがある場合は、この手順をスキップしてください。
```
New-AzResourceGroup -Name appgw-rg -Location 'West US'
```

Azure リソースマネージャーでは、すべてのリソースグループの場所を指定する必要があります。この場所は、そのリソースグループ内のリソースの既定の保存先として使用されます。アプリケーションゲートウェイを作成するためのすべてのコマンドで、同じリソースグループが使用されていることを確認します。

前の例では、West US という名前の場所に appgw-RG という名前のリソースグループを作成しました。

仮想ネットワークとサブネットの作成

次の例では、Application Gateway の仮想ネットワークとサブネットを作成します。 Azure Application Gateway には、専用のサブネットが必要です。このため、Application Gateway 用に作成するサブネットは、他のサブネットを作成して使用できるように、VNET のアドアレス空間よりも小さくする必要があります。

# Assign the address range 10.0.0.0/24 to a subnet variable to be used to create a virtual network.
$subnet = New-AzVirtualNetworkSubnetConfig -Name subnet01 -AddressPrefix 10.0.0.0/24

# Create a virtual network named appgwvnet in resource group appgw-rg for the West US region using the prefix 10.0.0.0/16 with subnet 10.0.0.0/24.
$vnet = New-AzVirtualNetwork -Name appgwvnet -ResourceGroupName appgw-rg -Location 'West US' -AddressPrefix 10.0.0.0/16 -Subnet $subnet

# Assign a subnet variable for the next steps, which create an application gateway.
$subnet = $vnet.Subnets[0]

フロントエンド構成のパブリック IP アドレスを作成する

米国西部リージョンのリソースグループ appgw-rg に、パブリック IP リソース publicIP01 を作成します。この例では、Application Gateway のフロントエンド IP アドレスにパブリック IP アドレスを使用します。 Application Gateway では、パブリック IP アドアレスの DNS 名が動的に作成されることが必要です。したがって、パブリック IP アドレスの作成時には -DomainNameLabel を指定できません。

$publicip = New-AzPublicIpAddress -ResourceGroupName appgw-rg -Name publicIP01 -Location 'West US' -AllocationMethod Dynamic

アプリケーションゲートウェイの作成

アプリケーションゲートウェイを作成する前に、すべての構成項目を設定します。次の例では、Application Gateway のリソースに必要な構成項目を作成します。

コンポーネント	説明
ゲートウェイ IP の構成	Application Gateway の IP 構成。
バックエンドプール	Web アプリケーションをホストするアプリケーションサーバーに対する IP アドレス、FQDN、または NIC のプール。
正常性プローブ	バックエンドプールメンバーの正常性の監視に使用されるカスタムプローブ。
HTTP 設定	ポート、プロトコル、cookie ベースのアフィニティ、プローブ、タイムアウトなど設定のコレクション。これらの設定によって、バックエンドプールメンバーへのトラフィックのルーティング方法が決まります。
フロントエンドポート	Application Gateway がトラフィックをリッスンするポート
リスナー	プロトコル、フロントエンド IP 構成、およびフロントエンドポートの組み合わせ。これが受信要求をリッスンします。
Rule	HTTP 設定に基づいてトラフィックを適切なバックエンドにルーティングします。

# Creates an application gateway Frontend IP configuration named gatewayIP01
$gipconfig = New-AzApplicationGatewayIPConfiguration -Name gatewayIP01 -Subnet $subnet

#Creates a backend IP address pool named pool01 with IP addresses 134.170.185.46, 134.170.188.221, 134.170.185.50.
$pool = New-AzApplicationGatewayBackendAddressPool -Name pool01 -BackendIPAddresses 134.170.185.46, 134.170.188.221, 134.170.185.50

# Creates a probe that will check health at http://contoso.com/path/path.htm
$probe = New-AzApplicationGatewayProbeConfig -Name probe01 -Protocol Http -HostName 'contoso.com' -Path '/path/path.htm' -Interval 30 -Timeout 120 -UnhealthyThreshold 8

# Creates the backend http settings to be used. This component references the $probe created in the previous command.
$poolSetting = New-AzApplicationGatewayBackendHttpSettings -Name poolsetting01 -Port 80 -Protocol Http -CookieBasedAffinity Disabled -Probe $probe -RequestTimeout 80

# Creates a frontend port for the application gateway to listen on port 80 that will be used by the listener.
$fp = New-AzApplicationGatewayFrontendPort -Name frontendport01 -Port 80

# Creates a frontend IP configuration. This associates the $publicip variable defined previously with the frontend IP that will be used by the listener.
$fipconfig = New-AzApplicationGatewayFrontendIPConfig -Name fipconfig01 -PublicIPAddress $publicip

# Creates the listener. The listener is a combination of protocol and the frontend IP configuration $fipconfig and frontend port $fp created in previous steps.
$listener = New-AzApplicationGatewayHttpListener -Name listener01  -Protocol Http -FrontendIPConfiguration $fipconfig -FrontendPort $fp

# Creates the rule that routes traffic to the backend pools.  In this example we create a basic rule that uses the previous defined http settings and backend address pool.  It also associates the listener to the rule
$rule = New-AzApplicationGatewayRequestRoutingRule -Name rule01 -RuleType Basic -BackendHttpSettings $poolSetting -HttpListener $listener -BackendAddressPool $pool

# Sets the SKU of the application gateway, in this example we create a small standard application gateway with 2 instances.
$sku = New-AzApplicationGatewaySku -Name Standard_Small -Tier Standard -Capacity 2

# The final step creates the application gateway with all the previously defined components.
$appgw = New-AzApplicationGateway -Name appgwtest -ResourceGroupName appgw-rg -Location 'West US' -BackendAddressPools $pool -Probes $probe -BackendHttpSettingsCollection $poolSetting -FrontendIpConfigurations $fipconfig  -GatewayIpConfigurations $gipconfig -FrontendPorts $fp -HttpListeners $listener -RequestRoutingRules $rule -Sku $sku

既存のアプリケーションゲートウェイへのプローブの追加

次のコードスニペットは、既存の Application Gateway にプローブを追加します。

# Load the application gateway resource into a PowerShell variable by using Get-AzApplicationGateway.
$getgw =  Get-AzApplicationGateway -Name appgwtest -ResourceGroupName appgw-rg

# Create the probe object that will check health at http://contoso.com/path/path.htm
$probe = Add-AzApplicationGatewayProbeConfig -ApplicationGateway $getgw -Name probe01 -Protocol Http -HostName 'contoso.com' -Path '/path/custompath.htm' -Interval 30 -Timeout 120 -UnhealthyThreshold 8

# Set the backend HTTP settings to use the new probe
$getgw = Set-AzApplicationGatewayBackendHttpSettings -ApplicationGateway $getgw -Name $getgw.BackendHttpSettingsCollection.name -Port 80 -Protocol Http -CookieBasedAffinity Disabled -Probe $probe -RequestTimeout 120

# Save the application gateway with the configuration changes
Set-AzApplicationGateway -ApplicationGateway $getgw

既存のアプリケーションゲートウェイからのプローブの削除

次のコードスニペットは、既存の Application Gateway からプローブを削除します。

# Load the application gateway resource into a PowerShell variable by using Get-AzApplicationGateway.
$getgw =  Get-AzApplicationGateway -Name appgwtest -ResourceGroupName appgw-rg

# Remove the probe from the application gateway configuration object
$getgw = Remove-AzApplicationGatewayProbeConfig -ApplicationGateway $getgw -Name $getgw.Probes.name

# Set the backend HTTP settings to remove the reference to the probe. The backend http settings now use the default probe
$getgw = Set-AzApplicationGatewayBackendHttpSettings -ApplicationGateway $getgw -Name $getgw.BackendHttpSettingsCollection.name -Port 80 -Protocol http -CookieBasedAffinity Disabled

# Save the application gateway with the configuration changes
Set-AzApplicationGateway -ApplicationGateway $getgw

アプリケーションゲートウェイの DNS 名の取得

ゲートウェイを作成したら、次は通信用にフロントエンドを構成します。パブリック IP アドレスを使用する場合、Application Gateway には、動的に割り当てられたフレンドリではない DNS 名が必要です。エンドユーザーがアプリケーションゲートウェイを確実に見つけられるように、CNAME レコードを使用して、アプリケーションゲートウェイのパブリックエンドポイントを参照できます。次に、Azure でのカスタムドメイン名を構成します。それには、アプリケーションゲートウェイに接続されている PublicIPAddress 要素を使用して、アプリケーションゲートウェイの詳細とそれに関連付けられている IP/DNS 名を取得します。アプリケーションゲートウェイの DNS 名を使用して、2 つの Web アプリケーションがこの DNS 名を指すように CNAME レコードを作成する必要があります。アプリケーションゲートウェイの再起動時に VIP が変更される可能性があるため、A レコードの使用はお勧めしません。

Get-AzPublicIpAddress -ResourceGroupName appgw-RG -Name publicIP01

Name                     : publicIP01
ResourceGroupName        : appgw-RG
Location                 : westus
Id                       : /subscriptions/<subscription_id>/resourceGroups/appgw-RG/providers/Microsoft.Network/publicIPAddresses/publicIP01
Etag                     : W/"00000d5b-54ed-4907-bae8-99bd5766d0e5"
ResourceGuid             : 00000000-0000-0000-0000-000000000000
ProvisioningState        : Succeeded
Tags                     : 
PublicIpAllocationMethod : Dynamic
IpAddress                : xx.xx.xxx.xx
PublicIpAddressVersion   : IPv4
IdleTimeoutInMinutes     : 4
IpConfiguration          : {
                                "Id": "/subscriptions/<subscription_id>/resourceGroups/appgw-RG/providers/Microsoft.Network/applicationGateways/appgwtest/frontendIP
                            Configurations/frontend1"
                            }
DnsSettings              : {
                                "Fqdn": "00000000-0000-xxxx-xxxx-xxxxxxxxxxxx.cloudapp.net"
                            }

次のステップ

TLS オフロードの構成については、SSL オフロードの構成に関する記事を参照してください

次の方法で共有

Azure リソース マネージャーで PowerShell を使用して Azure Application Gateway のカスタム プローブを作成する

前提条件: Azure PowerShell モジュールのインストール

カスタム プローブを設定した Application Gateway の作成

サインインし、リソース グループを作成する

仮想ネットワークとサブネットの作成

フロントエンド構成のパブリック IP アドレスを作成する

アプリケーション ゲートウェイの作成

既存のアプリケーション ゲートウェイへのプローブの追加

既存のアプリケーション ゲートウェイからのプローブの削除

アプリケーション ゲートウェイの DNS 名の取得