Compartilhar via

az containerapp sessionpool

  • Versão Prévia
  • Referência

Observação

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.

Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Comandos para gerenciar pools de sessões.

Comandos

Nome Description Tipo Status
az containerapp sessionpool create

Crie ou atualize um pool de Sessão.

 Extensão Visualizar
az containerapp sessionpool delete

Exclua um pool de sessões.

 Extensão Visualizar
az containerapp sessionpool list

Listar pools de sessões por assinatura ou grupo de recursos.

 Extensão Visualizar
az containerapp sessionpool show

Mostrar detalhes de um pool de sessões.

 Extensão Visualizar
az containerapp sessionpool update

Atualize um pool de Sessão.

 Extensão Visualizar

az containerapp sessionpool create

Versão Prévia

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

Crie ou atualize um pool de Sessão.

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

Crie ou atualize um Pool de Sessões com o tipo de contêiner CustomContainer 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 com período de desaquecimento 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 Exigidos

--name -n

O nome do pool de sessões.

--resource-group -g

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 do contêiner. Valores separados por espaço, por exemplo, "-c", "mycommand". Cadeia de caracteres vazia para limpar os valores existentes.

--command

Uma lista de comandos com suporte 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 os valores existentes.

--container-name

Nome do contêiner. Na criação, se nenhum nome de contêiner for fornecido, o nome do contêiner será padronizado para o nome do pool de sessões convertido em minúsculas.

--container-type

O tipo de pool do Pool de Sessão, default='PythonLTS'.

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

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

--cpu

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

--env-vars

Uma lista de variáveis de ambiente para o contêiner. Valores separados por espaço no formato 'key=value'. Cadeia de caracteres vazia para limpar os valores existentes. Prefixe o valor com 'secretref:' para fazer referência a um segredo.

--environment

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

--image -i

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

--location -l

Local. 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 a 4,0 terminando com "Gi", por exemplo, 1,0Gi.

--network-status

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

Valores aceitos: EgressDisabled, EgressEnabled
--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: 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 logon no registro de contêiner. Se armazenado como um segredo, o valor deve começar com 'secretref:' seguido pelo nome do segredo.

--registry-server

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

--registry-username

O nome de usuário para fazer logon no registro de contêiner.

--secrets -s

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

--target-port

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az containerapp sessionpool delete

Versão Prévia

O grupo de comandos 'containerapp sessionpool' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--resource-group -g

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

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name -n

O nome do pool de sessões.

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az containerapp sessionpool list

Versão Prévia

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

Listar pools de sessões por assinatura ou grupo de recursos.

az containerapp sessionpool list [--resource-group]

Exemplos

Listar Pools de Sessões na assinatura atual.

az containerapp sessionpool list

Listar pools de sessões por grupo de recursos.

az containerapp sessionpool list -g MyResourceGroup

Parâmetros Opcionais

--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az containerapp sessionpool show

Versão Prévia

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

Mostrar detalhes de um pool de sessões.

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

Exemplos

Mostre os detalhes de um pool de sessões.

az containerapp sessionpool show -n mysessionpool -g MyResourceGroup

Parâmetros Exigidos

--resource-group -g

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

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name -n

O nome do pool de sessões.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az containerapp sessionpool update

Versão Prévia

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

Atualize um pool de Sessão.

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 do máximo 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 Exigidos

--resource-group -g

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 do contêiner. Valores separados por espaço, por exemplo, "-c", "mycommand". Cadeia de caracteres vazia para limpar os valores existentes.

--command

Uma lista de comandos com suporte 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 os valores existentes.

--container-name

Nome do contêiner. Na criação, se nenhum nome de contêiner for fornecido, o nome do contêiner será padronizado para o nome do pool de sessões convertido em minúsculas.

--cooldown-period

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

--cpu

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

--env-vars

Uma lista de variáveis de ambiente para o contêiner. Valores separados por espaço no formato 'key=value'. Cadeia de caracteres vazia para limpar os valores existentes. Prefixe o valor com 'secretref:' para fazer referência a um segredo.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--image -i

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

--location -l

Local. 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 a 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 aceitos: EgressDisabled, EgressEnabled
--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: 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 logon no registro de contêiner. Se armazenado como um segredo, o valor deve começar com 'secretref:' seguido pelo nome do segredo.

--registry-server

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

--registry-username

O nome de usuário para fazer logon no registro de contêiner.

--secrets -s

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--target-port

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.