az containerapp sessionpool

Note

Эта ссылка является частью расширения containerapp для Azure CLI (версия 2.79.0 или более поздней). Расширение автоматически установит команду az containerapp sessionpool при первом запуске. Подробнее о расширениях.

Команды для управления пулами сеансов.

Команды

Имя Описание Тип Состояние
az containerapp sessionpool create

Создание или обновление пула сеансов.

Extension GA
az containerapp sessionpool delete

Удаление пула сеансов.

Extension GA
az containerapp sessionpool list

Вывод списка пулов сеансов по подписке или группе ресурсов.

Extension GA
az containerapp sessionpool show

Отображение сведений о пуле сеансов.

Extension GA
az containerapp sessionpool update

Обновление пула сеансов.

Extension GA

az containerapp sessionpool create

Создание или обновление пула сеансов.

az containerapp sessionpool create --name
                                   --resource-group
                                   [--acquire-policy-token]
                                   [--args]
                                   [--change-reference]
                                   [--command]
                                   [--container-name]
                                   [--container-type {CustomContainer, NodeLTS, PythonLTS, Shell}]
                                   [--cooldown-period]
                                   [--cpu]
                                   [--env-vars]
                                   [--environment]
                                   [--image]
                                   [--lifecycle-type {OnContainerExit, Timed}]
                                   [--location]
                                   [--max-alive-period]
                                   [--max-sessions]
                                   [--memory]
                                   [--mi-system-assigned]
                                   [--mi-user-assigned]
                                   [--network-status {EgressDisabled, EgressEnabled}]
                                   [--no-wait]
                                   [--probe-yaml]
                                   [--ready-sessions]
                                   [--registry-identity]
                                   [--registry-password]
                                   [--registry-server]
                                   [--registry-username]
                                   [--secrets]
                                   [--target-port]

Примеры

Создайте или обновите пул сеансов с параметрами типа PythonLTS по умолчанию.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --location eastasia

Создайте или обновите пул сеансов с параметрами оболочки контейнера по умолчанию.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type Shell --location westus3

Создайте или обновите пул сеансов с типом PythonLTS типа контейнера, при этом максимальное число одновременных сеансов равно 30, готовых экземпляров сеансов 20.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type PythonLTS --max-sessions 30 --ready-sessions 20 \
    --location eastasia

Создайте или обновите пул сеансов с типом контейнера CustomContainer с помощью образа быстрого запуска по умолчанию.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment \
    --cpu 0.5 --memory 1Gi --target-port 80 --location eastasia --image mcr.microsoft.com/k8se/quickstart:latest

Создайте или обновите пул сеансов с типом контейнера CustomContainer с секретами и переменными среды.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment \
    --cpu 0.5 --memory 1Gi --target-port 80 --image MyImage \
    --env-vars GREETING="Hello, world" SECRETENV=secretref:anothersecret \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" --location eastasia

Создание или обновление пула сеансов с типом контейнера CustomContainer, который из частного реестра

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment --image MyImage \
    --cpu 0.5 --memory 1Gi --target-port 80 --registry-server myregistry.azurecr.io \
    --registry-username myregistry --registry-password $REGISTRY_PASSWORD \
    --location eastasia

Создание или обновление пула сеансов с типом контейнера CustomContainer и управляемым удостоверением для проверки подлинности реестра контейнеров Azure

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment --image MyImage \
    --cpu 0.5 --memory 1Gi --target-port 80 --registry-server myregistry.azurecr.io \
    --registry-identity  MyUserIdentityResourceId \
    --location eastasia

Создайте или обновите пул сеансов с типом контейнера CustomContainer с назначенным системой удостоверением и удостоверением, назначенным пользователем.

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --container-type CustomContainer --environment MyEnvironment --image MyImage \
    --cpu 0.5 --memory 1Gi --target-port 80 \
    --mi-system-assigned --mi-user-assigned MyUserIdentityResourceId \
    --location eastasia

Создание или обновление пула сеансов с типом контейнера CustomContainer с периодом охлаждения 360s

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --environment MyEnvironment --cpu 0.5 --memory 1Gi --target-port 80 --container-type CustomContainer \
    --cooldown-period 360 --location eastasia

