チュートリアル: コンテナーアプリをスケーリングする

[アーティクル]
05/10/2024

Azure Container Apps では、宣言型スケーリングルールのセットにより、自動水平スケーリングが管理されます。コンテナーアプリがスケールアウトされるときは、コンテナーアプリの新しいインスタンスがオンデマンドで作成されます。これらのインスタンスはレプリカと呼ばれます。

このチュートリアルでは、コンテナーアプリに HTTP スケールルールを追加し、アプリケーションがどのようにスケーリングされるかを確認します。

前提条件

要件	手順
Azure アカウント	Azure アカウントがない場合は、無料で作成できます。続行するには、Azure サブスクリプションの "共同作成者" アクセス許可が必要です。詳細については、「Azure portal を使用して Azure ロールを割り当てる」を参照してください。
GitHub アカウント	1 つ無料で取得できます。
Azure CLI	Azure CLI をインストールします。

セットアップ

CLI から Azure にサインインするには、次のコマンドを実行し、プロンプトに従って認証プロセスを完了します。

Bash
Azure PowerShell

az login

Connect-AzAccount

最新バージョンの CLI を実行していることを確認するには、upgrade コマンドを実行します。

Bash
Azure PowerShell

az upgrade

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

現在使用中のモジュールに関する警告は無視します。

次に、CLI 用の Azure Container Apps 拡張機能をインストールまたは更新します。

Bash
Azure PowerShell

az extension add --name containerapp --upgrade

Install-Module -Name Az.App

Az.App モジュールの古いバージョンがインストールされている場合は、更新します。

Update-Module -Name Az.App

最新の拡張機能またはモジュールがインストールされたので、Microsoft.App および Microsoft.OperationalInsights 名前空間を登録します。

Note

Azure Container Apps リソースは、Microsoft.Web 名前空間から Microsoft.App 名前空間に移行されました。詳細については、「2022 年 3 月に Microsoft.Web から Microsoft.App に名前空間を移行する」を参照してください。

Bash
Azure PowerShell

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

コンテナーアプリを作成してデプロイする

containerapp up コマンドを使用して、コンテナーアプリを作成してデプロイします。このコマンドを実行すると、次のものが作成されます。

リソースグループ
Container Apps 環境
Log Analytics ワークスペース

これらのリソースのいずれかが既に存在する場合、コマンドは新しいリソースを作成するのではなく、既存のリソースを使用します。

最後に、コマンドは、パブリックコンテナーイメージを使用してコンテナーアプリを作成し、デプロイします。

Bash
Azure PowerShell

az containerapp up \
  --name my-container-app \
  --resource-group my-container-apps \
  --location centralus \
  --environment 'my-container-apps' \
  --image mcr.microsoft.com/k8se/quickstart:latest \
  --target-port 8080 \
  --ingress external \
  --query properties.configuration.ingress.fqdn \

