Azure PowerShell を使用して URL パスベースのリダイレクトのあるアプリケーションゲートウェイを作成する

[アーティクル]
05/11/2023

アプリケーションゲートウェイを作成するときに、Azure PowerShell を使用して URL ベースのルーティング規則を構成できます。この記事では、仮想マシンスケールセットを使用してバックエンドプールを作成します。次に、Web トラフィックが適切なバックエンドプールにリダイレクトされるようにする URL ルーティング規則を作成します。

この記事では、次のことについて説明します。

ネットワークのセットアップ
アプリケーションゲートウェイの作成
リスナーとルーティング規則の追加
バックエンドプールの仮想マシンスケールセットの作成

次の例は、ポート 8080 と 8081 の両方から送信されてきており、同じバックエンドプールに転送されているサイトトラフィックを示します。

URL ルーティングの例

好みに応じて、Azure CLI を使ってこの手順を実行することもできます。

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

Note

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

Azure Cloud Shell

Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。

Azure Cloud Shell を開始するには、以下のようにします。

オプション	例とリンク
コードまたはコマンドブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にはコピーされません。
https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。
Azure portal の右上にあるメニューバーの [Cloud Shell] ボタンを選択します。

Azure Cloud Shell を使用するには、以下のようにします。

Cloud Shell を開始します。
コードブロック (またはコマンドブロック) の [コピー] ボタンを選択し、コードまたはコマンドをコピーします。
Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードまたはコマンドを Cloud Shell セッションに貼り付けます。
Enter キーを選択して、コードまたはコマンドを実行します。

PowerShell をローカルにインストールして使用することを選択した場合、この手順には Azure PowerShell モジュールバージョン 1.0.0 以降が必要です。バージョンを確認するには、Get-Module -ListAvailable Az を実行します。アップグレードする必要がある場合は、Azure PowerShell モジュールのインストールに関するページを参照してください。 PowerShell をローカルで実行している場合、Connect-AzAccount を実行して Azure との接続を作成することも必要です。

リソースグループを作成する

リソースグループとは、Azure リソースのデプロイと管理に使用する論理コンテナーです。 New-AzResourceGroup を使用して Azure リソースグループを作成します。

New-AzResourceGroup -Name myResourceGroupAG -Location eastus

ネットワークリソースを作成する

New-AzVirtualNetworkSubnetConfig を使用して、サブネット構成 myBackendSubnet および myAGSubnet を作成します。 New-AzVirtualNetwork とサブネット構成を使用して、myVNet という名前の仮想ネットワークを作成します。最後に、New-AzPublicIpAddress を使用して myAGPublicIPAddress という名前のパブリック IP アドレスを作成します。こうしたリソースは、アプリケーションゲートウェイとその関連リソースにネットワーク接続を提供するために使用されます。

$backendSubnetConfig = New-AzVirtualNetworkSubnetConfig `
  -Name myBackendSubnet `
  -AddressPrefix 10.0.1.0/24

$agSubnetConfig = New-AzVirtualNetworkSubnetConfig `
  -Name myAGSubnet `
  -AddressPrefix 10.0.2.0/24

New-AzVirtualNetwork `
  -ResourceGroupName myResourceGroupAG `
  -Location eastus `
  -Name myVNet `
  -AddressPrefix 10.0.0.0/16 `
  -Subnet $backendSubnetConfig, $agSubnetConfig

New-AzPublicIpAddress `
  -ResourceGroupName myResourceGroupAG `
  -Location eastus `
  -Name myAGPublicIPAddress `
  -AllocationMethod Dynamic

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

このセクションでは、アプリケーションゲートウェイをサポートするリソースを作成し、最終的にアプリケーションゲートウェイを作成します。作成するリソースは次のとおりです。

IP 構成とフロントエンドポート - 以前に作成したサブネットをアプリケーションゲートウェイに関連付け、それへのアクセスに使用するポートを割り当てます。
既定のプール - すべてのアプリケーションゲートウェイには、サーバーのバックエンドプールが 1 つ以上必要です。
既定のリスナーとルール - 既定のリスナーは、割り当てられたポートでトラフィックをリッスンし、既定のルールは、既定のプールにトラフィックを送信します。

IP 構成とフロントエンドポートの作成

New-AzApplicationGatewayIPConfiguration を使用して、前に作成した myAGSubnet をアプリケーションゲートウェイに関連付けます。 New-AzApplicationGatewayFrontendIPConfig を使用して、myAGPublicIPAddress をアプリケーションゲートウェイに割り当てます。これで、New-AzApplicationGatewayFrontendPort を使用して HTTP ポートを作成できます。

$vnet = Get-AzVirtualNetwork `
  -ResourceGroupName myResourceGroupAG `
  -Name myVNet

$subnet=$vnet.Subnets[0]

$pip = Get-AzPublicIpAddress `
  -ResourceGroupName myResourceGroupAG `
  -Name myAGPublicIPAddress

$gipconfig = New-AzApplicationGatewayIPConfiguration `
  -Name myAGIPConfig `
  -Subnet $subnet

$fipconfig = New-AzApplicationGatewayFrontendIPConfig `
  -Name myAGFrontendIPConfig `
  -PublicIPAddress $pip

$frontendport = New-AzApplicationGatewayFrontendPort `
  -Name myFrontendPort `
  -Port 80

既定のプールと設定の作成

New-AzApplicationGatewayBackendAddressPool を使用して、アプリケーションゲートウェイに対して appGatewayBackendPool という名前の既定のバックエンドプールを作成します。 New-AzApplicationGatewayBackendHttpSettings を使用して、バックエンドプールの設定を構成します。

$defaultPool = New-AzApplicationGatewayBackendAddressPool `
  -Name appGatewayBackendPool

