Azure Container Apps でセッションプールを使用する

セッションプールは、1 秒未満のセッション割り当て時間を提供し、各セッションのライフサイクルを管理します。

両方のプールの一般的な概念

プールを作成するプロセスは、コードインタープリターセッションプールとカスタムコンテナープールのどちらを作成するかによって若干異なります。次の概念は、両方に適用されます。

Azure CLI を使用してセッションプールを作成するには、最新バージョンの Azure CLI と Azure Container Apps 拡張機能があることを確認します。

# Upgrade the Azure CLI
az upgrade

# Install or upgrade the Azure Container Apps extension
az extension add --name containerapp --upgrade --allow-preview true -y

一般的なセッションプールコマンドは次のとおりです。

az containerapp sessionpool create
az containerapp sessionpool show
az containerapp sessionpool list
az containerapp sessionpool update
az containerapp sessionpool delete

任意のコマンドで --help を使用して、使用可能な引数とサポートされている値を確認します。

セッションプールの状態を確認するには、 az containerapp sessionpool show コマンドを使用します。

az containerapp sessionpool show \
    --name <SESSION_POOL_NAME> \
    --resource-group <RESOURCE_GROUP> \
    --query "properties.poolManagementEndpoint" \
    --output tsv

プールを作成または更新するときに、同時セッションの最大数、アイドル状態のクールダウン期間、およびセッションに対して送信ネットワークトラフィックを許可するかどうかを設定できます。

Important

エグレスを有効にすると、セッションで実行されているコードがインターネットにアクセスできます。サービス拒否攻撃などの悪意のあるアクティビティの実行に使用できるため、コードが信頼されていない場合は注意が必要です。

Important

セッションを使用して信頼されていないコードを実行する場合は、信頼されていないコードにアクセスしたくない情報やデータを含めないでください。コードが悪意があり、その環境変数、シークレット、ファイルなど、コンテナーへのフルアクセス権を持っているとします。

プールを構成する

セッションプール構成の最新の CLI 引数を表示するには、 az containerapp sessionpool create --help を使用します。このセクションでは、API バージョン間で適用される高度な構成オプションについて説明します。

セッションライフサイクルの構成

セッションプールを作成または更新する場合は、 properties.dynamicPoolConfiguration.lifecycleConfigurationを設定してセッションを終了する方法を構成できます。 API バージョン 2025-01-01以降、2 つのライフサイクルの種類のいずれかを選択します。

完全な API 仕様については、 SessionPools API の仕様を参照してください。

Timed (既定値)

Timedライフサイクルでは、非アクティブな期間が経過するとセッションが削除されます。セッションに送信された要求は、クールダウンタイマーをリセットし、セッションの有効期間を cooldownPeriodInSeconds延長します。

注

Timed は、すべてのセッションプールの種類でサポートされており、以前の API バージョンの executionType: Timed と同じように動作します。

{
  "dynamicPoolConfiguration": {
    "lifecycleConfiguration": {
      "cooldownPeriodInSeconds": 600,
      "lifecycleType": "Timed"
    }
  }
}

プロパティ	Description
`cooldownPeriodInSeconds`	セッションは、この期間の要求がない場合に削除されます。
`maxAlivePeriodInSeconds`	`Timed`ライフサイクルではサポートされていません。

管理エンドポイント

Important

セッション識別子は機密情報であり、その値を作成および管理する際に安全なプロセスが必要です。この値を保護するには、アプリケーションで各ユーザーまたはテナントが独自のセッションにのみアクセスできることを確認する必要があります。

セッションへのアクセスをセキュリティで保護しないと、ユーザーのセッションに格納されているデータへの誤用または未承認のアクセスが発生する可能性があります。詳細については、「セッション識別子」を参照してください。

プール管理エンドポイントに対するすべての要求には、ベアラートークンを含む Authorization ヘッダーが含まれている必要があります。プール管理 API で認証する方法については、「認証」を参照してください。

各 API 要求には、セッション ID と共に identifier クエリ文字列パラメーターも含める必要があります。この一意のセッション ID を使用すると、アプリケーションは特定のセッションと対話できます。セッション識別子の詳細については、「セッション識別子」を参照してください。

イメージキャッシュ

セッションプールが作成または更新されると、Azure Container Apps によってコンテナーイメージがプールにキャッシュされます。このキャッシュは、新しいセッションを作成するプロセスを高速化するのに役立ちます。

イメージに対する変更は、セッションに自動的に反映されません。イメージを更新するには、新しいイメージタグを使用してセッションプールを更新します。イメージの更新ごとに一意のタグを使用して、新しいイメージが確実にプルされるようにします。