az containerapp up `
  --name my-container-app `
  --resource-group my-container-apps `
  --location centralus `
  --environment my-container-apps `
  --image mcr.microsoft.com/k8se/quickstart:latest `
  --target-port 8080 `
  --ingress external `
  --query properties.configuration.ingress.fqdn `

注意

--image パラメーターの値が小文字であることを確認してください。

--ingress を external に設定すると、コンテナーアプリがパブリック要求で使用できるようになります。

up コマンドによって、コンテナーアプリの完全修飾ドメイン名 (FQDN) が返されます。この FQDN をテキストファイルにコピーします。これは、「要求を送信する」セクションで使用します。 FQDN は次の例のようになります。

https://my-container-app.icydune-96848328.centralus.azurecontainerapps.io

スケールルールを追加する

az containerapp update コマンドを実行して、コンテナーアプリに HTTP スケールルールを追加します。

Bash
Azure PowerShell

az containerapp update \
	--name my-container-app \
	--resource-group my-container-apps \
    --scale-rule-name my-http-scale-rule \
    --scale-rule-http-concurrency 1

az containerapp update `
	--name my-container-app `
	--resource-group my-container-apps `
    --scale-rule-name my-http-scale-rule `
    --scale-rule-http-concurrency 1

このコマンドを実行すると、my-http-scale-rule という名前と1 のコンカレンシー設定を使用して、コンテナーアプリに HTTP スケールルールが追加されます。アプリが複数の同時 HTTP 要求を受信した場合、ランタイムによって、要求を処理するアプリのレプリカが作成されます。

update コマンドによって、要求が成功したことを確認するための JSON 応答として新しい構成が返されます。

ログ出力を開始する

Container Apps ランタイムによって生成されたログを表示することで、アプリケーションのスケーリングの効果を確認できます。 az containerapp logs show コマンドを使用して、ログエントリのリッスンを開始します。

Bash
Azure PowerShell

az containerapp logs show \
	--name my-container-app \
	--resource-group my-container-apps \
	--type=system \
	--follow=true

az containerapp logs show `
	--name my-container-app `
	--resource-group my-container-apps `
	--type=system `
	--follow=true

show コマンドによって、コンテナーアプリのシステムログからリアルタイムでエントリが返されます。次の例のような応答が表示されるはずです。

{
	"TimeStamp":"2023-08-01T16:49:03.02752",
	"Log":"Connecting to the container 'my-container-app'..."
}
{
	"TimeStamp":"2023-08-01T16:49:03.04437",
	"Log":"Successfully Connected to container:
	'my-container-app' [Revision: 'my-container-app--9uj51l6',
	Replica: 'my-container-app--9uj51l6-5f96557ffb-5khg9']"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9480811+00:00",
	"Log":"Microsoft.Hosting.Lifetime[14]"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9481264+00:00",
	"Log":"Now listening on: http://[::]:8080"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9490917+00:00",
	"Log":"Microsoft.Hosting.Lifetime[0]"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9491036+00:00",
	"Log":"Application started. Press Ctrl+C to shut down."
}
{
	"TimeStamp":"2023-08-01T16:47:31.949723+00:00",
	"Log":"Microsoft.Hosting.Lifetime[0]"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9497292+00:00",
	"Log":"Hosting environment: Production"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9497325+00:00",
	"Log":"Microsoft.Hosting.Lifetime[0]"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9497367+00:00",
	"Log":"Content root path: /app/"
}

詳細については、「az containerapp logs」を参照してください。

新しい bash シェルを開きます。次のコマンドを実行し、<YOUR_CONTAINER_APP_FQDN> を、「コンテナーアプリを作成してデプロイする」セクションで保存したコンテナーアプリの完全修飾ドメイン名に置き換えます。

seq 1 50 | xargs -Iname -P10 curl "<YOUR_CONTAINER_APP_FQDN>"

これらのコマンドは、それぞれ 10 個の要求の同時実行バッチで、50 個の要求をコンテナーアプリに送信します。

コマンドまたは引数	説明
`seq 1 50`	1 から 50 までの数値のシーケンスを生成します。
`\|`	パイプ演算子は、`xargs` コマンドにシーケンスを送信します。
`xargs`	指定した URL を使用して `curl` を実行します。
`-Iname`	`seq` の出力のプレースホルダーとして機能します。この引数を指定すると、戻り値が `curl` コマンドに送信されなくなります。
`curl`	指定された URL を呼び出します。
`-P10`	一度に最大 10 個のプロセスを実行するように `xargs` に指示します。

詳細については、次に関するドキュメントを参照してください。

新しいコマンドプロンプトを開き、「PowerShell」と入力します。次のコマンドを実行し、<YOUR_CONTAINER_APP_FQDN> を、「コンテナーアプリを作成してデプロイする」セクションで保存したコンテナーアプリの完全修飾ドメイン名に置き換えます。

$url="<YOUR_CONTAINER_APP_FQDN>"
$Runspace = [runspacefactory]::CreateRunspacePool(1,10)
$Runspace.Open()
1..50 | % {
    $ps = [powershell]::Create()
    $ps.RunspacePool = $Runspace
    [void]$ps.AddCommand("Invoke-WebRequest").AddParameter("UseBasicParsing",$true).AddParameter("Uri",$url)
    [void]$ps.BeginInvoke()
}

これらのコマンドは、それぞれ 10 個の要求の非同期バッチで、50 個の要求をコンテナーアプリに送信します。

コマンドまたは引数	説明
`[runspacefactory]::CreateRunspacePool(1,10)`	最大 10 個の実行空間を同時に実行できる `RunspacePool` を作成します。
`1..50 \| % { }`	中かっこで囲まれたコードを 50 回実行します。
`$ps = [powershell]::Create()`	新しい PowerShell インスタンスを作成します。
`$ps.RunspacePool = $Runspace`	`RunspacePool` で実行するように PowerShell インスタンスに指示します。
`[void]$ps.AddCommand("Invoke-WebRequest")`	コンテナーアプリに要求を送信します。
`.AddParameter("UseBasicParsing", $true)`	コンテナーアプリに要求を送信します。
`.AddParameter("Uri", $url)`	コンテナーアプリに要求を送信します。
`[void]$ps.BeginInvoke()`	非同期的に実行するように PowerShell インスタンスに指示します。

詳細については、「PowerShell 実行空間の使用を開始する」を参照してください。

az containerapp logs show コマンドを実行した最初のシェルでは、次のような 1 つ以上のログエントリが出力に含まれるようになりました。

{
	"TimeStamp":"2023-08-01 18:09:52 +0000 UTC",
	"Type":"Normal",
	"ContainerAppName":"my-container-app",
	"RevisionName":"my-container-app--9uj51l6",
	"ReplicaName":"my-container-app--9uj51l6-5f96557ffb-f795d",
	"Msg":"Replica 'my-container-app--9uj51l6-5f96557ffb-f795d' has been scheduled to run on a node.",
	"Reason":"AssigningReplica",
	"EventSource":"ContainerAppController",
	"Count":0
}

Azure portal でスケーリングを表示する (省略可能)

Azure portal にサインインします。
上部の [検索] バーに「my-container-app」と入力します。
検索結果の [リソース] で、[my-container-app] を選択します。
左側のナビゲーションバーで、[アプリケーション] を展開し、[Scale and replicas] (スケールとレプリカ) を選択します。
[Scale and replicas] (スケールとレプリカ) ページで、[レプリカ] を選択します。
コンテナーアプリで複数のレプリカが実行されるようになりました。

コンテナーアプリのレプリカのスクリーンショット。

新しいレプリカを表示するには、[最新の情報に更新] を選択する必要がある場合があります。

左側のナビゲーションバーで、[監視] を展開し、[メトリック] を選択します。
[メトリック] ページで、[メトリック] を [要求] に設定します。
[分割の適用] を選択します。
[値] ドロップダウンを展開し、[レプリカ] をオンにします。
青いチェックマークアイコンを選択して、分割の編集を完了します。
グラフには、コンテナーアプリが受信した要求がレプリカ別に分割されて表示されます。
既定では、グラフのスケールは過去 24 時間 (時間の細分性は 15 分) に設定されています。スケールを選択し、過去 30 分間 (時間の細分性は 1 分) に変更します。 [適用] ボタンを選択します。
グラフを選択し、ドラッグして、コンテナーアプリが受信した要求の最近の増加を強調表示します。

30 分間のスケール (時間の細分性は 1 分) で、要求がレプリカ別に分割されて表示されているコンテナーアプリのメトリックグラフのスクリーンショット。

次のスクリーンショットは、コンテナーアプリが受信した要求がレプリカ間でどのように分割されるのかを表す拡大ビューを示しています。

要求がレプリカ別に分割されて表示されているコンテナーアプリのメトリックグラフ (拡大ビュー) のスクリーンショット。

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

このアプリケーションを引き続き使用しない場合は、次のコマンドを実行して、このチュートリアルで作成したすべてのリソースと共にリソースグループを削除してください。

注意事項

次のコマンドを実行すると、指定されたリソースグループとそれに含まれるすべてのリソースが削除されます。指定したリソースグループにこのチュートリアルの範囲外のリソースが含まれている場合、それらも削除されます。

az group delete --name my-container-apps

ヒント

問題がある場合は、 GitHub の Azure Container Apps リポジトリでイシューを開いて、お知らせください。

次のステップ

Azure Container Apps でスケーリングルールを設定する

Share via

チュートリアル: コンテナーアプリをスケーリングする

前提条件

セットアップ

コンテナーアプリを作成してデプロイする

スケールルールを追加する

ログ出力を開始する

要求を送信する

Azure portal でスケーリングを表示する (省略可能)

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

次のステップ

その他のリソース

Share via

チュートリアル: コンテナー アプリをスケーリングする

前提条件

セットアップ

コンテナー アプリを作成してデプロイする

スケール ルールを追加する

ログ出力を開始する

要求を送信する

Azure portal でスケーリングを表示する (省略可能)

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

次のステップ

その他のリソース

チュートリアル: コンテナーアプリをスケーリングする

コンテナーアプリを作成してデプロイする

スケールルールを追加する