$poolSettings = New-AzApplicationGatewayBackendHttpSettings `
  -Name myPoolSettings `
  -Port 80 `
  -Protocol Http `
  -CookieBasedAffinity Enabled `
  -RequestTimeout 120

既定のリスナーとルールの作成

アプリケーションゲートウェイがバックエンドプールに対して適切にトラフィックをルーティングするためにはリスナーが必要です。この記事では、複数のリスナーを作成します。最初の基本的なリスナーは、ルート URL でトラフィックを待機します。他のリスナーは、特定の URL でトラフィックを待機します (http://52.168.55.24:8080/images/ や http://52.168.55.24:8081/video/ など)。

New-AzApplicationGatewayHttpListener と、前に作成したフロントエンド構成およびフロントエンドポートを使用して、defaultListener という名前のリスナーを作成します。着信トラフィックに使用するバックエンドプールをリスナーが判断するには、ルールが必要です。 New-AzApplicationGatewayRequestRoutingRule を使用して、rule1 という名前の基本ルールを作成します。

$defaultlistener = New-AzApplicationGatewayHttpListener `
  -Name defaultListener `
  -Protocol Http `
  -FrontendIPConfiguration $fipconfig `
  -FrontendPort $frontendport

$frontendRule = New-AzApplicationGatewayRequestRoutingRule `
  -Name rule1 `
  -RuleType Basic `
  -HttpListener $defaultlistener `
  -BackendAddressPool $defaultPool `
  -BackendHttpSettings $poolSettings

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

必要な関連リソースを作成したら、New-AzApplicationGatewaySku を使用して myAppGateway という名前のアプリケーションゲートウェイのパラメーターを指定し、New-AzApplicationGateway を使用してそれを作成します。

$sku = New-AzApplicationGatewaySku `
  -Name Standard_Medium `
  -Tier Standard `
  -Capacity 2

New-AzApplicationGateway `
  -Name myAppGateway `
  -ResourceGroupName myResourceGroupAG `
  -Location eastus `
  -BackendAddressPools $defaultPool `
  -BackendHttpSettingsCollection $poolSettings `
  -FrontendIpConfigurations $fipconfig `
  -GatewayIpConfigurations $gipconfig `
  -FrontendPorts $frontendport `
  -HttpListeners $defaultlistener `
  -RequestRoutingRules $frontendRule `
  -Sku $sku

バックエンドプールとポートの追加

Add-AzApplicationGatewayBackendAddressPool を使用して、バックエンドプールをアプリケーションゲートウェイに追加できます。この例では、imagesBackendPool と videoBackendPool が作成されます。 Add-AzApplicationGatewayFrontendPort を使用して、プールのフロントエンドポートを追加します。次に、Set-AzApplicationGateway を使用して、アプリケーションゲートウェイに変更を送信します。

$appgw = Get-AzApplicationGateway `
  -ResourceGroupName myResourceGroupAG `
  -Name myAppGateway

Add-AzApplicationGatewayBackendAddressPool `
  -ApplicationGateway $appgw `
  -Name imagesBackendPool

Add-AzApplicationGatewayBackendAddressPool `
  -ApplicationGateway $appgw `
  -Name videoBackendPool

Add-AzApplicationGatewayFrontendPort `
  -ApplicationGateway $appgw `
  -Name bport `
  -Port 8080

Add-AzApplicationGatewayFrontendPort `
  -ApplicationGateway $appgw `
  -Name rport `
  -Port 8081

