Partilhar via

az containerapp sessionpool

  • Pré-visualizar
  • Referência

Nota

Essa referência faz parte da extensão containerapp para a CLI do Azure (versão 2.62.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az containerapp sessionpool . Saiba mais sobre extensões.

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Comandos para gerenciar pools de sessões.

Comandos

Name Description Tipo Status
az containerapp sessionpool create

Crie ou atualize um pool de sessões.

 Extensão Pré-visualizar
az containerapp sessionpool delete

Exclua um pool de sessões.

 Extensão Pré-visualizar
az containerapp sessionpool list

Listar Pools de Sessão por assinatura ou grupo de recursos.

 Extensão Pré-visualizar
az containerapp sessionpool show

Mostrar detalhes de um Pool de Sessões.

 Extensão Pré-visualizar
az containerapp sessionpool update

Atualizar um pool de sessões.

 Extensão Pré-visualizar

az containerapp sessionpool create

Pré-visualizar

O grupo de comandos 'containerapp sessionpool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie ou atualize um pool de sessões.

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]

Exemplos

Crie ou atualize um Pool de Sessões com as configurações padrão do tipo de contêiner PythonLTS.

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

Crie ou atualize um Pool de Sessões com o tipo de contêiner PythonLTS, com o máximo de sessões simultâneas é 30, instâncias de sessão prontas 20.

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

Crie ou atualize um Pool de Sessões com o tipo de contêiner CustomContainer com imagem de início rápido padrão.

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

Crie ou atualize um Pool de Sessões com o tipo de contêiner CustomContainer que tenha segredos e variáveis de ambiente.

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

Criar ou atualizar um Pool de Sessões com o tipo de contêiner CustomContainer a partir do registro privado

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

Criar ou atualizar um Pool de Sessões com o tipo de contêiner CustomContainer e Managed Identity para autenticar o Registro de contêiner do 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

Crie ou atualize um Pool de Sessões com o tipo de contêiner CustomContainer com o sistema atribuído e a identidade atribuída pelo usuário.

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

Criar ou atualizar um Pool de Sessões com o tipo de contêiner CustomContainer com período de resfriamento 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

Parâmetros Obrigatórios

--name -n

O nome do Pool de Sessões.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--args

Uma lista de argumentos de comando de inicialização de contêiner. Valores separados por espaço, por exemplo, "-c" "mycommand". Cadeia de caracteres vazia para limpar valores existentes.

--command

Uma lista de comandos suportados no contêiner que serão executados durante a inicialização. Valores separados por espaço, por exemplo, "/bin/queue", "mycommand". Cadeia de caracteres vazia para limpar valores existentes.

--container-name

Nome do contentor. Ao criar, se nenhum nome de contêiner for fornecido, o nome do contêiner será padronizado para o nome do pool de sessões coberto para minúsculas.

--container-type

O tipo de pool do Pool de Sessões, default='PythonLTS'.

Valores aceites: CustomContainer, NodeLTS, PythonLTS
--cooldown-period

Período (em segundos), após o qual a sessão será excluída, default=300.

--cpu

CPU necessária em núcleos de 0,25 - 2,0, por exemplo, 0,5.

--env-vars

Uma lista de variáveis(ões) de ambiente para o contêiner. Valores separados por espaço no formato 'key=value'. Cadeia de caracteres vazia para limpar valores existentes. Valor do prefixo com 'secretref:' para fazer referência a um segredo.

--environment

Nome ou ID do recurso do ambiente do aplicativo contêiner.

--image -i

Imagem de contêiner, por exemplo, publisher/image-name:tag.

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--max-sessions

A contagem máxima de sessões pode ser executada ao mesmo tempo.

--memory

Memória necessária de 0,5 - 4,0 terminando com "Gi", por exemplo, 1,0Gi.

--mi-system-assigned

Booleano indicando se a identidade atribuída ao sistema deve ser atribuída.

Default value: False
--mi-user-assigned

Identidades de usuário separadas por espaço a serem atribuídas.

--network-status

A saída está habilitada para as Sessões ou não.

Valores aceites: EgressDisabled, EgressEnabled
--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--ready-sessions

O número de sessões que estarão prontas no pool de sessões o tempo todo.

--registry-identity

A identidade gerenciada com a qual autenticar no Registro de Contêiner do Azure (em vez de nome de usuário/senha). Use 'system' para uma identidade atribuída ao sistema, use um ID de recurso para uma identidade atribuída pelo usuário. A identidade gerenciada deve ter recebido permissões acrpull no ACR antes da implantação (use 'az role assignment create --role acrpull ...').

