Bicep リソース定義
sessionPools リソースの種類は、次をターゲットとする操作と共にデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.App/sessionPools リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.App/sessionPools@2024-10-02-preview' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
containerType: 'string'
customContainerTemplate: {
containers: [
{
args: [
'string'
]
command: [
'string'
]
env: [
{
name: 'string'
secretRef: 'string'
value: 'string'
}
]
image: 'string'
name: 'string'
resources: {
cpu: int
memory: 'string'
}
}
]
ingress: {
targetPort: int
}
registryCredentials: {
identity: 'string'
passwordSecretRef: 'string'
server: 'string'
username: 'string'
}
}
dynamicPoolConfiguration: {
cooldownPeriodInSeconds: int
executionType: 'string'
}
environmentId: 'string'
managedIdentitySettings: [
{
identity: 'string'
lifecycle: 'string'
}
]
poolManagementType: 'string'
scaleConfiguration: {
maxConcurrentSessions: int
readySessionInstances: int
}
secrets: [
{
name: 'string'
value: 'string'
}
]
sessionNetworkConfiguration: {
status: 'string'
}
}
tags: {
{customized property}: 'string'
}
}
プロパティ値
Microsoft.App/sessionPools
名前 | 説明 | 価値 |
---|---|---|
アイデンティティ | コード内のシークレットや資格情報を保持しないように、他の Azure サービスと対話するためにセッション プールで必要なマネージド ID。 | ManagedServiceIdentity の |
ロケーション | リソースが存在する地理的な場所 | string (必須) |
名前 | リソース名 | 糸 制約: 最小長 = 3 最大長 = 63 パターン = ^[a-z][a-z0-9]*$ (必須) |
プロパティ | コンテナー アプリ セッション プールのリソース固有のプロパティ | セッションプールプロパティ |
タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
CustomContainerTemplate
名前 | 説明 | 価値 |
---|---|---|
コンテナー | セッション プールのセッションのコンテナー定義の一覧。 | セッションコンテナ[] |
進入 | セッション プールのイングレス構成。 | セッションイングレス |
レジストリ資格情報 | セッション プールのセッションで使用されるコンテナーのプライベート コンテナー レジストリ資格情報。 | SessionRegistryCredentials |
ダイナミックプール構成
名前 | 説明 | 価値 |
---|---|---|
クールダウン期間(秒) | セッションのクールダウン期間 (秒単位)。 | 整数 (int) |
実行タイプ | セッション プールの実行の種類。 | 「タイミング」 |
EnvironmentVar (環境変数)
名前 | 説明 | 価値 |
---|---|---|
名前 | 環境変数の名前。 | ひも |
secretRef です。 | 環境変数の値をプルするコンテナー アプリ シークレットの名前。 | ひも |
価値 | シークレット以外の環境変数の値。 | ひも |
ManagedIdentitySetting
名前 | 説明 | 価値 |
---|---|---|
アイデンティティ | セッション プールに割り当てられているユーザー割り当てマネージド ID のリソース ID。システム割り当て ID の場合は "system" です。 | string (必須) |
ライフサイクル | マネージド ID を使用できるセッション プールのライフサイクル ステージを選択するために使用します。 | 「すべて」 '初期化' 「メイン」 「なし」 |
マネージドサービスアイデンティティ
名前 | 説明 | 価値 |
---|---|---|
種類 | マネージド サービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。 | 「なし」 'システム割り当て' 'システム割り当て済み、ユーザー割り当て済み' 'UserAssigned' (必須) |
userAssignedIdentities (ユーザー割り当て済みアイデンティティ) | リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリ キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。 ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。 | UserAssignedIdentities の |
スケールコンフィギュレーション
名前 | 説明 | 価値 |
---|---|---|
maxConcurrentSessions (英語) | 同時に行うセッションの最大数。 | 整数 (int) |
readySessionInstances の | 準備完了セッション インスタンスの最小数。 | 整数 (int) |
セッションコンテナ
名前 | 説明 | 価値 |
---|---|---|
引数 | コンテナーの開始コマンド引数。 | 文字列[] |
コマンド | コンテナーの開始コマンド。 | 文字列[] |
環境 | コンテナー環境変数。 | EnvironmentVar[] |
画像 | コンテナー イメージ タグ。 | ひも |
名前 | カスタム コンテナー名。 | ひも |
リソース | コンテナー リソースの要件。 | セッションコンテナリソース |
セッションコンテナリソース
名前 | 説明 | 価値 |
---|---|---|
CPUの | コアで必要な CPU (例: 0.5) | 整数 (int) |
記憶 | 必要なメモリ (例: "250Mb" ) | ひも |
セッションイングレス
名前 | 説明 | 価値 |
---|---|---|
ターゲットポート | イングレスからのトラフィックのコンテナー内のターゲット ポート | 整数 (int) |
セッションネットワーク構成
名前 | 説明 | 価値 |
---|---|---|
ステータス | セッションのネットワーク状態。 | 「EgressDisabled」 「EgressEnabled」 |
セッションプールプロパティ
名前 | 説明 | 価値 |
---|---|---|
コンテナタイプ | セッションのコンテナーの種類。 | 「カスタムコンテナ」 「PythonLTS」 |
カスタムコンテナテンプレート | containerType が CustomContainer の場合のカスタム コンテナー構成。 | CustomContainerTemplate の |
dynamicPoolConfiguration (動的プール構成) | poolManagementType が動的な場合のプール構成。 | ダイナミックプール構成 |
環境ID | セッション プールの環境のリソース ID。 | ひも |
managedIdentitySettings | セッション プールに割り当てられているマネージド ID のオプション設定。 | ManagedIdentity設定[] |
poolManagementType (プールマネジメントタイプ) | セッション プールのプール管理の種類。 | 「ダイナミック」 「マニュアル」 |
スケール設定 | セッション プールのスケール構成。 | スケールコンフィギュレーション |
秘密 | セッション プールのシークレット。 | セッションプールシークレット[] |
セッションネットワーク構成 | セッション プール内のセッションのネットワーク構成。 | セッションネットワーク構成 |
セッションプールシークレット
名前 | 説明 | 価値 |
---|---|---|
名前 | シークレット名。 | ひも |
価値 | シークレット値。 | 糸 制約: 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 |
SessionRegistryCredentials
名前 | 説明 | 価値 |
---|---|---|
アイデンティティ | Azure Container Registry での認証に使用するマネージド ID。 ユーザー割り当て ID の場合は、完全なユーザー割り当て ID リソース ID を使用します。 システム割り当て ID の場合は、'system' を使用します | ひも |
passwordSecretRef | レジストリ ログイン パスワードを含むシークレットの名前 | ひも |
サーバー | コンテナー レジストリ サーバー。 | ひも |
ユーザー名 | コンテナー レジストリのユーザー名。 | ひも |
追跡リソースタグ
名前 | 説明 | 価値 |
---|
UserAssignedIdentities (ユーザー割り当てアイデンティティ)
名前 | 説明 | 価値 |
---|
ユーザー割り当て識別子
名前 | 説明 | 価値 |
---|
使用例
Azure 検証済みモジュール
次の Azure 検証済みモジュール を使用して、このリソースの種類をデプロイできます。
モジュール | 説明 |
---|---|
アプリ セッション プールの | アプリ セッション プール用の AVM リソース モジュール |
ARM テンプレート リソース定義
sessionPools リソースの種類は、次をターゲットとする操作と共にデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.App/sessionPools リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.App/sessionPools",
"apiVersion": "2024-10-02-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"containerType": "string",
"customContainerTemplate": {
"containers": [
{
"args": [ "string" ],
"command": [ "string" ],
"env": [
{
"name": "string",
"secretRef": "string",
"value": "string"
}
],
"image": "string",
"name": "string",
"resources": {
"cpu": "int",
"memory": "string"
}
}
],
"ingress": {
"targetPort": "int"
},
"registryCredentials": {
"identity": "string",
"passwordSecretRef": "string",
"server": "string",
"username": "string"
}
},
"dynamicPoolConfiguration": {
"cooldownPeriodInSeconds": "int",
"executionType": "string"
},
"environmentId": "string",
"managedIdentitySettings": [
{
"identity": "string",
"lifecycle": "string"
}
],
"poolManagementType": "string",
"scaleConfiguration": {
"maxConcurrentSessions": "int",
"readySessionInstances": "int"
},
"secrets": [
{
"name": "string",
"value": "string"
}
],
"sessionNetworkConfiguration": {
"status": "string"
}
},
"tags": {
"{customized property}": "string"
}
}
プロパティ値
Microsoft.App/sessionPools
名前 | 説明 | 価値 |
---|---|---|
apiVersion (英語) | API のバージョン | 「2024-10-02-プレビュー」 |
アイデンティティ | コード内のシークレットや資格情報を保持しないように、他の Azure サービスと対話するためにセッション プールで必要なマネージド ID。 | ManagedServiceIdentity の |
ロケーション | リソースが存在する地理的な場所 | string (必須) |
名前 | リソース名 | 糸 制約: 最小長 = 3 最大長 = 63 パターン = ^[a-z][a-z0-9]*$ (必須) |
プロパティ | コンテナー アプリ セッション プールのリソース固有のプロパティ | セッションプールプロパティ |
タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
種類 | リソースの種類 | 「Microsoft.App/sessionPools」 |
CustomContainerTemplate
名前 | 説明 | 価値 |
---|---|---|
コンテナー | セッション プールのセッションのコンテナー定義の一覧。 | セッションコンテナ[] |
進入 | セッション プールのイングレス構成。 | セッションイングレス |
レジストリ資格情報 | セッション プールのセッションで使用されるコンテナーのプライベート コンテナー レジストリ資格情報。 | SessionRegistryCredentials |
ダイナミックプール構成
名前 | 説明 | 価値 |
---|---|---|
クールダウン期間(秒) | セッションのクールダウン期間 (秒単位)。 | 整数 (int) |
実行タイプ | セッション プールの実行の種類。 | 「タイミング」 |
EnvironmentVar (環境変数)
名前 | 説明 | 価値 |
---|---|---|
名前 | 環境変数の名前。 | ひも |
secretRef です。 | 環境変数の値をプルするコンテナー アプリ シークレットの名前。 | ひも |
価値 | シークレット以外の環境変数の値。 | ひも |
ManagedIdentitySetting
名前 | 説明 | 価値 |
---|---|---|
アイデンティティ | セッション プールに割り当てられているユーザー割り当てマネージド ID のリソース ID。システム割り当て ID の場合は "system" です。 | string (必須) |
ライフサイクル | マネージド ID を使用できるセッション プールのライフサイクル ステージを選択するために使用します。 | 「すべて」 '初期化' 「メイン」 「なし」 |
マネージドサービスアイデンティティ
名前 | 説明 | 価値 |
---|---|---|
種類 | マネージド サービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。 | 「なし」 'システム割り当て' 'システム割り当て済み、ユーザー割り当て済み' 'UserAssigned' (必須) |
userAssignedIdentities (ユーザー割り当て済みアイデンティティ) | リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリ キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。 ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。 | UserAssignedIdentities の |
スケールコンフィギュレーション
名前 | 説明 | 価値 |
---|---|---|
maxConcurrentSessions (英語) | 同時に行うセッションの最大数。 | 整数 (int) |
readySessionInstances の | 準備完了セッション インスタンスの最小数。 | 整数 (int) |
セッションコンテナ
名前 | 説明 | 価値 |
---|---|---|
引数 | コンテナーの開始コマンド引数。 | 文字列[] |
コマンド | コンテナーの開始コマンド。 | 文字列[] |
環境 | コンテナー環境変数。 | EnvironmentVar[] |
画像 | コンテナー イメージ タグ。 | ひも |
名前 | カスタム コンテナー名。 | ひも |
リソース | コンテナー リソースの要件。 | セッションコンテナリソース |
セッションコンテナリソース
名前 | 説明 | 価値 |
---|---|---|
CPUの | コアで必要な CPU (例: 0.5) | 整数 (int) |
記憶 | 必要なメモリ (例: "250Mb" ) | ひも |
セッションイングレス
名前 | 説明 | 価値 |
---|---|---|
ターゲットポート | イングレスからのトラフィックのコンテナー内のターゲット ポート | 整数 (int) |
セッションネットワーク構成
名前 | 説明 | 価値 |
---|---|---|
ステータス | セッションのネットワーク状態。 | 「EgressDisabled」 「EgressEnabled」 |
セッションプールプロパティ
名前 | 説明 | 価値 |
---|---|---|
コンテナタイプ | セッションのコンテナーの種類。 | 「カスタムコンテナ」 「PythonLTS」 |
カスタムコンテナテンプレート | containerType が CustomContainer の場合のカスタム コンテナー構成。 | CustomContainerTemplate の |
dynamicPoolConfiguration (動的プール構成) | poolManagementType が動的な場合のプール構成。 | ダイナミックプール構成 |
環境ID | セッション プールの環境のリソース ID。 | ひも |
managedIdentitySettings | セッション プールに割り当てられているマネージド ID のオプション設定。 | ManagedIdentity設定[] |
poolManagementType (プールマネジメントタイプ) | セッション プールのプール管理の種類。 | 「ダイナミック」 「マニュアル」 |
スケール設定 | セッション プールのスケール構成。 | スケールコンフィギュレーション |
秘密 | セッション プールのシークレット。 | セッションプールシークレット[] |
セッションネットワーク構成 | セッション プール内のセッションのネットワーク構成。 | セッションネットワーク構成 |
セッションプールシークレット
名前 | 説明 | 価値 |
---|---|---|
名前 | シークレット名。 | ひも |
価値 | シークレット値。 | 糸 制約: 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 |
SessionRegistryCredentials
名前 | 説明 | 価値 |
---|---|---|
アイデンティティ | Azure Container Registry での認証に使用するマネージド ID。 ユーザー割り当て ID の場合は、完全なユーザー割り当て ID リソース ID を使用します。 システム割り当て ID の場合は、'system' を使用します | ひも |
passwordSecretRef | レジストリ ログイン パスワードを含むシークレットの名前 | ひも |
サーバー | コンテナー レジストリ サーバー。 | ひも |
ユーザー名 | コンテナー レジストリのユーザー名。 | ひも |
追跡リソースタグ
名前 | 説明 | 価値 |
---|
UserAssignedIdentities (ユーザー割り当てアイデンティティ)
名前 | 説明 | 価値 |
---|
ユーザー割り当て識別子
名前 | 説明 | 価値 |
---|
使用例
Terraform (AzAPI プロバイダー) リソース定義
sessionPools リソースの種類は、次をターゲットとする操作と共にデプロイできます。
- リソース グループ
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.App/sessionPools リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.App/sessionPools@2024-10-02-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
containerType = "string"
customContainerTemplate = {
containers = [
{
args = [
"string"
]
command = [
"string"
]
env = [
{
name = "string"
secretRef = "string"
value = "string"
}
]
image = "string"
name = "string"
resources = {
cpu = int
memory = "string"
}
}
]
ingress = {
targetPort = int
}
registryCredentials = {
identity = "string"
passwordSecretRef = "string"
server = "string"
username = "string"
}
}
dynamicPoolConfiguration = {
cooldownPeriodInSeconds = int
executionType = "string"
}
environmentId = "string"
managedIdentitySettings = [
{
identity = "string"
lifecycle = "string"
}
]
poolManagementType = "string"
scaleConfiguration = {
maxConcurrentSessions = int
readySessionInstances = int
}
secrets = [
{
name = "string"
value = "string"
}
]
sessionNetworkConfiguration = {
status = "string"
}
}
}
}
プロパティ値
Microsoft.App/sessionPools
名前 | 説明 | 価値 |
---|---|---|
アイデンティティ | コード内のシークレットや資格情報を保持しないように、他の Azure サービスと対話するためにセッション プールで必要なマネージド ID。 | ManagedServiceIdentity の |
ロケーション | リソースが存在する地理的な場所 | string (必須) |
名前 | リソース名 | 糸 制約: 最小長 = 3 最大長 = 63 パターン = ^[a-z][a-z0-9]*$ (必須) |
プロパティ | コンテナー アプリ セッション プールのリソース固有のプロパティ | セッションプールプロパティ |
タグ | リソース タグ | タグ名と値のディクショナリ。 |
種類 | リソースの種類 | 「Microsoft.App/sessionPools@2024-10-02-preview」 |
CustomContainerTemplate
名前 | 説明 | 価値 |
---|---|---|
コンテナー | セッション プールのセッションのコンテナー定義の一覧。 | セッションコンテナ[] |
進入 | セッション プールのイングレス構成。 | セッションイングレス |
レジストリ資格情報 | セッション プールのセッションで使用されるコンテナーのプライベート コンテナー レジストリ資格情報。 | SessionRegistryCredentials |
ダイナミックプール構成
名前 | 説明 | 価値 |
---|---|---|
クールダウン期間(秒) | セッションのクールダウン期間 (秒単位)。 | 整数 (int) |
実行タイプ | セッション プールの実行の種類。 | 「タイミング」 |
EnvironmentVar (環境変数)
名前 | 説明 | 価値 |
---|---|---|
名前 | 環境変数の名前。 | ひも |
secretRef です。 | 環境変数の値をプルするコンテナー アプリ シークレットの名前。 | ひも |
価値 | シークレット以外の環境変数の値。 | ひも |
ManagedIdentitySetting
名前 | 説明 | 価値 |
---|---|---|
アイデンティティ | セッション プールに割り当てられているユーザー割り当てマネージド ID のリソース ID。システム割り当て ID の場合は "system" です。 | string (必須) |
ライフサイクル | マネージド ID を使用できるセッション プールのライフサイクル ステージを選択するために使用します。 | 「すべて」 '初期化' 「メイン」 「なし」 |
マネージドサービスアイデンティティ
名前 | 説明 | 価値 |
---|---|---|
種類 | マネージド サービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。 | 「なし」 'システム割り当て' 'システム割り当て済み、ユーザー割り当て済み' 'UserAssigned' (必須) |
userAssignedIdentities (ユーザー割り当て済みアイデンティティ) | リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリ キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。 ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。 | UserAssignedIdentities の |
スケールコンフィギュレーション
名前 | 説明 | 価値 |
---|---|---|
maxConcurrentSessions (英語) | 同時に行うセッションの最大数。 | 整数 (int) |
readySessionInstances の | 準備完了セッション インスタンスの最小数。 | 整数 (int) |
セッションコンテナ
名前 | 説明 | 価値 |
---|---|---|
引数 | コンテナーの開始コマンド引数。 | 文字列[] |
コマンド | コンテナーの開始コマンド。 | 文字列[] |
環境 | コンテナー環境変数。 | EnvironmentVar[] |
画像 | コンテナー イメージ タグ。 | ひも |
名前 | カスタム コンテナー名。 | ひも |
リソース | コンテナー リソースの要件。 | セッションコンテナリソース |
セッションコンテナリソース
名前 | 説明 | 価値 |
---|---|---|
CPUの | コアで必要な CPU (例: 0.5) | 整数 (int) |
記憶 | 必要なメモリ (例: "250Mb" ) | ひも |
セッションイングレス
名前 | 説明 | 価値 |
---|---|---|
ターゲットポート | イングレスからのトラフィックのコンテナー内のターゲット ポート | 整数 (int) |
セッションネットワーク構成
名前 | 説明 | 価値 |
---|---|---|
ステータス | セッションのネットワーク状態。 | 「EgressDisabled」 「EgressEnabled」 |
セッションプールプロパティ
名前 | 説明 | 価値 |
---|---|---|
コンテナタイプ | セッションのコンテナーの種類。 | 「カスタムコンテナ」 「PythonLTS」 |
カスタムコンテナテンプレート | containerType が CustomContainer の場合のカスタム コンテナー構成。 | CustomContainerTemplate の |
dynamicPoolConfiguration (動的プール構成) | poolManagementType が動的な場合のプール構成。 | ダイナミックプール構成 |
環境ID | セッション プールの環境のリソース ID。 | ひも |
managedIdentitySettings | セッション プールに割り当てられているマネージド ID のオプション設定。 | ManagedIdentity設定[] |
poolManagementType (プールマネジメントタイプ) | セッション プールのプール管理の種類。 | 「ダイナミック」 「マニュアル」 |
スケール設定 | セッション プールのスケール構成。 | スケールコンフィギュレーション |
秘密 | セッション プールのシークレット。 | セッションプールシークレット[] |
セッションネットワーク構成 | セッション プール内のセッションのネットワーク構成。 | セッションネットワーク構成 |
セッションプールシークレット
名前 | 説明 | 価値 |
---|---|---|
名前 | シークレット名。 | ひも |
価値 | シークレット値。 | 糸 制約: 機密性の高い値。 セキュリティで保護されたパラメーターとして渡します。 |
SessionRegistryCredentials
名前 | 説明 | 価値 |
---|---|---|
アイデンティティ | Azure Container Registry での認証に使用するマネージド ID。 ユーザー割り当て ID の場合は、完全なユーザー割り当て ID リソース ID を使用します。 システム割り当て ID の場合は、'system' を使用します | ひも |
passwordSecretRef | レジストリ ログイン パスワードを含むシークレットの名前 | ひも |
サーバー | コンテナー レジストリ サーバー。 | ひも |
ユーザー名 | コンテナー レジストリのユーザー名。 | ひも |
追跡リソースタグ
名前 | 説明 | 価値 |
---|
UserAssignedIdentities (ユーザー割り当てアイデンティティ)
名前 | 説明 | 価値 |
---|
ユーザー割り当て識別子
名前 | 説明 | 価値 |
---|