Set-AzApplicationGateway -ApplicationGateway $appgw

リスナーと規則の追加

リスナーの追加

Add-AzApplicationGatewayHttpListener を使用して、トラフィックのルーティングに必要な backendListener および redirectedListener という名前のリスナーを追加します。

$appgw = Get-AzApplicationGateway `
  -ResourceGroupName myResourceGroupAG `
  -Name myAppGateway

$backendPort = Get-AzApplicationGatewayFrontendPort `
  -ApplicationGateway $appgw `
  -Name bport

$redirectPort = Get-AzApplicationGatewayFrontendPort `
  -ApplicationGateway $appgw `
  -Name rport

$fipconfig = Get-AzApplicationGatewayFrontendIPConfig `
  -ApplicationGateway $appgw

Add-AzApplicationGatewayHttpListener `
  -ApplicationGateway $appgw `
  -Name backendListener `
  -Protocol Http `
  -FrontendIPConfiguration $fipconfig `
  -FrontendPort $backendPort

Add-AzApplicationGatewayHttpListener `
  -ApplicationGateway $appgw `
  -Name redirectedListener `
  -Protocol Http `
  -FrontendIPConfiguration $fipconfig `
  -FrontendPort $redirectPort

Set-AzApplicationGateway -ApplicationGateway $appgw

既定の URL パスマップを追加する

URL パスマップにより、特定の URL が特定のバックエンドプールに確実にルーティングされます。 New-AzApplicationGatewayPathRuleConfig および Add-AzApplicationGatewayUrlPathMapConfig を使用して、imagePathRule および videoPathRule という名前の URL パスマップを作成できます。

$appgw = Get-AzApplicationGateway `
  -ResourceGroupName myResourceGroupAG `
  -Name myAppGateway

$poolSettings = Get-AzApplicationGatewayBackendHttpSettings `
  -ApplicationGateway $appgw `
  -Name myPoolSettings

$imagePool = Get-AzApplicationGatewayBackendAddressPool `
  -ApplicationGateway $appgw `
  -Name imagesBackendPool

$videoPool = Get-AzApplicationGatewayBackendAddressPool `
  -ApplicationGateway $appgw `
  -Name videoBackendPool

$defaultPool = Get-AzApplicationGatewayBackendAddressPool `
  -ApplicationGateway $appgw `
  -Name appGatewayBackendPool

$imagePathRule = New-AzApplicationGatewayPathRuleConfig `
  -Name imagePathRule `
  -Paths "/images/*" `
  -BackendAddressPool $imagePool `
  -BackendHttpSettings $poolSettings

$videoPathRule = New-AzApplicationGatewayPathRuleConfig `
  -Name videoPathRule `
  -Paths "/video/*" `
  -BackendAddressPool $videoPool `
  -BackendHttpSettings $poolSettings

Add-AzApplicationGatewayUrlPathMapConfig `
  -ApplicationGateway $appgw `
  -Name urlpathmap `
  -PathRules $imagePathRule, $videoPathRule `
  -DefaultBackendAddressPool $defaultPool `
  -DefaultBackendHttpSettings $poolSettings

Set-AzApplicationGateway -ApplicationGateway $appgw

リダイレクト構成を追加する

Add-AzApplicationGatewayRedirectConfiguration を使用して、リスナーのリダイレクトを構成できます。

$appgw = Get-AzApplicationGateway `
  -ResourceGroupName myResourceGroupAG `
  -Name myAppGateway

$backendListener = Get-AzApplicationGatewayHttpListener `
  -ApplicationGateway $appgw `
  -Name backendListener

$redirectConfig = Add-AzApplicationGatewayRedirectConfiguration `
  -ApplicationGateway $appgw `
  -Name redirectConfig `
  -RedirectType Found `
  -TargetListener $backendListener `
  -IncludePath $true `
  -IncludeQueryString $true

Set-AzApplicationGateway -ApplicationGateway $appgw

リダイレクト URL パスマップを追加する

$appgw = Get-AzApplicationGateway `
  -ResourceGroupName myResourceGroupAG `
  -Name myAppGateway

$poolSettings = Get-AzApplicationGatewayBackendHttpSettings `
  -ApplicationGateway $appgw `
  -Name myPoolSettings

$defaultPool = Get-AzApplicationGatewayBackendAddressPool `
  -ApplicationGateway $appgw `
  -Name appGatewayBackendPool

$redirectConfig = Get-AzApplicationGatewayRedirectConfiguration `
  -ApplicationGateway $appgw `
  -Name redirectConfig