Создание или обновление пула сеансов с типом контейнера CustomContainer с помощью проб контейнеров

az containerapp sessionpool create -n mysessionpool -g MyResourceGroup \
    --environment MyEnvironment --cpu 0.5 --memory 1Gi --target-port 80 --container-type CustomContainer \
    --probe-yaml config.yaml --location eastasia

Обязательные параметры

--name -n

Имя пула сеансов.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--args

Список аргументов команд запуска контейнера. Разделенные пробелами значения, например "-c" "mycommand". Пустая строка для очистки существующих значений.

Свойство Значение
Группа параметров: Container Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--command

Список поддерживаемых команд в контейнере, который будет выполняться во время запуска. Разделенные пробелами значения, например "/bin/queue" "mycommand". Пустая строка для очистки существующих значений.

Свойство Значение
Группа параметров: Container Arguments
--container-name

Имя контейнера. При создании, если имя контейнера не указано, имя контейнера по умолчанию будет использоваться для имени пула сеансов, охватываемого в нижнем регистре.

Свойство Значение
Группа параметров: Container Arguments
--container-type

Тип пула сеансов по умолчанию="PythonLTS".

Свойство Значение
Группа параметров: Configuration Arguments
Допустимые значения: CustomContainer, NodeLTS, PythonLTS, Shell
--cooldown-period

Период (в секундах), после которого сеанс будет удален, это применимо только для типа жизненного цикла "Timed", default=300.

Свойство Значение
Группа параметров: Configuration Arguments
--cpu

Обязательный ЦП в ядрах от 0,25 до 2.0, например 0,5.

Свойство Значение
Группа параметров: Container Arguments
--env-vars

Список переменных среды для контейнера. Разделенные пробелами значения в формате key=value. Пустая строка для очистки существующих значений. Значение префикса с параметром Secretref:, чтобы ссылаться на секрет.

Свойство Значение
Группа параметров: Container Arguments
--environment

Имя или идентификатор ресурса среды приложения контейнера.

Свойство Значение
Группа параметров: Container Arguments
--image -i

Образ контейнера, например publisher/image-name:tag.

Свойство Значение
Группа параметров: Container Arguments
--lifecycle-type

Тип жизненного цикла пула сеансов.

Свойство Значение
Группа параметров: Configuration Arguments
Default value: Timed
Допустимые значения: OnContainerExit, Timed
--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--max-alive-period

Период (в секундах) перед удалением сеанса, если его контейнер не был завершен ранее, это применимо только для типа жизненного цикла OnContainerExit, default=3600.

Свойство Значение
Группа параметров: Configuration Arguments
--max-sessions

Максимальное количество сеансов можно выполнять одновременно.

Свойство Значение
Группа параметров: Scale Arguments
--memory

Требуемая память от 0.5 до 4.0, заканчивающаяся "Gi", например 1.0Gi.

Свойство Значение
Группа параметров: Container Arguments
--mi-system-assigned

Логическое значение, указывающее, следует ли назначать назначаемое системой удостоверение.

Свойство Значение
Default value: False
--mi-user-assigned

Идентификаторы пользователей, разделенные пробелами, должны быть назначены.

--network-status

Исходящий трафик включен для сеансов или нет.

Свойство Значение
Группа параметров: Configuration Arguments
Допустимые значения: EgressDisabled, EgressEnabled
--no-wait

Не ожидать завершения длительной операции.

Свойство Значение
Default value: False
--probe-yaml
Предварительный просмотр

Путь к YAML-файлу с конфигурацией проб контейнеров. Применимо только для настраиваемого пула сеансов контейнеров.

Свойство Значение
Группа параметров: Container Arguments
--ready-sessions

Количество сеансов, которые будут готовы в пуле сеансов все время.

Свойство Значение
Группа параметров: Scale Arguments
--registry-identity

