Поделиться через

az containerapp sessionpool

Note

Эта ссылка является частью расширения containerapp для Azure CLI (версия 2.62.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
                                   [--args]
                                   [--command]
                                   [--container-name]
                                   [--container-type {CustomContainer, NodeLTS, PythonLTS}]
                                   [--cooldown-period]
                                   [--cpu]
                                   [--env-vars]
                                   [--environment]
                                   [--image]
                                   [--location]
                                   [--max-sessions]
                                   [--memory]
                                   [--mi-system-assigned]
                                   [--mi-user-assigned]
                                   [--network-status {EgressDisabled, EgressEnabled}]
                                   [--no-wait]
                                   [--ready-sessions]
                                   [--registry-identity]
                                   [--registry-password]
                                   [--registry-server]
                                   [--registry-username]
                                   [--secrets]
                                   [--target-port]

Примеры

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

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

Создайте или обновите пул сеансов с типом 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

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

--name -n

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

--resource-group -g

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--args

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

Свойство Значение
Parameter group: Container Arguments
--command

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

Свойство Значение
Parameter group: Container Arguments
--container-name

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

Свойство Значение
Parameter group: Container Arguments
--container-type

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

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

Период (в секундах), после которого сеанс будет удален, по умолчанию =300.

Свойство Значение
Parameter group: Configuration Arguments
--cpu

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

Свойство Значение
Parameter group: Container Arguments
--env-vars

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

Свойство Значение
Parameter group: Container Arguments
--environment

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

Свойство Значение
Parameter group: Container Arguments
--image -i

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

Свойство Значение
Parameter group: Container Arguments
--location -l

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

--max-sessions

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

Свойство Значение
Parameter group: Scale Arguments
--memory

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

Свойство Значение
Parameter group: Container Arguments
--mi-system-assigned

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

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

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

--network-status

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

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

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

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

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

Свойство Значение
Parameter group: Scale Arguments
--registry-identity

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

Свойство Значение
Parameter group: Registry Arguments
--registry-password

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

Свойство Значение
Parameter group: Registry Arguments
--registry-server

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

Свойство Значение
Parameter group: Registry Arguments
--registry-username

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

Свойство Значение
Parameter group: Registry Arguments
--secrets -s

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

Свойство Значение
Parameter group: Configuration Arguments
--target-port

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

Свойство Значение
Parameter group: 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
                                   [--ids]
                                   [--name]
                                   [--no-wait]
                                   [--subscription]
                                   [--yes]

Примеры

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

az containerapp sessionpool delete -n mysessionpool -g MyResourceGroup

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

--resource-group -g

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Свойство Значение
Parameter group: Resource Id Arguments
--name -n

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

Свойство Значение
Parameter group: Resource Id Arguments
--no-wait

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

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

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

Свойство Значение
Parameter group: 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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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>.

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Свойство Значение
Parameter group: Resource Id Arguments
--name -n

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

Свойство Значение
Parameter group: Resource Id Arguments
--subscription

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

Свойство Значение
Parameter group: 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
                                   [--args]
                                   [--command]
                                   [--container-name]
                                   [--cooldown-period]
                                   [--cpu]
                                   [--env-vars]
                                   [--ids]
                                   [--image]
                                   [--location]
                                   [--max-sessions]
                                   [--memory]
                                   [--mi-system-assigned]
                                   [--mi-user-assigned]
                                   [--name]
                                   [--network-status {EgressDisabled, EgressEnabled}]
                                   [--no-wait]
                                   [--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

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

--resource-group -g

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--args

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

Свойство Значение
Parameter group: Container Arguments
--command

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

Свойство Значение
Parameter group: Container Arguments
--container-name

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

Свойство Значение
Parameter group: Container Arguments
--cooldown-period

Период (в секундах), после которого сеанс будет удален, по умолчанию =300.

Свойство Значение
Parameter group: Configuration Arguments
--cpu

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

Свойство Значение
Parameter group: Container Arguments
--env-vars

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

Свойство Значение
Parameter group: Container Arguments
--ids

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

Свойство Значение
Parameter group: Resource Id Arguments
--image -i

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

Свойство Значение
Parameter group: Container Arguments
--location -l

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

--max-sessions

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

Свойство Значение
Parameter group: Scale Arguments
--memory

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

Свойство Значение
Parameter group: Container Arguments
--mi-system-assigned

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

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

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

--name -n

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

Свойство Значение
Parameter group: Resource Id Arguments
--network-status

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

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

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

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

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

Свойство Значение
Parameter group: Scale Arguments
--registry-identity

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

Свойство Значение
Parameter group: Registry Arguments
--registry-password

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

Свойство Значение
Parameter group: Registry Arguments
--registry-server

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

Свойство Значение
Parameter group: Registry Arguments
--registry-username

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

Свойство Значение
Parameter group: Registry Arguments
--secrets -s

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

Свойство Значение
Parameter group: Configuration Arguments
--subscription

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

Свойство Значение
Parameter group: Resource Id Arguments
--target-port

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

Свойство Значение
Parameter group: 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