Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Определение ресурсов Bicep
Тип ресурса sessionPools можно развернуть с помощью операций, предназначенных для следующих операций:
- группы ресурсов . См. команды развертывания группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.App/sessionPools, добавьте следующий Bicep в шаблон.
resource symbolicname 'Microsoft.App/sessionPools@2025-02-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'
probes: [
{
failureThreshold: int
httpGet: {
host: 'string'
httpHeaders: [
{
name: 'string'
value: 'string'
}
]
path: 'string'
port: int
scheme: 'string'
}
initialDelaySeconds: int
periodSeconds: int
successThreshold: int
tcpSocket: {
host: 'string'
port: int
}
terminationGracePeriodSeconds: int
timeoutSeconds: int
type: 'string'
}
]
resources: {
cpu: int
memory: 'string'
}
}
]
ingress: {
targetPort: int
}
registryCredentials: {
identity: 'string'
passwordSecretRef: 'string'
server: 'string'
username: 'string'
}
}
dynamicPoolConfiguration: {
lifecycleConfiguration: {
cooldownPeriodInSeconds: int
lifecycleType: 'string'
maxAlivePeriodInSeconds: int
}
}
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, не поддерживают секреты или учетные данные в коде. | ManagedServiceIdentity (Управляемый сервисИдентификация) |
расположение | Географическое расположение, в котором находится ресурс | строка (обязательно) |
имя | имя ресурса. | струна Ограничения целостности: Минимальная длина = 3 Максимальная длина = 63 Pattern = ^[a-z][a-z0-9]*$ (обязательно) |
свойства | Свойства ресурса пула сеансов контейнеров | SessionPoolProperties (Свойства SessionPool) |
Теги | Теги ресурсов | Словарь имен и значений тегов. См. теги в шаблонах |
CustomContainerTemplate (Пользовательский шаблон)
Имя | Описание | Ценность |
---|---|---|
Контейнеры | Список определений контейнеров для сеансов пула сеансов. | Сессионный контейнер[] |
вход | Конфигурация входящего трафика пула сеансов. | сеансов |
registryУчетные данные | Учетные данные реестра частных контейнеров для контейнеров, используемых сеансами пула сеансов. | SessionRegistryCredentials |
DynamicPoolConfiguration
Имя | Описание | Ценность |
---|---|---|
жизненный циклКонфигурация | Конфигурация жизненного цикла сеанса в динамическом пуле сеансов | Жизненный циклConfiguration |
Окружающая средаVar
Имя | Описание | Ценность |
---|---|---|
имя | Имя переменной среды. | струна |
secretRef | Имя секрета приложения контейнера, из которого требуется извлечь значение переменной среды. | струна |
ценность | Значение переменной среды, отличной от секрета. | струна |
Жизненный циклConfiguration
Имя | Описание | Ценность |
---|---|---|
cooldownPeriodInSeconds | Период охлаждения сеанса в секундах, когда тип жизненного цикла имеет значение Timed. | инт |
lifecycleType | Тип жизненного цикла пула сеансов. | OnContainerExit "Timed" |
maxAlivePeriodInSeconds | Максимальный жизненный период сеанса в секундах, когда тип жизненного цикла — OnContainerExit. | инт |
ManagedIdentitySetting (УправляемыйIdentitySetting)
Имя | Описание | Ценность |
---|---|---|
идентичность | Идентификатор ресурса управляемого удостоверения, назначаемого пользователем, который назначается пулу сеансов или системе для назначаемого системой удостоверения. | строка (обязательно) |
жизненный цикл | Используется для выбора этапов жизненного цикла пула сеансов, в течение которого должно быть доступно управляемое удостоверение. | "Все" Init "Main" "Нет" |
Управляемая служебная идентичность
Имя | Описание | Ценность |
---|---|---|
тип | Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). | "Нет" SystemAssigned SystemAssigned, UserAssigned UserAssigned (обязательно) |
ИдентичностиНазначенныеПользователем | Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. | UserAssignedIdentity (Пользовательские идентификаторы) |
Масштабная конфигурация
Имя | Описание | Ценность |
---|---|---|
maxConcurrentSessions | Максимальное количество сеансов одновременно. | инт |
readySessionInstances | Минимальное количество готовых экземпляров сеанса. | инт |
SessionContainer (Контейнер сеансов)
Имя | Описание | Ценность |
---|---|---|
Аргументы | Аргументы команд запуска контейнера. | строка[] |
Приказ | Команда запуска контейнера. | строка[] |
окружение | Переменные среды контейнера. | Переменная окружающей среды[] |
образ | Тег образа контейнера. | струна |
имя | Имя настраиваемого контейнера. | струна |
Зонды | Список проб для контейнера. | Сессионный зонд[] |
ресурсы | Требования к ресурсам контейнера. | SessionContainerResources (Ресурсы контейнера) |
SessionContainerResources (Ресурсы контейнера)
Имя | Описание | Ценность |
---|---|---|
ЦПУ | Обязательный ЦП в ядрах, например 0,5 | инт |
память | Требуемая память, например "250 Мб" | струна |
Входящий сеанс
Имя | Описание | Ценность |
---|---|---|
targetPort | Целевой порт в контейнерах для трафика из входящего трафика | инт |
Конфигурация SessionNetworkConfiguration
Имя | Описание | Ценность |
---|---|---|
статус | Состояние сети для сеансов. | EgressDisabled EgressEnabled |
SessionPoolProperties (Свойства SessionPool)
Имя | Описание | Ценность |
---|---|---|
Тип контейнера | Тип контейнера сеансов. | CustomContainer PythonLTS |
customContainerTemplate | Настраиваемая конфигурация контейнера, если контейнерType — CustomContainer. | CustomContainerTemplate (Пользовательский шаблон) |
dynamicPoolConfiguration | Конфигурация пула, если poolManagementType является динамическим. | DynamicPoolConfiguration |
environmentId | Идентификатор ресурса среды пула сеансов. | струна |
managedIdentitySettings | Необязательные параметры управляемого удостоверения, назначенного пулу сеансов. | ManagedIdentitySetting[] |
poolManagementType | Тип управления пулом пула сеансов. | Dynamic "Вручную" |
scaleConfiguration | Конфигурация масштабируемого пула сеансов. | scaleConfiguration |
Секреты | Секреты пула сеансов. | Секрет SessionPool[] |
sessionNetworkConfiguration | Сетевая конфигурация сеансов в пуле сеансов. | Конфигурация SessionNetworkConfiguration |
Секрет SessionPoolSecret
Имя | Описание | Ценность |
---|---|---|
имя | Имя секрета. | струна |
ценность | Значение секрета. | струна Ограничения целостности: Конфиденциальное значение. Передайте в качестве безопасного параметра. |
Сессионный зонд
Имя | Описание | Ценность |
---|---|---|
Порог неудачи | Минимальные последовательные сбои для проверки, которые будут считаться неудачными после успешного выполнения. Значение по умолчанию — 3. Минимальное значение равно 1. Максимальное значение равно 10. | инт |
httpGet | HTTPGet указывает http-запрос для выполнения. | SessionProbeHttpGet |
initialDelaySeconds | Количество секунд после запуска контейнера до запуска проб активности. Минимальное значение равно 1. Максимальное значение равно 60. | инт |
период в секундах | Как часто (в секундах) выполнять пробу. По умолчанию — 10 секунд. Минимальное значение равно 1. Максимальное значение — 240. | инт |
Порог успеха | Минимальные последовательные успехи для пробы, которые будут считаться успешными после сбоя. Значение по умолчанию — 1. Должно быть 1 для жизни и запуска. Минимальное значение равно 1. Максимальное значение равно 10. | инт |
tcpSocket | TCPSocket указывает действие, связанное с TCP-портом. Перехватчики TCP еще не поддерживаются. | SessionProbeTcpSocket |
terminationGracePeriodSeconds | Необязательная длительность в секундах модуль pod должен завершиться корректно при сбое пробы. Льготный период — это длительность в секундах после того, как процессы, выполняемые в модуле pod, отправляются сигнал завершения и время принудительного прекращения процессов с помощью сигнала об убийстве. Установите это значение больше, чем ожидаемое время очистки для вашего процесса. Если это значение равно nil, будет использоваться завершение модуля podGracePeriodSeconds. В противном случае это значение переопределяет значение, предоставленное спецификацией pod. Значение должно быть неотрицательно целым числом. Нулевое значение указывает, что немедленно останавливается через сигнал убийства (нет возможности завершить работу). Это альфа-поле и требует включения шлюза функций ProbeTerminationGracePeriod. Максимальное значение — 3600 секунд (1 час) | инт |
timeoutSeconds | Количество секунд, после которого время ожидания пробы истекает. По умолчанию используется значение 1 секунды. Минимальное значение равно 1. Максимальное значение — 240. | инт |
тип | Обозначает тип пробника. Может быть Liveness или Startup, проба готовности не поддерживается в сеансах. Тип должен быть уникальным для каждой пробы в контексте списка проб (SessionProbes). | "Liveness" "Startup" |
SessionProbeHttpGet
Имя | Описание | Ценность |
---|---|---|
хост | Имя узла для подключения по умолчанию к IP-адресу pod. Возможно, вы хотите задать "Host" в httpHeaders. | струна |
HTTP-заголовки | Пользовательские заголовки, заданные в запросе. HTTP позволяет повторять заголовки. | SessionProbeHttpGetHttpHeadersItem[] |
путь | Путь к доступу на HTTP-сервере. | струна |
порт | Имя или номер порта для доступа к контейнеру. Число должно находиться в диапазоне от 1 до 65535. Имя должно быть IANA_SVC_NAME. | int (обязательно) |
схема | Схема, используемая для подключения к узлу. По умолчанию используется протокол HTTP. | "HTTP" "HTTPS" |
SessionProbeHttpGetHttpHeadersItem
Имя | Описание | Ценность |
---|---|---|
имя | Имя поля заголовка | строка (обязательно) |
ценность | Значение поля заголовка | строка (обязательно) |
SessionProbeTcpSocket
Имя | Описание | Ценность |
---|---|---|
хост | Необязательно. Имя узла для подключения по умолчанию используется для IP-адреса pod. | струна |
порт | Номер или имя порта для доступа к контейнеру. Число должно находиться в диапазоне от 1 до 65535. Имя должно быть IANA_SVC_NAME. | int (обязательно) |
SessionRegistryCredentials
Имя | Описание | Ценность |
---|---|---|
идентичность | Управляемое удостоверение, используемое для проверки подлинности в реестре контейнеров Azure. Для удостоверений, назначенных пользователем, используйте полный идентификатор ресурса удостоверения, назначаемого пользователем. Для удостоверений, назначенных системой, используйте system | струна |
passwordSecretRef | Имя секрета, содержащего пароль для входа в реестр | струна |
сервер | Сервер реестра контейнеров. | струна |
имя пользователя | Имя пользователя реестра контейнеров. | струна |
Отслеживаемые Ресурсные Теги
Имя | Описание | Ценность |
---|
UserAssignedIdentity (Пользовательские идентификаторы)
Имя | Описание | Ценность |
---|
Пользовательская назначенная идентичность
Имя | Описание | Ценность |
---|
Примеры использования
Проверенные модули Azure
Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.
Модуль | Описание |
---|---|
Пул сеансов приложений | Модуль ресурсов AVM для пула сеансов приложений |
Определение ресурса шаблона ARM
Тип ресурса sessionPools можно развернуть с помощью операций, предназначенных для следующих операций:
- группы ресурсов . См. команды развертывания группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.App/sessionPools, добавьте следующий код JSON в шаблон.
{
"type": "Microsoft.App/sessionPools",
"apiVersion": "2025-02-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",
"probes": [
{
"failureThreshold": "int",
"httpGet": {
"host": "string",
"httpHeaders": [
{
"name": "string",
"value": "string"
}
],
"path": "string",
"port": "int",
"scheme": "string"
},
"initialDelaySeconds": "int",
"periodSeconds": "int",
"successThreshold": "int",
"tcpSocket": {
"host": "string",
"port": "int"
},
"terminationGracePeriodSeconds": "int",
"timeoutSeconds": "int",
"type": "string"
}
],
"resources": {
"cpu": "int",
"memory": "string"
}
}
],
"ingress": {
"targetPort": "int"
},
"registryCredentials": {
"identity": "string",
"passwordSecretRef": "string",
"server": "string",
"username": "string"
}
},
"dynamicPoolConfiguration": {
"lifecycleConfiguration": {
"cooldownPeriodInSeconds": "int",
"lifecycleType": "string",
"maxAlivePeriodInSeconds": "int"
}
},
"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 | «2025-02-02-превью» |
идентичность | Управляемые удостоверения, необходимые пулу сеансов для взаимодействия с другими службами Azure, не поддерживают секреты или учетные данные в коде. | ManagedServiceIdentity (Управляемый сервисИдентификация) |
расположение | Географическое расположение, в котором находится ресурс | строка (обязательно) |
имя | имя ресурса. | струна Ограничения целостности: Минимальная длина = 3 Максимальная длина = 63 Pattern = ^[a-z][a-z0-9]*$ (обязательно) |
свойства | Свойства ресурса пула сеансов контейнеров | SessionPoolProperties (Свойства SessionPool) |
Теги | Теги ресурсов | Словарь имен и значений тегов. См. теги в шаблонах |
тип | Тип ресурса | "Microsoft.App/sessionPools" |
CustomContainerTemplate (Пользовательский шаблон)
Имя | Описание | Ценность |
---|---|---|
Контейнеры | Список определений контейнеров для сеансов пула сеансов. | Сессионный контейнер[] |
вход | Конфигурация входящего трафика пула сеансов. | сеансов |
registryУчетные данные | Учетные данные реестра частных контейнеров для контейнеров, используемых сеансами пула сеансов. | SessionRegistryCredentials |
DynamicPoolConfiguration
Имя | Описание | Ценность |
---|---|---|
жизненный циклКонфигурация | Конфигурация жизненного цикла сеанса в динамическом пуле сеансов | Жизненный циклConfiguration |
Окружающая средаVar
Имя | Описание | Ценность |
---|---|---|
имя | Имя переменной среды. | струна |
secretRef | Имя секрета приложения контейнера, из которого требуется извлечь значение переменной среды. | струна |
ценность | Значение переменной среды, отличной от секрета. | струна |
Жизненный циклConfiguration
Имя | Описание | Ценность |
---|---|---|
cooldownPeriodInSeconds | Период охлаждения сеанса в секундах, когда тип жизненного цикла имеет значение Timed. | инт |
lifecycleType | Тип жизненного цикла пула сеансов. | OnContainerExit "Timed" |
maxAlivePeriodInSeconds | Максимальный жизненный период сеанса в секундах, когда тип жизненного цикла — OnContainerExit. | инт |
ManagedIdentitySetting (УправляемыйIdentitySetting)
Имя | Описание | Ценность |
---|---|---|
идентичность | Идентификатор ресурса управляемого удостоверения, назначаемого пользователем, который назначается пулу сеансов или системе для назначаемого системой удостоверения. | строка (обязательно) |
жизненный цикл | Используется для выбора этапов жизненного цикла пула сеансов, в течение которого должно быть доступно управляемое удостоверение. | "Все" Init "Main" "Нет" |
Управляемая служебная идентичность
Имя | Описание | Ценность |
---|---|---|
тип | Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). | "Нет" SystemAssigned SystemAssigned, UserAssigned UserAssigned (обязательно) |
ИдентичностиНазначенныеПользователем | Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. | UserAssignedIdentity (Пользовательские идентификаторы) |
Масштабная конфигурация
Имя | Описание | Ценность |
---|---|---|
maxConcurrentSessions | Максимальное количество сеансов одновременно. | инт |
readySessionInstances | Минимальное количество готовых экземпляров сеанса. | инт |
SessionContainer (Контейнер сеансов)
Имя | Описание | Ценность |
---|---|---|
Аргументы | Аргументы команд запуска контейнера. | строка[] |
Приказ | Команда запуска контейнера. | строка[] |
окружение | Переменные среды контейнера. | Переменная окружающей среды[] |
образ | Тег образа контейнера. | струна |
имя | Имя настраиваемого контейнера. | струна |
Зонды | Список проб для контейнера. | Сессионный зонд[] |
ресурсы | Требования к ресурсам контейнера. | SessionContainerResources (Ресурсы контейнера) |
SessionContainerResources (Ресурсы контейнера)
Имя | Описание | Ценность |
---|---|---|
ЦПУ | Обязательный ЦП в ядрах, например 0,5 | инт |
память | Требуемая память, например "250 Мб" | струна |
Входящий сеанс
Имя | Описание | Ценность |
---|---|---|
targetPort | Целевой порт в контейнерах для трафика из входящего трафика | инт |
Конфигурация SessionNetworkConfiguration
Имя | Описание | Ценность |
---|---|---|
статус | Состояние сети для сеансов. | EgressDisabled EgressEnabled |
SessionPoolProperties (Свойства SessionPool)
Имя | Описание | Ценность |
---|---|---|
Тип контейнера | Тип контейнера сеансов. | CustomContainer PythonLTS |
customContainerTemplate | Настраиваемая конфигурация контейнера, если контейнерType — CustomContainer. | CustomContainerTemplate (Пользовательский шаблон) |
dynamicPoolConfiguration | Конфигурация пула, если poolManagementType является динамическим. | DynamicPoolConfiguration |
environmentId | Идентификатор ресурса среды пула сеансов. | струна |
managedIdentitySettings | Необязательные параметры управляемого удостоверения, назначенного пулу сеансов. | ManagedIdentitySetting[] |
poolManagementType | Тип управления пулом пула сеансов. | Dynamic "Вручную" |
scaleConfiguration | Конфигурация масштабируемого пула сеансов. | scaleConfiguration |
Секреты | Секреты пула сеансов. | Секрет SessionPool[] |
sessionNetworkConfiguration | Сетевая конфигурация сеансов в пуле сеансов. | Конфигурация SessionNetworkConfiguration |
Секрет SessionPoolSecret
Имя | Описание | Ценность |
---|---|---|
имя | Имя секрета. | струна |
ценность | Значение секрета. | струна Ограничения целостности: Конфиденциальное значение. Передайте в качестве безопасного параметра. |
Сессионный зонд
Имя | Описание | Ценность |
---|---|---|
Порог неудачи | Минимальные последовательные сбои для проверки, которые будут считаться неудачными после успешного выполнения. Значение по умолчанию — 3. Минимальное значение равно 1. Максимальное значение равно 10. | инт |
httpGet | HTTPGet указывает http-запрос для выполнения. | SessionProbeHttpGet |
initialDelaySeconds | Количество секунд после запуска контейнера до запуска проб активности. Минимальное значение равно 1. Максимальное значение равно 60. | инт |
период в секундах | Как часто (в секундах) выполнять пробу. По умолчанию — 10 секунд. Минимальное значение равно 1. Максимальное значение — 240. | инт |
Порог успеха | Минимальные последовательные успехи для пробы, которые будут считаться успешными после сбоя. Значение по умолчанию — 1. Должно быть 1 для жизни и запуска. Минимальное значение равно 1. Максимальное значение равно 10. | инт |
tcpSocket | TCPSocket указывает действие, связанное с TCP-портом. Перехватчики TCP еще не поддерживаются. | SessionProbeTcpSocket |
terminationGracePeriodSeconds | Необязательная длительность в секундах модуль pod должен завершиться корректно при сбое пробы. Льготный период — это длительность в секундах после того, как процессы, выполняемые в модуле pod, отправляются сигнал завершения и время принудительного прекращения процессов с помощью сигнала об убийстве. Установите это значение больше, чем ожидаемое время очистки для вашего процесса. Если это значение равно nil, будет использоваться завершение модуля podGracePeriodSeconds. В противном случае это значение переопределяет значение, предоставленное спецификацией pod. Значение должно быть неотрицательно целым числом. Нулевое значение указывает, что немедленно останавливается через сигнал убийства (нет возможности завершить работу). Это альфа-поле и требует включения шлюза функций ProbeTerminationGracePeriod. Максимальное значение — 3600 секунд (1 час) | инт |
timeoutSeconds | Количество секунд, после которого время ожидания пробы истекает. По умолчанию используется значение 1 секунды. Минимальное значение равно 1. Максимальное значение — 240. | инт |
тип | Обозначает тип пробника. Может быть Liveness или Startup, проба готовности не поддерживается в сеансах. Тип должен быть уникальным для каждой пробы в контексте списка проб (SessionProbes). | "Liveness" "Startup" |
SessionProbeHttpGet
Имя | Описание | Ценность |
---|---|---|
хост | Имя узла для подключения по умолчанию к IP-адресу pod. Возможно, вы хотите задать "Host" в httpHeaders. | струна |
HTTP-заголовки | Пользовательские заголовки, заданные в запросе. HTTP позволяет повторять заголовки. | SessionProbeHttpGetHttpHeadersItem[] |
путь | Путь к доступу на HTTP-сервере. | струна |
порт | Имя или номер порта для доступа к контейнеру. Число должно находиться в диапазоне от 1 до 65535. Имя должно быть IANA_SVC_NAME. | int (обязательно) |
схема | Схема, используемая для подключения к узлу. По умолчанию используется протокол HTTP. | "HTTP" "HTTPS" |
SessionProbeHttpGetHttpHeadersItem
Имя | Описание | Ценность |
---|---|---|
имя | Имя поля заголовка | строка (обязательно) |
ценность | Значение поля заголовка | строка (обязательно) |
SessionProbeTcpSocket
Имя | Описание | Ценность |
---|---|---|
хост | Необязательно. Имя узла для подключения по умолчанию используется для IP-адреса pod. | струна |
порт | Номер или имя порта для доступа к контейнеру. Число должно находиться в диапазоне от 1 до 65535. Имя должно быть IANA_SVC_NAME. | int (обязательно) |
SessionRegistryCredentials
Имя | Описание | Ценность |
---|---|---|
идентичность | Управляемое удостоверение, используемое для проверки подлинности в реестре контейнеров Azure. Для удостоверений, назначенных пользователем, используйте полный идентификатор ресурса удостоверения, назначаемого пользователем. Для удостоверений, назначенных системой, используйте system | струна |
passwordSecretRef | Имя секрета, содержащего пароль для входа в реестр | струна |
сервер | Сервер реестра контейнеров. | струна |
имя пользователя | Имя пользователя реестра контейнеров. | струна |
Отслеживаемые Ресурсные Теги
Имя | Описание | Ценность |
---|
UserAssignedIdentity (Пользовательские идентификаторы)
Имя | Описание | Ценность |
---|
Пользовательская назначенная идентичность
Имя | Описание | Ценность |
---|
Примеры использования
Определение ресурса Terraform (поставщик AzAPI)
Тип ресурса sessionPools можно развернуть с помощью операций, предназначенных для следующих операций:
- Группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.App/sessionPools, добавьте следующий объект Terraform в шаблон.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.App/sessionPools@2025-02-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"
probes = [
{
failureThreshold = int
httpGet = {
host = "string"
httpHeaders = [
{
name = "string"
value = "string"
}
]
path = "string"
port = int
scheme = "string"
}
initialDelaySeconds = int
periodSeconds = int
successThreshold = int
tcpSocket = {
host = "string"
port = int
}
terminationGracePeriodSeconds = int
timeoutSeconds = int
type = "string"
}
]
resources = {
cpu = int
memory = "string"
}
}
]
ingress = {
targetPort = int
}
registryCredentials = {
identity = "string"
passwordSecretRef = "string"
server = "string"
username = "string"
}
}
dynamicPoolConfiguration = {
lifecycleConfiguration = {
cooldownPeriodInSeconds = int
lifecycleType = "string"
maxAlivePeriodInSeconds = int
}
}
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, не поддерживают секреты или учетные данные в коде. | ManagedServiceIdentity (Управляемый сервисИдентификация) |
расположение | Географическое расположение, в котором находится ресурс | строка (обязательно) |
имя | имя ресурса. | струна Ограничения целостности: Минимальная длина = 3 Максимальная длина = 63 Pattern = ^[a-z][a-z0-9]*$ (обязательно) |
свойства | Свойства ресурса пула сеансов контейнеров | SessionPoolProperties (Свойства SessionPool) |
Теги | Теги ресурсов | Словарь имен и значений тегов. |
тип | Тип ресурса | "Microsoft.App/sessionPools@2025-02-02-preview" |
CustomContainerTemplate (Пользовательский шаблон)
Имя | Описание | Ценность |
---|---|---|
Контейнеры | Список определений контейнеров для сеансов пула сеансов. | Сессионный контейнер[] |
вход | Конфигурация входящего трафика пула сеансов. | сеансов |
registryУчетные данные | Учетные данные реестра частных контейнеров для контейнеров, используемых сеансами пула сеансов. | SessionRegistryCredentials |
DynamicPoolConfiguration
Имя | Описание | Ценность |
---|---|---|
жизненный циклКонфигурация | Конфигурация жизненного цикла сеанса в динамическом пуле сеансов | Жизненный циклConfiguration |
Окружающая средаVar
Имя | Описание | Ценность |
---|---|---|
имя | Имя переменной среды. | струна |
secretRef | Имя секрета приложения контейнера, из которого требуется извлечь значение переменной среды. | струна |
ценность | Значение переменной среды, отличной от секрета. | струна |
Жизненный циклConfiguration
Имя | Описание | Ценность |
---|---|---|
cooldownPeriodInSeconds | Период охлаждения сеанса в секундах, когда тип жизненного цикла имеет значение Timed. | инт |
lifecycleType | Тип жизненного цикла пула сеансов. | OnContainerExit "Timed" |
maxAlivePeriodInSeconds | Максимальный жизненный период сеанса в секундах, когда тип жизненного цикла — OnContainerExit. | инт |
ManagedIdentitySetting (УправляемыйIdentitySetting)
Имя | Описание | Ценность |
---|---|---|
идентичность | Идентификатор ресурса управляемого удостоверения, назначаемого пользователем, который назначается пулу сеансов или системе для назначаемого системой удостоверения. | строка (обязательно) |
жизненный цикл | Используется для выбора этапов жизненного цикла пула сеансов, в течение которого должно быть доступно управляемое удостоверение. | "Все" Init "Main" "Нет" |
Управляемая служебная идентичность
Имя | Описание | Ценность |
---|---|---|
тип | Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). | "Нет" SystemAssigned SystemAssigned, UserAssigned UserAssigned (обязательно) |
ИдентичностиНазначенныеПользователем | Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. | UserAssignedIdentity (Пользовательские идентификаторы) |
Масштабная конфигурация
Имя | Описание | Ценность |
---|---|---|
maxConcurrentSessions | Максимальное количество сеансов одновременно. | инт |
readySessionInstances | Минимальное количество готовых экземпляров сеанса. | инт |
SessionContainer (Контейнер сеансов)
Имя | Описание | Ценность |
---|---|---|
Аргументы | Аргументы команд запуска контейнера. | строка[] |
Приказ | Команда запуска контейнера. | строка[] |
окружение | Переменные среды контейнера. | Переменная окружающей среды[] |
образ | Тег образа контейнера. | струна |
имя | Имя настраиваемого контейнера. | струна |
Зонды | Список проб для контейнера. | Сессионный зонд[] |
ресурсы | Требования к ресурсам контейнера. | SessionContainerResources (Ресурсы контейнера) |
SessionContainerResources (Ресурсы контейнера)
Имя | Описание | Ценность |
---|---|---|
ЦПУ | Обязательный ЦП в ядрах, например 0,5 | инт |
память | Требуемая память, например "250 Мб" | струна |
Входящий сеанс
Имя | Описание | Ценность |
---|---|---|
targetPort | Целевой порт в контейнерах для трафика из входящего трафика | инт |
Конфигурация SessionNetworkConfiguration
Имя | Описание | Ценность |
---|---|---|
статус | Состояние сети для сеансов. | EgressDisabled EgressEnabled |
SessionPoolProperties (Свойства SessionPool)
Имя | Описание | Ценность |
---|---|---|
Тип контейнера | Тип контейнера сеансов. | CustomContainer PythonLTS |
customContainerTemplate | Настраиваемая конфигурация контейнера, если контейнерType — CustomContainer. | CustomContainerTemplate (Пользовательский шаблон) |
dynamicPoolConfiguration | Конфигурация пула, если poolManagementType является динамическим. | DynamicPoolConfiguration |
environmentId | Идентификатор ресурса среды пула сеансов. | струна |
managedIdentitySettings | Необязательные параметры управляемого удостоверения, назначенного пулу сеансов. | ManagedIdentitySetting[] |
poolManagementType | Тип управления пулом пула сеансов. | Dynamic "Вручную" |
scaleConfiguration | Конфигурация масштабируемого пула сеансов. | scaleConfiguration |
Секреты | Секреты пула сеансов. | Секрет SessionPool[] |
sessionNetworkConfiguration | Сетевая конфигурация сеансов в пуле сеансов. | Конфигурация SessionNetworkConfiguration |
Секрет SessionPoolSecret
Имя | Описание | Ценность |
---|---|---|
имя | Имя секрета. | струна |
ценность | Значение секрета. | струна Ограничения целостности: Конфиденциальное значение. Передайте в качестве безопасного параметра. |
Сессионный зонд
Имя | Описание | Ценность |
---|---|---|
Порог неудачи | Минимальные последовательные сбои для проверки, которые будут считаться неудачными после успешного выполнения. Значение по умолчанию — 3. Минимальное значение равно 1. Максимальное значение равно 10. | инт |
httpGet | HTTPGet указывает http-запрос для выполнения. | SessionProbeHttpGet |
initialDelaySeconds | Количество секунд после запуска контейнера до запуска проб активности. Минимальное значение равно 1. Максимальное значение равно 60. | инт |
период в секундах | Как часто (в секундах) выполнять пробу. По умолчанию — 10 секунд. Минимальное значение равно 1. Максимальное значение — 240. | инт |
Порог успеха | Минимальные последовательные успехи для пробы, которые будут считаться успешными после сбоя. Значение по умолчанию — 1. Должно быть 1 для жизни и запуска. Минимальное значение равно 1. Максимальное значение равно 10. | инт |
tcpSocket | TCPSocket указывает действие, связанное с TCP-портом. Перехватчики TCP еще не поддерживаются. | SessionProbeTcpSocket |
terminationGracePeriodSeconds | Необязательная длительность в секундах модуль pod должен завершиться корректно при сбое пробы. Льготный период — это длительность в секундах после того, как процессы, выполняемые в модуле pod, отправляются сигнал завершения и время принудительного прекращения процессов с помощью сигнала об убийстве. Установите это значение больше, чем ожидаемое время очистки для вашего процесса. Если это значение равно nil, будет использоваться завершение модуля podGracePeriodSeconds. В противном случае это значение переопределяет значение, предоставленное спецификацией pod. Значение должно быть неотрицательно целым числом. Нулевое значение указывает, что немедленно останавливается через сигнал убийства (нет возможности завершить работу). Это альфа-поле и требует включения шлюза функций ProbeTerminationGracePeriod. Максимальное значение — 3600 секунд (1 час) | инт |
timeoutSeconds | Количество секунд, после которого время ожидания пробы истекает. По умолчанию используется значение 1 секунды. Минимальное значение равно 1. Максимальное значение — 240. | инт |
тип | Обозначает тип пробника. Может быть Liveness или Startup, проба готовности не поддерживается в сеансах. Тип должен быть уникальным для каждой пробы в контексте списка проб (SessionProbes). | "Liveness" "Startup" |
SessionProbeHttpGet
Имя | Описание | Ценность |
---|---|---|
хост | Имя узла для подключения по умолчанию к IP-адресу pod. Возможно, вы хотите задать "Host" в httpHeaders. | струна |
HTTP-заголовки | Пользовательские заголовки, заданные в запросе. HTTP позволяет повторять заголовки. | SessionProbeHttpGetHttpHeadersItem[] |
путь | Путь к доступу на HTTP-сервере. | струна |
порт | Имя или номер порта для доступа к контейнеру. Число должно находиться в диапазоне от 1 до 65535. Имя должно быть IANA_SVC_NAME. | int (обязательно) |
схема | Схема, используемая для подключения к узлу. По умолчанию используется протокол HTTP. | "HTTP" "HTTPS" |
SessionProbeHttpGetHttpHeadersItem
Имя | Описание | Ценность |
---|---|---|
имя | Имя поля заголовка | строка (обязательно) |
ценность | Значение поля заголовка | строка (обязательно) |
SessionProbeTcpSocket
Имя | Описание | Ценность |
---|---|---|
хост | Необязательно. Имя узла для подключения по умолчанию используется для IP-адреса pod. | струна |
порт | Номер или имя порта для доступа к контейнеру. Число должно находиться в диапазоне от 1 до 65535. Имя должно быть IANA_SVC_NAME. | int (обязательно) |
SessionRegistryCredentials
Имя | Описание | Ценность |
---|---|---|
идентичность | Управляемое удостоверение, используемое для проверки подлинности в реестре контейнеров Azure. Для удостоверений, назначенных пользователем, используйте полный идентификатор ресурса удостоверения, назначаемого пользователем. Для удостоверений, назначенных системой, используйте system | струна |
passwordSecretRef | Имя секрета, содержащего пароль для входа в реестр | струна |
сервер | Сервер реестра контейнеров. | струна |
имя пользователя | Имя пользователя реестра контейнеров. | струна |
Отслеживаемые Ресурсные Теги
Имя | Описание | Ценность |
---|
UserAssignedIdentity (Пользовательские идентификаторы)
Имя | Описание | Ценность |
---|
Пользовательская назначенная идентичность
Имя | Описание | Ценность |
---|