$redirectPathRule = New-AzApplicationGatewayPathRuleConfig `
  -Name redirectPathRule `
  -Paths "/images/*" `
  -RedirectConfiguration $redirectConfig

Add-AzApplicationGatewayUrlPathMapConfig `
  -ApplicationGateway $appgw `
  -Name redirectpathmap `
  -PathRules $redirectPathRule `
  -DefaultBackendAddressPool $defaultPool `
  -DefaultBackendHttpSettings $poolSettings

Set-AzApplicationGateway -ApplicationGateway $appgw

ルーティング規則の追加

ルーティング規則によって、作成したリスナーに URL マップが関連付けられます。 Add-AzApplicationGatewayRequestRoutingRule を使用して、defaultRule および redirectedRule という名前の規則を追加できます。

$appgw = Get-AzApplicationGateway `
  -ResourceGroupName myResourceGroupAG `
  -Name myAppGateway

$backendlistener = Get-AzApplicationGatewayHttpListener `
  -ApplicationGateway $appgw `
  -Name backendListener

$redirectlistener = Get-AzApplicationGatewayHttpListener `
  -ApplicationGateway $appgw `
  -Name redirectedListener

$urlPathMap = Get-AzApplicationGatewayUrlPathMapConfig `
  -ApplicationGateway $appgw `
  -Name urlpathmap

$redirectPathMap = Get-AzApplicationGatewayUrlPathMapConfig `
  -ApplicationGateway $appgw `
  -Name redirectpathmap

Add-AzApplicationGatewayRequestRoutingRule `
  -ApplicationGateway $appgw `
  -Name defaultRule `
  -RuleType PathBasedRouting `
  -HttpListener $backendlistener `
  -UrlPathMap $urlPathMap

Add-AzApplicationGatewayRequestRoutingRule `
  -ApplicationGateway $appgw `
  -Name redirectedRule `
  -RuleType PathBasedRouting `
  -HttpListener $redirectlistener `
  -UrlPathMap $redirectPathMap

Set-AzApplicationGateway -ApplicationGateway $appgw

仮想マシンスケールセットの作成

この例では、作成した 3 つのバックエンドプールをサポートする 3 つの仮想マシンスケールセットを作成します。作成するスケールセットの名前は、myvmss1、myvmss2、および myvmss3 です。各スケールセットには、IIS をインストールする 2 つの仮想マシンインスタンスが含まれています。スケールセットは、IP 設定を構成するときにバックエンドプールに割り当てます。

スクリプトを実行する前に、<username> と <password> を実際の値に置き換えます。

$vnet = Get-AzVirtualNetwork `
  -ResourceGroupName myResourceGroupAG `
  -Name myVNet

$appgw = Get-AzApplicationGateway `
  -ResourceGroupName myResourceGroupAG `
  -Name myAppGateway

$backendPool = Get-AzApplicationGatewayBackendAddressPool `
  -Name appGatewayBackendPool `
  -ApplicationGateway $appgw

$imagesPool = Get-AzApplicationGatewayBackendAddressPool `
  -Name imagesBackendPool `
  -ApplicationGateway $appgw

$videoPool = Get-AzApplicationGatewayBackendAddressPool `
  -Name videoBackendPool `
  -ApplicationGateway $appgw

for ($i=1; $i -le 3; $i++)
{
  if ($i -eq 1)
  {
     $poolId = $backendPool.Id
  }
  if ($i -eq 2) 
  {
    $poolId = $imagesPool.Id
  }
  if ($i -eq 3)
  {
    $poolId = $videoPool.Id
  }

  $ipConfig = New-AzVmssIpConfig `
    -Name myVmssIPConfig$i `
    -SubnetId $vnet.Subnets[1].Id `
    -ApplicationGatewayBackendAddressPoolsId $poolId

  $vmssConfig = New-AzVmssConfig `
    -Location eastus `
    -SkuCapacity 2 `
    -SkuName Standard_DS2 `
    -UpgradePolicyMode Automatic

  Set-AzVmssStorageProfile $vmssConfig `
    -ImageReferencePublisher MicrosoftWindowsServer `
    -ImageReferenceOffer WindowsServer `
    -ImageReferenceSku 2016-Datacenter `
    -ImageReferenceVersion latest `
    -OsDiskCreateOption FromImage

  Set-AzVmssOsProfile $vmssConfig `
    -AdminUsername <username> `
    -AdminPassword "<password>" `
    -ComputerNamePrefix myvmss$i

  Add-AzVmssNetworkInterfaceConfiguration `
    -VirtualMachineScaleSet $vmssConfig `
    -Name myVmssNetConfig$i `
    -Primary $true `
    -IPConfiguration $ipConfig

  New-AzVmss `
    -ResourceGroupName myResourceGroupAG `
    -Name myvmss$i `
    -VirtualMachineScaleSet $vmssConfig
}