Управляемое удостоверение, с помощью которого выполняется проверка подлинности в Реестр контейнеров Azure (вместо имени пользователя или пароля). Используйте system для удостоверения, назначаемого системой, используйте идентификатор ресурса для удостоверения, назначаемого пользователем. Управляемое удостоверение должно быть назначено разрешения acrpull для ACR перед развертыванием (используйте команду az role assignment create --role acrpull ...".

Свойство Значение
Группа параметров: Registry Arguments
--registry-password

Пароль для входа в реестр контейнеров. Если он хранится в качестве секрета, значение должно начинаться с "secretref:", за которым следует имя секрета.

Свойство Значение
Группа параметров: Registry Arguments
--registry-server

Имя узла сервера реестра контейнеров, например myregistry.azurecr.io.

Свойство Значение
Группа параметров: Registry Arguments
--registry-username

Имя пользователя для входа в реестр контейнеров.

Свойство Значение
Группа параметров: Registry Arguments
--secrets -s

Список секретов для пула сеансов. Разделенные пробелами значения в формате key=value. Пустая строка для очистки существующих значений.

Свойство Значение
Группа параметров: Configuration Arguments
--target-port

Порт сеанса, используемый для входящего трафика.

Свойство Значение
Группа параметров: Container Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az containerapp sessionpool delete

Удаление пула сеансов.

az containerapp sessionpool delete --resource-group
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--ids]
                                   [--name]
                                   [--no-wait]
                                   [--subscription]
                                   [--yes]

Примеры

Удаление пула сеансов.

az containerapp sessionpool delete -n mysessionpool -g MyResourceGroup

Обязательные параметры

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--name -n

Имя пула сеансов.

Свойство Значение
Группа параметров: Resource Id Arguments
--no-wait

Не ожидать завершения длительной операции.

Свойство Значение
Default value: False
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Группа параметров: Resource Id Arguments
--yes -y

Не запрашивать подтверждение.

Свойство Значение
Default value: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az containerapp sessionpool list

Вывод списка пулов сеансов по подписке или группе ресурсов.

az containerapp sessionpool list [--resource-group]

Примеры

Вывод списка пулов сеансов в текущей подписке.

az containerapp sessionpool list

Вывод списка пулов сеансов по группе ресурсов.

az containerapp sessionpool list -g MyResourceGroup

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az containerapp sessionpool show

Отображение сведений о пуле сеансов.

az containerapp sessionpool show --resource-group
                                 [--ids]
                                 [--name]
                                 [--subscription]

Примеры

Отображение сведений о пуле сеансов.

az containerapp sessionpool show -n mysessionpool -g MyResourceGroup

Обязательные параметры

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--name -n

Имя пула сеансов.

Свойство Значение
Группа параметров: Resource Id Arguments
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az containerapp sessionpool update

Обновление пула сеансов.

az containerapp sessionpool update --resource-group
                                   [--acquire-policy-token]
                                   [--args]
                                   [--change-reference]
                                   [--command]
                                   [--container-name]
                                   [--cooldown-period]
                                   [--cpu]
                                   [--env-vars]
                                   [--ids]
                                   [--image]
                                   [--lifecycle-type {OnContainerExit, Timed}]
                                   [--location]
                                   [--max-alive-period]
                                   [--max-sessions]
                                   [--memory]
                                   [--mi-system-assigned]
                                   [--mi-user-assigned]
                                   [--name]
                                   [--network-status {EgressDisabled, EgressEnabled}]
                                   [--no-wait]
                                   [--probe-yaml]
                                   [--ready-sessions]
                                   [--registry-identity]
                                   [--registry-password]
                                   [--registry-server]
                                   [--registry-username]
                                   [--secrets]
                                   [--subscription]
                                   [--target-port]

Примеры

Обновите максимальное количество одновременных сеансов и образ пула сеансов.

az containerapp sessionpool update -n mysessionpool -g MyResourceGroup --max-sessions 20 --image MyNewImage

Обновите пробы контейнеров пула сеансов типа CustomContainer.

az containerapp sessionpool update -n mysessionpool -g MyResourceGroup --probe-yaml config.yaml

Обязательные параметры

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--args

Список аргументов команд запуска контейнера. Разделенные пробелами значения, например "-c" "mycommand". Пустая строка для очистки существующих значений.

Свойство Значение
Группа параметров: Container Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--command