az containerapps sessionpool create コマンドを使用してプールを作成します。次の例では、 my-session-poolという名前の Python コードインタープリターセッションプールを作成します。コマンドを実行する前に、 <RESOURCE_GROUP> をリソースグループ名に置き換えてください。

az containerapp sessionpool create \
    --name my-session-pool \
    --resource-group <RESOURCE_GROUP> \
    --location westus2 \
    --container-type PythonLTS \
    --max-sessions 100 \
    --cooldown-period 300 \
    --network-status EgressDisabled

セッションプールを作成するときに、次の設定を定義できます。

Setting	Description
`--container-type`	使用するコードインタープリターの種類。サポートされている値: `PythonLTS`、`NodeLTS`、`Shell`、`CustomContainer`。
`--max-sessions`	同時に許可される割り当て済みセッションの最大数。最大値は `600` です。
`--cooldown-period`	終了するまでに許可されるアイドル時間の秒数。アイドル期間は、セッションの API が呼び出されるたびにリセットされます。使用できる範囲は、 `300` と `3600`の間です。
`--network-status`	セッションからの送信ネットワークトラフィックを許可するかどうかを指定します。有効な値は `EgressDisabled` (既定値) と `EgressEnabled`です。

Azure portal にサインインする
ポータルの上部にある検索バーで、 Container Apps セッションプールを検索して選択します。
を選択してを作成します。

[基本] タブで、以下の値を入力します。

Setting	アクション
Subscription	Azure のサブスクリプションを選択します。
リソースグループ	既存のリソースグループを選択するか、[ 新規作成] を選択します。
セッションプール名	セッションプールの名前を入力します。
リージョン	サポートされているリージョンを選択します。
プールの種類	[コードインタープリター] を選択します。
コンテナーの種類	PythonLTS、NodeLTS、またはシェルを選択します。

[ 構成 ] セクションで、次の値を入力します。

Setting	アクション
セッションの最大数	同時セッションの最大数を入力します。最大値は `600` です。
クールダウン期間 (秒)	セッションが終了するまでのアイドル時間 (秒数) を入力します。使用できる範囲は、`300`から`3600`まで。
アウトバウンドネットワーク	送信トラフィックをブロックするには [無効] を選択し、許可するには [有効] を選択します。

Important

送信ネットワークアクセスを有効にした場合、セッションで実行されているコードはインターネットにアクセスできます。コードが信頼されていない場合は注意が必要です。

[Review + create](レビュー + 作成) を選択します。
検証に合格したら、[ 作成] を選択します。

コードインタープリター管理エンドポイント

LLM フレームワーク統合でコードインタープリターセッションを使用するか、管理 API エンドポイントを直接呼び出すには、プールの管理 API エンドポイントが必要です。

エンドポイントは、 https://<REGION>.dynamicsessions.io/subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/sessionPools/<SESSION_POOL_NAME>形式です。

セッションプールの管理 API エンドポイントを取得するには、上記の一般的なセクションでコマンドの例を参照してください。

プール内のセッションを管理するために、次のエンドポイントを使用できます。

エンドポイントパス	メソッド	Description
`code/execute`	`POST`	セッションでコードを実行します。
`files/upload`	`POST`	セッションにファイルをアップロードします。
`files/content/{filename}`	`GET`	セッションからファイルをダウンロードします。
`files`	`GET`	セッション内のファイルを一覧表示します。

プールの管理 API エンドポイントとエンドポイントパスを連結して、各エンドポイントの完全な URL を構築します。クエリ文字列には、セッション識別子を含むidentifier パラメーターと、api-version値を持つ2024-02-02-preview パラメーターを含める必要があります。 API のバージョンは変更される可能性があるため、運用環境で使用する前に、REST API ドキュメントで常に最新バージョンを確認してください。

例: {sessionManagementEndpoint}/code/execute?api-version=2024-02-02-preview&identifier=<IDENTIFIER>

REST API リファレンスについては、 Container Apps のデータプレーン API と Container Apps のデータプレーン操作の概要に関するページを参照してください。

カスタムコンテナーセッションプール

カスタムコンテナーセッションプールを作成するには、コンテナーイメージとプール構成設定を指定する必要があります。

HTTP 要求を使用して、各セッションを呼び出すか、通信します。カスタムコンテナーは、これらの要求に応答するために指定したポートで HTTP サーバーを公開する必要があります。

次の機能は、カスタムコンテナーセッションプールにのみ適用されます。

カスタムコンテナー管理エンドポイント

