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

az containerapp sessionpool

  • Ссылка

Примечание.

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

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

Команды

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

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

 Расширение ГА
az containerapp sessionpool delete

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

 Расширение ГА
az containerapp sessionpool list

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

 Расширение ГА
az containerapp sessionpool show

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

 Расширение ГА
az containerapp sessionpool update

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

 Расширение ГА

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

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

--args

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

--command

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

--container-name

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

--container-type

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

Допустимые значения: CustomContainer, NodeLTS, PythonLTS
--cooldown-period

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

--cpu

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

--env-vars

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

--environment

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

--image -i

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

--location -l

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

--max-sessions

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

--memory

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

--mi-system-assigned

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

Default value: False
--mi-user-assigned

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

--network-status

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

Допустимые значения: EgressDisabled, EgressEnabled
--no-wait

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

Default value: False
--ready-sessions

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

--registry-identity

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

--registry-password

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

--registry-server

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

--registry-username

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

--secrets -s

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

--target-port

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

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

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

--ids

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

--name -n

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

--no-wait

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

Default value: False
--subscription

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

--yes -y

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

Default value: False
Глобальные параметры
--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

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.

--name -n

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

--subscription

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

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]
                                   [--name]
                                   [--network-status {EgressDisabled, EgressEnabled}]
                                   [--no-wait]
                                   [--ready-sessions]
                                   [--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>.

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

--args

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

--command

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

--container-name

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

--cooldown-period

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

--cpu

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

--env-vars

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

--ids

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

--image -i

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

--location -l

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

--max-sessions

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

--memory

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

--name -n

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

--network-status

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

Допустимые значения: EgressDisabled, EgressEnabled
--no-wait

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

Default value: False
--ready-sessions

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

--registry-password

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

--registry-server

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

--registry-username

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

--secrets -s

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

--subscription

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

--target-port

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

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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