--registry-password

A senha para fazer login no registro do contêiner. Se armazenado como um segredo, o valor deve começar com 'secretref:' seguido pelo nome secreto.

--registry-server

O nome de host do servidor de registro de contêiner, por exemplo, myregistry.azurecr.io.

--registry-username

O nome de usuário para efetuar login no registro de contêiner.

--secrets -s

Uma lista de segredo(s) para o pool de sessões. Valores separados por espaço no formato 'key=value'. Cadeia de caracteres vazia para limpar valores existentes.

--target-port

A porta de sessão usada para o tráfego de entrada.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az containerapp sessionpool delete

Pré-visualizar

O grupo de comandos 'containerapp sessionpool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Exclua um pool de sessões.

az containerapp sessionpool delete --resource-group
                                   [--ids]
                                   [--name]
                                   [--no-wait]
                                   [--subscription]
                                   [--yes]

Exemplos

Exclua um pool de sessões.

az containerapp sessionpool delete -n mysessionpool -g MyResourceGroup

Parâmetros Obrigatórios

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

O nome do Pool de Sessões.

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az containerapp sessionpool list

Pré-visualizar

O grupo de comandos 'containerapp sessionpool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Listar Pools de Sessão por assinatura ou grupo de recursos.

az containerapp sessionpool list [--resource-group]

Exemplos

Liste Pools de Sessões na assinatura atual.

az containerapp sessionpool list

Listar Pools de Sessão por grupo de recursos.

az containerapp sessionpool list -g MyResourceGroup

Parâmetros Opcionais

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az containerapp sessionpool show

Pré-visualizar

O grupo de comandos 'containerapp sessionpool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Mostrar detalhes de um Pool de Sessões.

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

Exemplos

Mostrar os detalhes de um Pool de Sessões.

az containerapp sessionpool show -n mysessionpool -g MyResourceGroup

Parâmetros Obrigatórios

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

O nome do Pool de Sessões.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az containerapp sessionpool update

Pré-visualizar

O grupo de comandos 'containerapp sessionpool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Atualizar um pool de sessões.

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]

Exemplos

Atualize a configuração e a imagem máximas de sessões simultâneas de um pool de sessões.

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

Parâmetros Obrigatórios

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--args

Uma lista de argumentos de comando de inicialização de contêiner. Valores separados por espaço, por exemplo, "-c" "mycommand". Cadeia de caracteres vazia para limpar valores existentes.

--command

Uma lista de comandos suportados no contêiner que serão executados durante a inicialização. Valores separados por espaço, por exemplo, "/bin/queue", "mycommand". Cadeia de caracteres vazia para limpar valores existentes.

--container-name

Nome do contentor. Ao criar, se nenhum nome de contêiner for fornecido, o nome do contêiner será padronizado para o nome do pool de sessões coberto para minúsculas.

--cooldown-period

Período (em segundos), após o qual a sessão será excluída, default=300.

--cpu

CPU necessária em núcleos de 0,25 - 2,0, por exemplo, 0,5.

--env-vars

Uma lista de variáveis(ões) de ambiente para o contêiner. Valores separados por espaço no formato 'key=value'. Cadeia de caracteres vazia para limpar valores existentes. Valor do prefixo com 'secretref:' para fazer referência a um segredo.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--image -i

Imagem de contêiner, por exemplo, publisher/image-name:tag.

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--max-sessions

A contagem máxima de sessões pode ser executada ao mesmo tempo.

--memory

Memória necessária de 0,5 - 4,0 terminando com "Gi", por exemplo, 1,0Gi.

--name -n

O nome do Pool de Sessões.

--network-status

A saída está habilitada para as Sessões ou não.

Valores aceites: EgressDisabled, EgressEnabled
--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--ready-sessions

O número de sessões que estarão prontas no pool de sessões o tempo todo.

--registry-password

A senha para fazer login no registro do contêiner. Se armazenado como um segredo, o valor deve começar com 'secretref:' seguido pelo nome secreto.

--registry-server

O nome de host do servidor de registro de contêiner, por exemplo, myregistry.azurecr.io.

--registry-username

O nome de usuário para efetuar login no registro de contêiner.

--secrets -s

Uma lista de segredo(s) para o pool de sessões. Valores separados por espaço no formato 'key=value'. Cadeia de caracteres vazia para limpar valores existentes.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--target-port

A porta de sessão usada para o tráfego de entrada.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.