カスタムコンテナーセッションプールの場合は、Azure portal または Azure CLI 出力から管理エンドポイントを取得します。エンドポイントは poolManagementEndpointとして返されます。

エンドポイントは、 https://<SESSION_POOL_NAME>.<ENVIRONMENT_ID>.<REGION>.azurecontainerapps.io形式です。

OnContainerExit

OnContainerExitライフサイクルでは、コンテナーが単独で終了するか、最大有効期間に達するまで、セッションはアクティブなままになります。

{
  "dynamicPoolConfiguration": {
    "lifecycleConfiguration": {
      "maxAlivePeriodInSeconds": 6000,
      "lifecycleType": "OnContainerExit"
    }
  }
}

プロパティ	Description
`maxAlivePeriodInSeconds`	セッションが削除されるまでに有効な状態を維持できる最大時間。
`cooldownPeriodInSeconds`	`OnContainerExit`ライフサイクルではサポートされていません。

コンテナープローブ

コンテナープローブを使用すると、セッションコンテナーの正常性チェックを定義できるため、プールは異常なセッションを検出し、それらを置き換えて、 readySessionInstances ターゲットを正常に保つことができます。

セッションプールは Liveness プローブと Startup プローブをサポートします。プローブの動作の詳細については、「 Azure Container Apps の正常性プローブ」を参照してください。

セッションプールを作成または更新する場合は、 properties.customContainerTemplate.containersでプローブを指定します。完全な要求本文スキーマについては、 SessionPools の作成または更新 API リファレンスを参照してください。次の例は、プローブ定義を使用した部分的な構成を示しています。

{
  "properties": {
    "customContainerTemplate": {
      "containers": [
        {
          "name": "my-session-container",
          "image": "myregistry.azurecr.io/my-session-image:latest",
          "probes": [
            {
              "type": "Liveness",
              "httpGet": {
                "path": "/health",
                "port": 8080
              },
              "periodSeconds": 10,
              "failureThreshold": 3
            },
            {
              "type": "Startup",
              "httpGet": {
                "path": "/ready",
                "port": 8080
              },
              "periodSeconds": 5,
              "failureThreshold": 30
            }
          ]
        }
      ]
    },
    "dynamicPoolConfiguration": {
      "readySessionInstances": 5
    }
  }
}

カスタムコンテナーセッションプールには、ワークロードプロファイルが有効な Azure Container Apps 環境が必要です。環境がない場合は、 az containerapp env create -n <ENVIRONMENT_NAME> -g <RESOURCE_GROUP> --location <LOCATION> コマンドを使用して作成します。

az containerapp sessionpool create コマンドを使用して、カスタムコンテナーセッションプールを作成します。

次の例では、カスタムコンテナーイメージ my-session-poolを使用して myregistry.azurecr.io/my-container-image:1.0 という名前のセッションプールを作成します。

要求を送信する前に、 <> 角かっこの間のプレースホルダーを、セッションプールとセッション識別子の適切な値に置き換えます。

az containerapp sessionpool create \
    --name my-session-pool \
    --resource-group <RESOURCE_GROUP> \
    --environment <ENVIRONMENT> \
    --registry-server myregistry.azurecr.io \
    --registry-username <USER_NAME> \
    --registry-password <PASSWORD> \
    --container-type CustomContainer \
    --image myregistry.azurecr.io/my-container-image:1.0 \
    --cpu 0.25 --memory 0.5Gi \
    --target-port 80 \
    --cooldown-period 300 \
    --network-status EgressDisabled \
    --max-sessions 10 \
    --ready-sessions 5 \
    --env-vars "key1=value1" "key2=value2" \
    --location <LOCATION>

このコマンドは、次の設定でセッションプールを作成します。

パラメーター	価値	Description
`--name`	`my-session-pool`	セッションプールの名前。
`--resource-group`	`my-resource-group`	セッションプールを含むリソースグループ。
`--environment`	`my-environment`	コンテナーアプリの環境の名前またはリソース ID。
`--container-type`	`CustomContainer`	セッションプールのコンテナーの種類。カスタムコンテナーセッションには `CustomContainer` が必要です。
`--image`	`myregistry.azurecr.io/my-container-image:1.0`	セッションプールに使用するコンテナーイメージ。
`--registry-server`	`myregistry.azurecr.io`	コンテナーレジストリサーバーのホスト名。
`--registry-username`	`my-username`	コンテナーレジストリにログインするユーザー名。
`--registry-password`	`my-password`	コンテナーレジストリにログインするためのパスワード。
`--cpu`	`0.25`	必要なコア数の CPU。
`--memory`	`0.5Gi`	必要なメモリ。
`--target-port`	`80`	イングレストラフィック用に使うセッションポート。
`--cooldown-period`	`300`	セッションが終了するまでにセッションをアイドル状態にできる秒数。アイドル期間は、セッションの API が呼び出されるたびにリセットされます。値は、 `300` と `3600`の間である必要があります。
`--network-status`	`EgressDisabled`	セッションからの送信ネットワークトラフィックを許可するかどうかを指定します。有効な値は `EgressDisabled` (既定値) と `EgressEnabled`です。
`--max-sessions`	`10`	同時に割り当てることができるセッションの最大数。
`--ready-sessions`	`5`	常にセッションプール内で準備が整っているセッションの目標数。セッションがプールの補充よりも速く割り当てられている場合は、この数を増やします。
`--env-vars`	`"key1=value1" "key2=value2"`	コンテナーで設定する環境変数。
`--location`	`"Supported Location"`	セッションプールの場所。