IIS のインストール

$publicSettings = @{ "fileUris" = (,"https://raw.githubusercontent.com/Azure/azure-docs-powershell-samples/master/application-gateway/iis/appgatewayurl.ps1"); 
  "commandToExecute" = "powershell -ExecutionPolicy Unrestricted -File appgatewayurl.ps1" }

for ($i=1; $i -le 3; $i++)
{
  $vmss = Get-AzVmss -ResourceGroupName myResourceGroupAG -VMScaleSetName myvmss$i

  Add-AzVmssExtension -VirtualMachineScaleSet $vmss `
    -Name "customScript" `
    -Publisher "Microsoft.Compute" `
    -Type "CustomScriptExtension" `
    -TypeHandlerVersion 1.8 `
    -Setting $publicSettings

  Update-AzVmss `
    -ResourceGroupName myResourceGroupAG `
    -Name myvmss$i `
    -VirtualMachineScaleSet $vmss
}

アプリケーションゲートウェイのテスト

Get-AzPublicIPAddress を使用して、アプリケーションゲートウェイのパブリック IP アドレスを取得できます。そのパブリック IP アドレスをコピーし、ブラウザーのアドレスバーに貼り付けます。たとえば、http://52.168.55.24、http://52.168.55.24:8080/images/test.htm、http://52.168.55.24:8080/video/test.htm、http://52.168.55.24:8081/images/test.htm などです。

Get-AzPublicIPAddress -ResourceGroupName myResourceGroupAG -Name myAGPublicIPAddress

アプリケーションゲートウェイでのベース URL のテスト

URL を http://<ip-address>:8080/images/test.htm に変更します。<ip-address> は使用している IP アドレスに置き換えてください。次の例のように表示されます。

アプリケーションゲートウェイでのイメージ URL のテスト

URL を http://<ip-address>:8080/video/test.htm に変更します。<ip-address> は使用している IP アドレスに置き換えてください。次の例のように表示されます。

アプリケーションゲートウェイでのビデオ URL のテスト

URL を http://<ip-address>:8081/images/test.htm に変更します。<ip-address> は使用している IP アドレスに置き換えてください。トラフィックが http://<ip-address>:8080/images の images バックエンドプールにリダイレクトされるのがわかります。

リソースをクリーンアップする

必要がなくなったら、Remove-AzResourceGroup を使用して、リソースグループ、アプリケーションゲートウェイ、およびすべての関連リソースを削除します。

Remove-AzResourceGroup -Name myResourceGroupAG

次のステップ

アプリケーションゲートウェイでできることについてさらに学習する

次の方法で共有

Azure PowerShell を使用して URL パスベースのリダイレクトのあるアプリケーションゲートウェイを作成する

Azure Cloud Shell

リソースグループを作成する

ネットワークリソースを作成する

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

IP 構成とフロントエンドポートの作成

既定のプールと設定の作成

既定のリスナーとルールの作成

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

バックエンドプールとポートの追加

リスナーと規則の追加

リスナーの追加

既定の URL パスマップを追加する

リダイレクト構成を追加する

リダイレクト URL パスマップを追加する

ルーティング規則の追加

仮想マシンスケールセットの作成

IIS のインストール

アプリケーションゲートウェイのテスト

リソースをクリーンアップする

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure PowerShell を使用して URL パスベースのリダイレクトのあるアプリケーション ゲートウェイを作成する

Azure Cloud Shell

リソース グループを作成する

ネットワーク リソースを作成する

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

IP 構成とフロントエンド ポートの作成

既定のプールと設定の作成

既定のリスナーとルールの作成

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

バックエンド プールとポートの追加

リスナーと規則の追加

リスナーの追加

既定の URL パス マップを追加する

リダイレクト構成を追加する

リダイレクト URL パス マップを追加する

ルーティング規則の追加

仮想マシン スケール セットの作成

IIS のインストール

アプリケーション ゲートウェイのテスト

リソースをクリーンアップする

次のステップ

フィードバック

その他のリソース

Azure PowerShell を使用して URL パスベースのリダイレクトのあるアプリケーションゲートウェイを作成する

リソースグループを作成する

ネットワークリソースを作成する

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

IP 構成とフロントエンドポートの作成

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

バックエンドプールとポートの追加

既定の URL パスマップを追加する

リダイレクト URL パスマップを追加する

仮想マシンスケールセットの作成

アプリケーションゲートウェイのテスト