Azure PowerShell を使用して、URL に基づいて Web トラフィックをルーティングする

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

Azure PowerShell を使用して、アプリケーションにアクセスするために使用する URL に基づいた特定のスケーラブルなサーバープールへの Web トラフィックのルーティングを構成できます。この記事では、仮想マシンスケールセットを使用して、3 つのバックエンドプールがある Azure Application Gateway を作成します。各バックエンドプールは、共通のデータ、画像、およびビデオなどの特定の目的に役立ちます。個別のプールにトラフィックをルーティングすることにより、ユーザーが必要なときに必要な情報を取得できます。

トラフィックのルーティングを有効にするには、特定のポートでリッスンするリスナーに割り当てられるルーティング規則を作成し、Web トラフィックが、プール内の適切なサーバーに到着するようにします。

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

ネットワークのセットアップ
リスナー、URL パスマップ、およびルールの作成
スケーラブルなバックエンドプールの作成

URL ルーティングの例

好みに応じて、Azure CLI または Azure portal を使用してこの手順を行うこともできます。

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 をローカルで実行している場合、Login-AzAccount を実行して Azure との接続を作成することも必要です。

リソースの作成に時間が必要なため、この手順を完了するには最大で 90 分かかる場合があります。

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

アプリケーションのすべてのリソースを含むリソースグループを作成します。

New-AzResourceGroup を使用して Azure リソースグループを作成します。

New-AzResourceGroup -Name myResourceGroupAG -Location eastus

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

既存の仮想ネットワークがある場合も、新しく作成する場合も、そのネットワークに、アプリケーションゲートウェイのみに使用するサブネットが含まれるようにする必要があります。この記事では、アプリケーションゲートウェイ用のサブネットと、スケールセット用のサブネットを作成します。パブリック IP アドレスを作成し、アプリケーションゲートウェイ内のリソースにアクセスできるようにします。

New-AzVirtualNetworkSubnetConfig を使用して、サブネット構成 myAGSubnet および myBackendSubnet を作成します。 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

$vnet = New-AzVirtualNetwork `
  -ResourceGroupName myResourceGroupAG `
  -Location eastus `
  -Name myVNet `
  -AddressPrefix 10.0.0.0/16 `
  -Subnet $backendSubnetConfig, $agSubnetConfig
$pip = New-AzPublicIpAddress `
  -ResourceGroupName myResourceGroupAG `
  -Location eastus `
  -Name myAGPublicIPAddress `
  -AllocationMethod Static `
  -Sku Standard

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

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

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

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

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

$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-AzApplicationGatewayBackendHttpSetting を使用して、バックエンドプールの設定を構成します。

$defaultPool = New-AzApplicationGatewayBackendAddressPool `
  -Name appGatewayBackendPool

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

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

アプリケーションゲートウェイがバックエンドプールに対して適切にトラフィックをルーティングするためにはリスナーが必要です。この記事では、2 つのリスナーを作成します。最初に作成する基本的なリスナーは、ルート URL でトラフィックをリッスンします。 2 番目に作成するリスナーは、特定の URL でトラフィックをリッスンします。

New-AzApplicationGatewayHttpListener と、前に作成したフロントエンド構成およびフロントエンドポートを使用して、myDefaultListener という名前の既定のリスナーを作成します。

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

$defaultlistener = New-AzApplicationGatewayHttpListener `
  -Name myDefaultListener `
  -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_v2 `
  -Tier Standard_v2 `
  -Capacity 2

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

アプリケーションゲートウェイの作成には最大で 30 分かかる場合があります。次のセクションに進む前に、デプロイが正常に完了するまで待機します。

この時点で、ポート 80 でトラフィックをリッスンして既定のサーバープールにそのトラフィックを送信する、アプリケーションゲートウェイがあります。

イメージおよびビデオのバックエンドプールとポートの追加

imagesBackendPool および videoBackendPool という名前のバックエンドプールをアプリケーションゲートウェイに追加するには、Add-AzApplicationGatewayBackendAddressPool を使用します。 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

Set-AzApplicationGateway -ApplicationGateway $appgw

アプリケーションゲートウェイの更新にも、完了まで最大 20 分かかることがあります。

バックエンドリスナーの追加

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

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

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

$fipconfig = Get-AzApplicationGatewayFrontendIPConfig `
  -ApplicationGateway $appgw

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

Set-AzApplicationGateway -ApplicationGateway $appgw

URL パスマップの追加

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

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

$poolSettings = Get-AzApplicationGatewayBackendHttpSetting `
  -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

ルーティング規則の追加

ルーティング規則は、URL マップを、作成したリスナーに関連付けます。 Add-AzApplicationGatewayRequestRoutingRule を使用して、rule2 という名前のルールを追加します。

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

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

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

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

Set-AzApplicationGateway -ApplicationGateway $appgw

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

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

$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_v2 `
    -UpgradePolicyMode Automatic

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

  Set-AzVmssOsProfile $vmssConfig `
    -AdminUsername azureuser `
    -AdminPassword "Azure123456!" `
    -ComputerNamePrefix myvmss$i

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

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

IIS のインストール

各スケールセットには、IIS をインストールする 2 つの仮想マシンインスタンスが含まれています。アプリケーションゲートウェイが動作しているかどうかをテストするためのサンプルページが作成されます。

$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 などです。

Get-AzPublicIPAddress -ResourceGroupName myResourceGroupAG -Name myAGPublicIPAddress

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

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

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

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

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

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

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

Remove-AzResourceGroup -Name myResourceGroupAG

次のステップ

URL に基づく Web トラフィックのリダイレクト

次の方法で共有

Azure PowerShell を使用して、URL に基づいて Web トラフィックをルーティングする

Azure Cloud Shell

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

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

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

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

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

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

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

イメージおよびビデオのバックエンドプールとポートの追加

バックエンドリスナーの追加

URL パスマップの追加

ルーティング規則の追加

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

IIS のインストール

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

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

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure PowerShell を使用して、URL に基づいて Web トラフィックをルーティングする

Azure Cloud Shell

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

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

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

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

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

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

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

イメージおよびビデオのバックエンド プールとポートの追加

バックエンド リスナーの追加

URL パス マップの追加

ルーティング規則の追加

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

IIS のインストール

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

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

次のステップ

フィードバック

その他のリソース

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

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

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

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

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

イメージおよびビデオのバックエンドプールとポートの追加

バックエンドリスナーの追加

URL パスマップの追加

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

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