Список поддерживаемых команд в контейнере, который будет выполняться во время запуска. Разделенные пробелами значения, например "/bin/queue" "mycommand". Пустая строка для очистки существующих значений.

Свойство Значение
Группа параметров: Container Arguments
--container-name

Имя контейнера. При создании, если имя контейнера не указано, имя контейнера по умолчанию будет использоваться для имени пула сеансов, охватываемого в нижнем регистре.

Свойство Значение
Группа параметров: Container Arguments
--cooldown-period

Период (в секундах), после которого сеанс будет удален, это применимо только для типа жизненного цикла "Timed", default=300.

Свойство Значение
Группа параметров: Configuration Arguments
--cpu

Обязательный ЦП в ядрах от 0,25 до 2.0, например 0,5.

Свойство Значение
Группа параметров: Container Arguments
--env-vars

Список переменных среды для контейнера. Разделенные пробелами значения в формате key=value. Пустая строка для очистки существующих значений. Значение префикса с параметром Secretref:, чтобы ссылаться на секрет.

Свойство Значение
Группа параметров: Container Arguments
--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--image -i

Образ контейнера, например publisher/image-name:tag.

Свойство Значение
Группа параметров: Container Arguments
--lifecycle-type

Тип жизненного цикла пула сеансов.

Свойство Значение
Группа параметров: Configuration Arguments
Допустимые значения: OnContainerExit, Timed
--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--max-alive-period

Период (в секундах) перед удалением сеанса, если его контейнер не был завершен ранее, это применимо только для типа жизненного цикла OnContainerExit, default=3600.

Свойство Значение
Группа параметров: Configuration Arguments
--max-sessions

Максимальное количество сеансов можно выполнять одновременно.

Свойство Значение
Группа параметров: Scale Arguments
--memory

Требуемая память от 0.5 до 4.0, заканчивающаяся "Gi", например 1.0Gi.

Свойство Значение
Группа параметров: Container Arguments
--mi-system-assigned

Логическое значение, указывающее, следует ли назначать назначаемое системой удостоверение.

--mi-user-assigned

Идентификаторы пользователей, разделенные пробелами, должны быть назначены.

--name -n

Имя пула сеансов.

Свойство Значение
Группа параметров: Resource Id Arguments
--network-status

Исходящий трафик включен для сеансов или нет.

Свойство Значение
Группа параметров: Configuration Arguments
Допустимые значения: EgressDisabled, EgressEnabled
--no-wait

Не ожидать завершения длительной операции.

Свойство Значение
Default value: False
--probe-yaml
Предварительный просмотр

Путь к YAML-файлу с конфигурацией проб контейнеров. Применимо только для настраиваемого пула сеансов контейнеров.

Свойство Значение
Группа параметров: Container Arguments
--ready-sessions

Количество сеансов, которые будут готовы в пуле сеансов все время.

Свойство Значение
Группа параметров: Scale Arguments
--registry-identity

Управляемое удостоверение, с помощью которого выполняется проверка подлинности в Реестр контейнеров Azure (вместо имени пользователя или пароля). Используйте system для удостоверения, назначаемого системой, используйте идентификатор ресурса для удостоверения, назначаемого пользователем. Управляемое удостоверение должно быть назначено разрешения acrpull для ACR перед развертыванием (используйте команду az role assignment create --role acrpull ...".

Свойство Значение
Группа параметров: Registry Arguments
--registry-password

Пароль для входа в реестр контейнеров. Если он хранится в качестве секрета, значение должно начинаться с "secretref:", за которым следует имя секрета.

Свойство Значение
Группа параметров: Registry Arguments
--registry-server

Имя узла сервера реестра контейнеров, например myregistry.azurecr.io.

Свойство Значение
Группа параметров: Registry Arguments
--registry-username

Имя пользователя для входа в реестр контейнеров.

Свойство Значение
Группа параметров: Registry Arguments
--secrets -s

Список секретов для пула сеансов. Разделенные пробелами значения в формате key=value. Пустая строка для очистки существующих значений.

Свойство Значение
Группа параметров: Configuration Arguments
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Группа параметров: Resource Id Arguments
--target-port

Порт сеанса, используемый для входящего трафика.

Свойство Значение
Группа параметров: Container Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False