セッションプールを更新するには、 az containerapp sessionpool update コマンドを使用します。

カスタムコンテナーセッションプールには、ワークロードプロファイルが有効な Azure Container Apps 環境が必要です。

Azure portal にサインインする
ポータルの上部にある検索バーで、 Container Apps セッションプールを検索して選択します。
を選択してを作成します。

[基本] タブで、以下の値を入力します。

Setting	アクション
Subscription	Azure のサブスクリプションを選択します。
リソースグループ	既存のリソースグループを選択するか、[ 新規作成] を選択します。
セッションプール名	セッションプールの名前を入力します。
プールの種類	[カスタムコンテナー] を選択します。
最大同時セッション数	同時に割り当てることができるセッションの最大数を入力します。
セッションのクールダウン期間 (秒)	セッションが終了するまでのアイドル時間 (秒数) を入力します。使用できる範囲は、`300`から`3600`まで。
準備が整ったセッションインスタンス	プール内で常に準備を整えるセッションの目標数を入力します。
ネットワーク出口	送信トラフィックをブロックするには [無効] を選択し、許可するには [有効] を選択します。

[ Container Apps environment]\(コンテナーアプリ環境 \) セクションで、次の値を入力します。

Setting	アクション
リージョン	サポートされているリージョンを選択します。
Container Apps 環境	既存の環境を選択するか、[ 新しい環境の作成] を選択します。

注

環境には Log Analytics ワークスペースが含まれています。仮想ネットワークと Application Insights を追加することもできます。すべてのリージョンの環境を表示するには、[ すべてのリージョンの環境を表示] を選択します。

[ コンテナー ] タブで、次の値を入力します。

[セッションカスタムコンテナーソース] セクションで、次の値を入力します。

Setting	アクション
名前	コンテナーの名前を入力します。
ビルドタイプ	コンテナーのビルドの種類を選択します。
Subscription	コンテナーレジストリを含むサブスクリプションを選択します。
レジストリ	コンテナーレジストリを選択します。
Image	コンテナーイメージを選択します。
イメージタグ	イメージタグを選択します。
コマンドのオーバーライド	(省略可能)コンテナーの既定のエントリポイントをオーバーライドするコマンドを入力します。例: `/bin/bash`。
引数のオーバーライド	(省略可能)コマンドオーバーライドに渡す引数を入力します。例: `-c, while true; do echo hello; sleep 10; done`。

注

これらの設定は、セッションプールの作成後に更新できます。

[ イングレス ] セクションで、次の値を入力します。

Setting	アクション
ターゲットポート	セッションコンテナーが HTTP トラフィック用に公開するポートを入力します。既定値は `80` です。

[ コンテナーリソースの割り当て ] セクションで、コンテナーの CPU とメモリ の割り当てを選択します。

必要に応じて、[環境変数] セクションに 環境変数 を追加します。

[Review + create](レビュー + 作成) を選択します。
検証に合格したら、[ 作成] を選択します。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-03-13

次の方法で共有

Azure Container Apps でセッション プールを使用する

両方のプールの一般的な概念

プールを構成する

セッション ライフサイクルの構成

Timed (既定値)

管理エンドポイント

イメージ キャッシュ

コード インタープリター セッション プール

コード インタープリター管理エンドポイント

カスタム コンテナー セッション プール

カスタム コンテナー管理エンドポイント

OnContainerExit

コンテナー プローブ

フィードバック

その他のリソース

Azure Container Apps でセッションプールを使用する

セッションライフサイクルの構成

イメージキャッシュ

コードインタープリターセッションプール

コードインタープリター管理エンドポイント

カスタムコンテナーセッションプール

カスタムコンテナー管理エンドポイント

コンテナープローブ