az spring app

  • Referência

Observação

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

Comandos para gerenciar aplicativos no Azure Spring Apps.

Comandos

Nome Description Tipo Status
az spring app append-loaded-public-certificate

Acrescente um novo certificado público carregado a um aplicativo no Azure Spring Apps.

 Extensão GA
az spring app append-persistent-storage

Acrescente um novo armazenamento persistente a um aplicativo no Azure Spring Apps.

 Extensão GA
az spring app binding

Comandos para gerenciar associações com os Serviços de Dados do Azure, você precisa reiniciar manualmente o aplicativo para que as configurações entrem em vigor.

 Extensão Preterido
az spring app binding cosmos

Comandos para gerenciar associações do Azure Cosmos DB.

 Extensão Preterido
az spring app binding cosmos add

Associar um Azure Cosmos DB ao aplicativo.

 Extensão Preterido
az spring app binding cosmos update

Atualize uma associação de serviço do Azure Cosmos DB do aplicativo.

 Extensão Preterido
az spring app binding list

Listar todas as associações de serviço em um aplicativo.

 Extensão Preterido
az spring app binding mysql

Comandos para gerenciar associações do Banco de Dados do Azure para MySQL.

 Extensão Preterido
az spring app binding mysql add

Associe um Banco de Dados do Azure para MySQL ao aplicativo.

 Extensão Preterido
az spring app binding mysql update

Atualize uma associação de serviço do Banco de Dados do Azure para MySQL do aplicativo.

 Extensão Preterido
az spring app binding redis

Comandos para gerenciar associações do Cache do Azure para Redis.

 Extensão Preterido
az spring app binding redis add

Associe um Cache do Azure para Redis ao aplicativo.

 Extensão Preterido
az spring app binding redis update

Atualize uma associação de serviço do Cache do Azure para Redis do aplicativo.

 Extensão Preterido
az spring app binding remove

Remova uma associação de serviço do aplicativo.

 Extensão Preterido
az spring app binding show

Mostre os detalhes de uma associação de serviço.

 Extensão Preterido
az spring app connect

Conecte-se ao shell interativo de uma instância do aplicativo para solução de problemas'.

 Extensão GA
az spring app create

Crie um novo aplicativo com uma implantação padrão na instância do Azure Spring Apps.

 Extensão GA
az spring app custom-domain

Comandos para gerenciar domínios personalizados.

 Extensão GA
az spring app custom-domain bind

Associe um domínio personalizado ao aplicativo.

 Extensão GA
az spring app custom-domain list

Liste todos os domínios personalizados do aplicativo.

 Extensão GA
az spring app custom-domain show

Mostrar detalhes de um domínio personalizado.

 Extensão GA
az spring app custom-domain unbind

Desassocie um domínio personalizado do aplicativo.

 Extensão GA
az spring app custom-domain update

Atualize um domínio personalizado do aplicativo.

 Extensão GA
az spring app delete

Exclua um aplicativo no Azure Spring Apps.

 Extensão GA
az spring app deploy

Implante o código-fonte ou binário pré-criado em um aplicativo e atualize as configurações relacionadas.

 Extensão GA
az spring app deployment

Comandos para gerenciar o ciclo de vida das implantações de um aplicativo no Azure Spring Apps. Mais operações em implantações podem ser feitas no nível do aplicativo com o parâmetro --deployment. por exemplo, az spring app deploy --deployment .

 Extensão GA
az spring app deployment create

Crie uma implantação de preparo para o aplicativo. Para implantar código ou atualizar a configuração para uma implantação existente, use az spring app deploy/update --deployment <staging deployment>o .

 Extensão GA
az spring app deployment delete

Exclua uma implantação do aplicativo.

 Extensão GA
az spring app deployment generate-heap-dump

Gere um despejo de heap da instância do aplicativo de destino para o caminho do arquivo especificado.

 Extensão GA
az spring app deployment generate-thread-dump

Gere um despejo de thread da instância do aplicativo de destino para o caminho do arquivo especificado.

 Extensão GA
az spring app deployment list

Liste todas as implantações em um aplicativo.

 Extensão GA
az spring app deployment show

Mostrar detalhes de uma implantação.

 Extensão GA
az spring app deployment start-jfr

Inicie um JFR na instância do aplicativo de destino para o caminho do arquivo especificado.

 Extensão GA
az spring app disable-remote-debugging

Desabilite a depuração remota para uma implantação.

 Extensão GA
az spring app enable-remote-debugging

Habilite a depuração remota para uma implantação.

 Extensão GA
az spring app get-remote-debugging-config

Obtenha a configuração de depuração remota de uma implantação.

 Extensão GA
az spring app identity

Gerenciar as identidades gerenciadas de um aplicativo.

 Extensão GA
az spring app identity assign

Habilite a identidade gerenciada atribuída pelo sistema ou atribua identidades gerenciadas atribuídas pelo usuário a um aplicativo.

 Extensão GA
az spring app identity force-set

Forçar o conjunto de identidades gerenciadas em um aplicativo.

 Extensão GA
az spring app identity remove

Remova a identidade gerenciada de um aplicativo.

 Extensão GA
az spring app identity show

Exiba as informações de identidade gerenciada do aplicativo.

 Extensão GA
az spring app list

Liste todos os aplicativos no Azure Spring Apps.

 Extensão GA
az spring app log

Comandos para tail app instances logs com várias opções. Se o aplicativo tiver apenas uma instância, o nome da instância será opcional.

 Extensão Preterido
az spring app log tail

Mostrar logs de uma instância do aplicativo, os logs serão transmitidos ao definir '-f/--follow'.

 Extensão Preterido
az spring app logs

Mostrar logs de uma instância do aplicativo, os logs serão transmitidos ao definir '-f/--follow'.

 Extensão GA
az spring app restart

Reinicie as instâncias do aplicativo, padrão para implantação de produção.

 Extensão GA
az spring app scale

Dimensione manualmente um aplicativo ou suas implantações.

 Extensão GA
az spring app set-deployment

Defina a implantação de produção de um aplicativo.

 Extensão GA
az spring app show

Mostre os detalhes de um aplicativo no Azure Spring Apps.

 Extensão GA
az spring app show-deploy-log

Mostrar log de compilação da última implantação, aplicar apenas à implantação do código-fonte, padrão à implantação de produção.

 Extensão GA
az spring app start

Inicie instâncias do aplicativo, padrão para implantação de produção.

 Extensão GA
az spring app stop

Pare as instâncias do aplicativo, padronize para a implantação de produção.

 Extensão GA
az spring app unset-deployment

Implantação de produção não definida de um aplicativo.

 Extensão GA
az spring app update

Atualize as configurações de um aplicativo.

 Extensão GA

az spring app append-loaded-public-certificate

Acrescente um novo certificado público carregado a um aplicativo no Azure Spring Apps.

az spring app append-loaded-public-certificate --certificate-name
                                               --load-trust-store {false, true}
                                               --name
                                               --resource-group
                                               --service

Exemplos

Acrescente um novo certificado público carregado a um aplicativo.

az spring app append-loaded-public-certificate --name MyApp --service MyCluster --resource-group MyResourceGroup --certificate-name MyCertName --load-trust-store true

Parâmetros Exigidos

--certificate-name

Nome do certificado a ser anexado.

--load-trust-store

Se true, o certificado será carregado no armazenamento confiável para aplicativos Java.

Valores aceitos: false, true
Valor padrão: False
--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

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 spring app append-persistent-storage

Acrescente um novo armazenamento persistente a um aplicativo no Azure Spring Apps.

az spring app append-persistent-storage --mount-path
                                        --name
                                        --persistent-storage-type
                                        --resource-group
                                        --service
                                        --storage-name
                                        [--enable-sub-path {false, true}]
                                        [--mount-options]
                                        [--read-only {false, true}]
                                        [--share-name]

Exemplos

Acrescente um novo armazenamento persistente a um aplicativo.

az spring app append-persistent-storage --persistent-storage-type AzureFileVolume --share-name MyShareName --mount-path /MyMountPath --storage-name MyStorageName -n MyApp -g MyResourceGroup -s MyService

Parâmetros Exigidos

--mount-path

O caminho para o volume de armazenamento persistente a ser montado.

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--persistent-storage-type -t

Tipo de armazenamento persistente em volume.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

--storage-name

Nome do recurso de armazenamento que você criou no Azure Spring Apps.

Parâmetros Opcionais

--enable-sub-path

[opcional] Se true, será montado em subdiretórios separados com o mesmo caminho para cada instância do aplicativo.

Valores aceitos: false, true
Valor padrão: False
--mount-options

[opcional] As opções de montagem para o volume de armazenamento persistente.

--read-only

[opcional] Se true, o volume de armazenamento persistente será somente leitura.

Valores aceitos: false, true
Valor padrão: False
--share-name

O nome do compartilhamento de arquivos pré-criado. ShareName deve ser fornecido somente se o tipo do volume de armazenamento persistente for AzureFileVolume.

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 spring app connect

Conecte-se ao shell interativo de uma instância do aplicativo para solução de problemas'.

az spring app connect --name
                      --resource-group
                      --service
                      [--deployment]
                      [--instance]
                      [--shell-cmd]

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--deployment -d

Nome de uma implantação existente do aplicativo. Padrão para a implantação de produção se não for especificado.

--instance -i

Nome de uma instância existente da implantação.

--shell-cmd

O comando shell a ser executado ao se conectar à instância do aplicativo.

Valor padrão: /bin/sh
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 spring app create

Crie um novo aplicativo com uma implantação padrão na instância do Azure Spring Apps.

az spring app create --name
                     --resource-group
                     --service
                     [--assign-endpoint {false, true}]
                     [--assign-public-endpoint {false, true}]
                     [--backend-protocol {Default, GRPC}]
                     [--bind-acs]
                     [--bind-config-server]
                     [--bind-service-registry]
                     [--client-auth-certs]
                     [--cpu]
                     [--deployment-name]
                     [--disable-probe {false, true}]
                     [--disable-tea {false, true}]
                     [--enable-liveness-probe {false, true}]
                     [--enable-persistent-storage {false, true}]
                     [--enable-readiness-probe {false, true}]
                     [--enable-startup-probe {false, true}]
                     [--env]
                     [--grace-period]
                     [--ingress-read-timeout]
                     [--ingress-send-timeout]
                     [--instance-count]
                     [--jvm-options]
                     [--liveness-probe-config]
                     [--loaded-public-certificate-file]
                     [--max-replicas]
                     [--memory]
                     [--min-replicas]
                     [--persistent-storage]
                     [--readiness-probe-config]
                     [--runtime-version {Java_11, Java_17, Java_21, Java_8, NetCore_31}]
                     [--scale-rule-auth]
                     [--scale-rule-http-concurrency]
                     [--scale-rule-metadata]
                     [--scale-rule-name]
                     [--scale-rule-type]
                     [--secrets]
                     [--session-affinity {Cookie, None}]
                     [--session-max-age]
                     [--startup-probe-config]
                     [--system-assigned {false, true}]
                     [--user-assigned]
                     [--workload-profile]

Exemplos

Crie um aplicativo com a configuração padrão.

az spring app create -n MyApp -s MyCluster -g MyResourceGroup

Crie um aplicativo acessível ao público com 3 instâncias e 2 núcleos de CPU e 3 GB de memória por instância.

az spring app create -n MyApp -s MyCluster -g MyResourceGroup --assign-endpoint true --cpu 2 --memory 3 --instance-count 3

Crie uma associação de aplicativo para o Registro de Serviço padrão, o Serviço de Configuração de Aplicativos e o Spring Cloud Config Server.

az spring app create -n MyApp -s MyCluster -g MyResourceGroup --bind-service-registry --bind-application-configuration-service --bind-config-server

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--assign-endpoint

Se true, atribua a URL do ponto de extremidade para acesso direto.

Valores aceitos: false, true
Valor padrão: False
--assign-public-endpoint

Se true, atribua a URL do ponto de extremidade que pode ser acessada fora da rede virtual para o aplicativo de instância de injeção de vnet.

Valores aceitos: false, true
--backend-protocol

Protocolo de back-end de entrada do aplicativo. O padrão significa HTTP/HTTPS/WebSocket.

Valores aceitos: Default, GRPC
--bind-acs --bind-application-configuration-service

Associe o aplicativo ao Serviço de Configuração de Aplicativo padrão automaticamente.

--bind-config-server --bind-cs

Vincule o aplicativo ao Config Server padrão automaticamente.

--bind-service-registry --bind-sr

Vincule o aplicativo ao Registro de Serviço padrão automaticamente.

--client-auth-certs

Uma cadeia de caracteres separada por espaço que contém IDs de recursos de certificados para autenticação de cliente. por exemplo: --client_auth_certs='id0 id1'. Use '' para limpar os certificados existentes.

--cpu

Quantidade de recursos da CPU. Deve ser 250m, 500m, 750m, 1250m ou número de núcleos de CPU.

--deployment-name

Nome da implantação padrão.

Valor padrão: default
--disable-probe

Se for verdadeiro, desative a sonda de atividade e preparação.

Valores aceitos: false, true
--disable-tea --disable-test-endpoint-auth

Se true, desabilite a autenticação do ponto de extremidade de teste do aplicativo.

Valores aceitos: false, true
Valor padrão: False
--enable-liveness-probe
Versão Prévia

Se false, desabilitará a investigação de atividade da instância do aplicativo.

Valores aceitos: false, true
--enable-persistent-storage --enable-ps

Se true, monte um disco de 50G (tipo de preço Standard) ou 1G (tipo de preço básico) com o caminho padrão.

Valores aceitos: false, true
--enable-readiness-probe
Versão Prévia

Se false, desabilitará a investigação de preparação da instância do aplicativo.

Valores aceitos: false, true
--enable-startup-probe
Versão Prévia

Se false, desabilitará a investigação de inicialização da instância do aplicativo.

Valores aceitos: false, true
--env

Variáveis de ambiente separadas por espaço no formato 'key[=value]'.

--grace-period --termination-grace-period-seconds
Versão Prévia

Duração opcional em segundos que a instância do aplicativo precisa encerrar normalmente.

--ingress-read-timeout

Valor de tempo limite de leitura de entrada em segundos. Padrão 300, mínimo é 1, máximo é 1800.

--ingress-send-timeout

Valor de tempo limite de envio de entrada em segundos. Padrão 60, mínimo é 1, máximo é 1800.

--instance-count

Número de instâncias.

Valor padrão: 1
--jvm-options

Uma string contendo opções jvm, use '=' em vez de ' ' para este argumento para evitar erro de análise bash, por exemplo: --jvm-options='-Xms1024m -Xmx2048m'.

--liveness-probe-config
Versão Prévia

Um caminho de arquivo json indica a configuração da sonda de atividade.

--loaded-public-certificate-file -f

Um caminho de arquivo json indica os certificados que seriam carregados no aplicativo.

--max-replicas

O número máximo de réplicas.

Valor padrão: 10
--memory

Quantidade de recursos de memória. Deve ser 512Mi, 1536Mi, 2560Mi, 3584Mi ou #Gi, por exemplo, 1Gi, 3Gi.

--min-replicas

O número mínimo de réplicas.

Valor padrão: 1
--persistent-storage

Um caminho de arquivo json para os armazenamentos persistentes a serem montados no aplicativo.

--readiness-probe-config
Versão Prévia

Um caminho de arquivo json indica a configuração da sonda de preparação.

--runtime-version

Versão de tempo de execução da linguagem usada.

Valores aceitos: Java_11, Java_17, Java_21, Java_8, NetCore_31
--scale-rule-auth --sra

Parâmetros de autenticação de regra de escala. Formate "=" e separado por espaço.

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

O número máximo de solicitações simultâneas antes da expansão. Com suporte apenas para regras de escala http e tcp.

--scale-rule-metadata --srm

Dimensionar metadados de regra. Formate "key[=value]" e separado por espaço.

--scale-rule-name --srn

O nome da regra de escala.

--scale-rule-type --srt

O tipo da regra de escala. Padrão: http.

--secrets

Uma lista de segredos para o aplicativo. Formate "key[=value]" e separado por espaço.

--session-affinity

Afinidade de sessão de entrada do aplicativo.

Valores aceitos: Cookie, None
--session-max-age

Tempo até que o cookie expire. O mínimo é de 1 segundo, o máximo é de 7 dias. Se definido como 0, o período de expiração será igual ao período da sessão do navegador.

--startup-probe-config
Versão Prévia

Um caminho de arquivo json indica a configuração da sonda de inicialização.

--system-assigned

Habilitar a identidade gerenciada atribuída pelo sistema.

Valores aceitos: false, true
--user-assigned
Versão Prévia

IDs de recurso de identidade gerenciada atribuídas pelo usuário separadas por espaço para atribuir a um aplicativo.

--workload-profile

O perfil de carga de trabalho usado no ambiente gerenciado. O padrão é "Consumo".

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 spring app delete

Exclua um aplicativo no Azure Spring Apps.

az spring app delete --name
                     --resource-group
                     --service

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

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 spring app deploy

Implante o código-fonte ou binário pré-criado em um aplicativo e atualize as configurações relacionadas.

az spring app deploy --name
                     --resource-group
                     --service
                     [--apms]
                     [--artifact-path]
                     [--build-certificates]
                     [--build-cpu]
                     [--build-env]
                     [--build-memory]
                     [--builder]
                     [--config-file-patterns]
                     [--container-args]
                     [--container-command]
                     [--container-image]
                     [--container-registry]
                     [--custom-actuator-path]
                     [--custom-actuator-port]
                     [--deployment]
                     [--disable-app-log]
                     [--disable-probe {false, true}]
                     [--disable-validation {false, true}]
                     [--enable-liveness-probe {false, true}]
                     [--enable-readiness-probe {false, true}]
                     [--enable-startup-probe {false, true}]
                     [--env]
                     [--grace-period]
                     [--jvm-options]
                     [--language-framework]
                     [--liveness-probe-config]
                     [--main-entry]
                     [--no-wait]
                     [--readiness-probe-config]
                     [--registry-password]
                     [--registry-username]
                     [--runtime-version {Java_11, Java_17, Java_21, Java_8, NetCore_31}]
                     [--server-version]
                     [--source-path]
                     [--startup-probe-config]
                     [--target-module]
                     [--version]

Exemplos

Implante o código-fonte em um aplicativo. Isso empacotará o diretório atual, compilará o binário com o Pivotal Build Service e, em seguida, implantará no aplicativo.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --source-path

Implante um jar pré-construído em um aplicativo com opções jvm e variáveis de ambiente.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --artifact-path app.jar --jvm-options="-XX:+UseG1GC -XX:+UseStringDeduplication" --env foo=bar

Implante um war pré-construído em um aplicativo com versão do servidor, opções jvm e variáveis de ambiente (somente camadas padrão e básica).

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --artifact-path app.war --server-version Tomcat_10 --jvm-options="-XX:+UseG1GC -XX:+UseStringDeduplication" --env foo=bar

Implante o código-fonte em uma implantação específica de um aplicativo.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup -d green-deployment --source-path

Implante uma imagem de contêiner no Docker Hub em um aplicativo.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1

Implante uma imagem de contêiner em um registro privado em um aplicativo.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --container-image contoso/your-app:v1 --container-registry myacr.azurecr.io --registry-username <username> --registry-password <password>

Implante com padrões de arquivo de configuração do Serviço de Configuração de Aplicativos em um aplicativo.

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --config-file-patterns MyPatterns --artifact-path app.jar

Implante um jar pré-criado em um aplicativo com build env (somente para a camada Enterprise).

az spring app deploy -n MyApp -s MyCluster -g MyResourceGroup --artifact-path app.jar --build-env BP_JVM_VERSION=11.*

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--apms

(Somente nível Enterprise) Nomes de APM separados por espaço.

--artifact-path

Implante o artefato pré-criado especificado (jar, war ou netcore zip, war está em visualização pública).

--build-certificates

(Somente nível Enterprise) Nomes de certificado separados por espaço, os certificados são usados durante o tempo de compilação.

--build-cpu

Quantidade de recursos da CPU. Deve ser 500m ou número de núcleos de CPU.

Valor padrão: 1
--build-env

Variáveis de ambiente separadas por espaço no formato 'key[=value]'.

--build-memory

Quantidade de recursos de memória. Deve ser 512Mi ou #Gi, por exemplo, 1Gi, 3Gi.

Valor padrão: 2Gi
--builder

(Somente nível Enterprise) Construtor de serviços de compilação usado para criar o executável.

Valor padrão: default
--config-file-patterns

(Somente nível Enterprise) Padrões de arquivo de configuração separados por ',' para decidir quais padrões do Serviço de Configuração de Aplicativos serão usados. Use '""' para limpar as configurações existentes.

--container-args

Os argumentos da imagem do contêiner.

--container-command

O comando da imagem do contêiner.

--container-image

A tag de imagem do contêiner.

--container-registry

O registro da imagem de contêiner.

Valor padrão: docker.io
--custom-actuator-path

(Somente nível Enterprise) Caminho do atuador personalizado para o aplicativo. O padrão é "/actuator".

--custom-actuator-port

(Somente nível Enterprise) Porta do atuador personalizado para o aplicativo. O padrão é 8080.

--deployment -d

Nome de uma implantação existente do aplicativo. Padrão para a implantação de produção se não for especificado.

--disable-app-log

Não imprima logs de aplicativos ao implantar aplicativos.

Valor padrão: False
--disable-probe

Se for verdadeiro, desative a sonda de atividade e preparação.

Valores aceitos: false, true
--disable-validation

Se for verdadeiro, desative a validação do jar.

Valores aceitos: false, true
--enable-liveness-probe
Versão Prévia

Se false, desabilitará a investigação de atividade da instância do aplicativo.

Valores aceitos: false, true
--enable-readiness-probe
Versão Prévia

Se false, desabilitará a investigação de preparação da instância do aplicativo.

Valores aceitos: false, true
--enable-startup-probe
Versão Prévia

Se false, desabilitará a investigação de inicialização da instância do aplicativo.

Valores aceitos: false, true
--env

Variáveis de ambiente separadas por espaço no formato 'key[=value]'.

--grace-period --termination-grace-period-seconds
Versão Prévia

Duração opcional em segundos que a instância do aplicativo precisa encerrar normalmente.

--jvm-options

Uma string contendo opções jvm, use '=' em vez de ' ' para este argumento para evitar erro de análise bash, por exemplo: --jvm-options='-Xms1024m -Xmx2048m'.

--language-framework

Estrutura de linguagem da imagem de contêiner carregada. Valores suportados: "springboot", "".

--liveness-probe-config
Versão Prévia

Um caminho de arquivo json indica a configuração da sonda de atividade.

--main-entry -m

Uma cadeia de caracteres que contém o caminho para o executável do .NET em relação à raiz zip.

--no-wait

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

Valor padrão: False
--readiness-probe-config
Versão Prévia

Um caminho de arquivo json indica a configuração da sonda de preparação.

--registry-password

A senha do registro de contêiner.

--registry-username

O nome de usuário do registro de contêiner.

--runtime-version

Versão de tempo de execução da linguagem usada.

Valores aceitos: Java_11, Java_17, Java_21, Java_8, NetCore_31
--server-version

(Somente níveis Standard e Basic) Versão do servidor Tomcat. Liste todas as versões de servidor suportadas executando az spring list-support-server-versions -o tableo . Esse recurso está em uma versão prévia.

--source-path

Implante a pasta de origem especificada. A pasta será compactada em tar, carregada e compilada usando kpack. O padrão é a pasta atual se nenhum valor for fornecido.

--startup-probe-config
Versão Prévia

Um caminho de arquivo json indica a configuração da sonda de inicialização.

--target-module

Módulo filho a ser implantado, necessário para vários pacotes jar construídos a partir do código-fonte.

--version

Versão de implantação, mantenha inalterada se não estiver definida.

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 spring app disable-remote-debugging

Desabilite a depuração remota para uma implantação.

az spring app disable-remote-debugging --name
                                       --resource-group
                                       --service
                                       [--deployment]
                                       [--no-wait]

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--deployment -d

Nome de uma implantação existente do aplicativo. Padrão para a implantação de produção se não for especificado.

--no-wait

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

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 spring app enable-remote-debugging

Habilite a depuração remota para uma implantação.

az spring app enable-remote-debugging --name
                                      --resource-group
                                      --service
                                      [--deployment]
                                      [--no-wait]
                                      [--port]

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--deployment -d

Nome de uma implantação existente do aplicativo. Padrão para a implantação de produção se não for especificado.

--no-wait

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

Valor padrão: False
--port -p

Porta de depuração remota, o valor deve ser de 1024 a 65536, o valor padrão é 5005.

Valor padrão: 5005
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 spring app get-remote-debugging-config

Obtenha a configuração de depuração remota de uma implantação.

az spring app get-remote-debugging-config --name
                                          --resource-group
                                          --service
                                          [--deployment]

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--deployment -d

Nome de uma implantação existente do aplicativo. Padrão para a implantação de produção se não for especificado.

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 spring app list

Liste todos os aplicativos no Azure Spring Apps.

az spring app list --resource-group
                   --service

Exemplos

Status da consulta do armazenamento persistente de todos os aplicativos

az spring app list -s MyCluster -g MyResourceGroup -o json --query '[].{Name:name, PersistentStorage:properties.persistentDisk}'

Parâmetros Exigidos

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

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 spring app logs

Mostrar logs de uma instância do aplicativo, os logs serão transmitidos ao definir '-f/--follow'.

az spring app logs --name
                   --resource-group
                   --service
                   [--deployment]
                   [--follow]
                   [--format-json]
                   [--instance]
                   [--limit]
                   [--lines]
                   [--since]

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--deployment -d

Nome de uma implantação existente do aplicativo. Padrão para a implantação de produção se não for especificado.

--follow -f

Especifique se os logs devem ser transmitidos.

Valor padrão: False
--format-json

Formate os logs JSON se o log estruturado estiver habilitado.

--instance -i

Nome de uma instância existente da implantação.

--limit

Máximo de kilobytes de logs a serem retornados. O número do teto é 2048.

Valor padrão: 2048
--lines

Número de linhas a serem mostradas. O máximo é 10000.

Valor padrão: 50
--since

Retorne apenas logs mais recentes do que uma duração relativa, como 5s, 2m ou 1h. O máximo é de 1h.

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 spring app restart

Reinicie as instâncias do aplicativo, padrão para implantação de produção.

az spring app restart --name
                      --resource-group
                      --service
                      [--deployment]
                      [--no-wait]

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--deployment -d

Nome de uma implantação existente do aplicativo. Padrão para a implantação de produção se não for especificado.

--no-wait

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

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 spring app scale

Dimensione manualmente um aplicativo ou suas implantações.

az spring app scale --name
                    --resource-group
                    --service
                    [--cpu]
                    [--deployment]
                    [--instance-count]
                    [--max-replicas]
                    [--memory]
                    [--min-replicas]
                    [--no-wait]
                    [--scale-rule-auth]
                    [--scale-rule-http-concurrency]
                    [--scale-rule-metadata]
                    [--scale-rule-name]
                    [--scale-rule-type]

Exemplos

Escale verticalmente um aplicativo para 4 núcleos de CPU e 8 Gb de memória por instância.

az spring app scale -n MyApp -s MyCluster -g MyResourceGroup --cpu 3 --memory 8

Escale horizontalmente uma implantação do aplicativo para 5 instâncias.

az spring app scale -n MyApp -s MyCluster -g MyResourceGroup -d green-deployment --instance-count 5

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--cpu

Quantidade de recursos da CPU. Deve ser 250m, 500m, 750m, 1250m ou número de núcleos de CPU.

--deployment -d

Nome de uma implantação existente do aplicativo. Padrão para a implantação de produção se não for especificado.

--instance-count

Número de instâncias.

--max-replicas

O número máximo de réplicas.

Valor padrão: 10
--memory

Quantidade de recursos de memória. Deve ser 512Mi, 1536Mi, 2560Mi, 3584Mi ou #Gi, por exemplo, 1Gi, 3Gi.

--min-replicas

O número mínimo de réplicas.

Valor padrão: 1
--no-wait

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

Valor padrão: False
--scale-rule-auth --sra

Parâmetros de autenticação de regra de escala. Formate "=" e separado por espaço.

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

O número máximo de solicitações simultâneas antes da expansão. Com suporte apenas para regras de escala http e tcp.

--scale-rule-metadata --srm

Dimensionar metadados de regra. Formate "key[=value]" e separado por espaço.

--scale-rule-name --srn

O nome da regra de escala.

--scale-rule-type --srt

O tipo da regra de escala. Padrão: http.

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 spring app set-deployment

Defina a implantação de produção de um aplicativo.

az spring app set-deployment --deployment
                             --name
                             --resource-group
                             --service
                             [--no-wait]

Exemplos

Troque uma implantação de preparo de um aplicativo para produção.

az spring app set-deployment -d green-deployment -n MyApp -s MyCluster -g MyResourceGroup

Parâmetros Exigidos

--deployment -d

Nome de uma implantação existente do aplicativo.

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--no-wait

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

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 spring app show

Mostre os detalhes de um aplicativo no Azure Spring Apps.

az spring app show --name
                   --resource-group
                   --service

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

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 spring app show-deploy-log

Mostrar log de compilação da última implantação, aplicar apenas à implantação do código-fonte, padrão à implantação de produção.

az spring app show-deploy-log --name
                              --resource-group
                              --service
                              [--deployment]

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--deployment -d

Nome de uma implantação existente do aplicativo. Padrão para a implantação de produção se não for especificado.

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 spring app start

Inicie instâncias do aplicativo, padrão para implantação de produção.

az spring app start --name
                    --resource-group
                    --service
                    [--deployment]
                    [--no-wait]

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--deployment -d

Nome de uma implantação existente do aplicativo. Padrão para a implantação de produção se não for especificado.

--no-wait

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

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 spring app stop

Pare as instâncias do aplicativo, padronize para a implantação de produção.

az spring app stop --name
                   --resource-group
                   --service
                   [--deployment]
                   [--no-wait]

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--deployment -d

Nome de uma implantação existente do aplicativo. Padrão para a implantação de produção se não for especificado.

--no-wait

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

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 spring app unset-deployment

Implantação de produção não definida de um aplicativo.

az spring app unset-deployment --name
                               --resource-group
                               --service
                               [--no-wait]

Exemplos

Troque a implantação de produção de um aplicativo para preparo se o aplicativo tiver a implantação de produção.

az spring app unset-deployment -n MyApp -s MyCluster -g MyResourceGroup

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--no-wait

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

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 spring app update

Atualize as configurações de um aplicativo.

az spring app update --name
                     --resource-group
                     --service
                     [--assign-endpoint {false, true}]
                     [--assign-public-endpoint {false, true}]
                     [--backend-protocol {Default, GRPC}]
                     [--client-auth-certs]
                     [--config-file-patterns]
                     [--custom-actuator-path]
                     [--custom-actuator-port]
                     [--deployment]
                     [--disable-probe {false, true}]
                     [--disable-tea {false, true}]
                     [--enable-ingress-to-app-tls {false, true}]
                     [--enable-liveness-probe {false, true}]
                     [--enable-persistent-storage {false, true}]
                     [--enable-readiness-probe {false, true}]
                     [--enable-startup-probe {false, true}]
                     [--env]
                     [--grace-period]
                     [--https-only {false, true}]
                     [--ingress-read-timeout]
                     [--ingress-send-timeout]
                     [--jvm-options]
                     [--liveness-probe-config]
                     [--loaded-public-certificate-file]
                     [--main-entry]
                     [--no-wait]
                     [--persistent-storage]
                     [--readiness-probe-config]
                     [--runtime-version {Java_11, Java_17, Java_21, Java_8, NetCore_31}]
                     [--secrets]
                     [--session-affinity {Cookie, None}]
                     [--session-max-age]
                     [--startup-probe-config]
                     [--workload-profile]

Exemplos

Adicione uma variável de ambiente para o aplicativo.

az spring app update -n MyApp -s MyCluster -g MyResourceGroup --env foo=bar

Parâmetros Exigidos

--name -n

O nome do aplicativo em execução na instância especificada do Azure Spring Apps.

--resource-group -g

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

--service -s

O nome da instância do Azure Spring Apps, você pode configurar o serviço padrão usando az configure --defaults spring=.

Parâmetros Opcionais

--assign-endpoint

Se true, atribua a URL do ponto de extremidade para acesso direto.

Valores aceitos: false, true
--assign-public-endpoint

Se true, atribua a URL do ponto de extremidade que pode ser acessada fora da rede virtual para o aplicativo de instância de injeção de vnet.

Valores aceitos: false, true
--backend-protocol

Protocolo de back-end de entrada do aplicativo. O padrão significa HTTP/HTTPS/WebSocket.

Valores aceitos: Default, GRPC
--client-auth-certs

Uma cadeia de caracteres separada por espaço que contém IDs de recursos de certificados para autenticação de cliente. por exemplo: --client_auth_certs='id0 id1'. Use '' para limpar os certificados existentes.

--config-file-patterns

(Somente nível Enterprise) Padrões de arquivo de configuração separados por ',' para decidir quais padrões do Serviço de Configuração de Aplicativos serão usados. Use '""' para limpar as configurações existentes.

--custom-actuator-path

(Somente nível Enterprise) Caminho do atuador personalizado para o aplicativo. O padrão é "/actuator".

--custom-actuator-port

(Somente nível Enterprise) Porta do atuador personalizado para o aplicativo. O padrão é 8080.

--deployment -d

Nome de uma implantação existente do aplicativo. Padrão para a implantação de produção se não for especificado.

--disable-probe

Se for verdadeiro, desative a sonda de atividade e preparação.

Valores aceitos: false, true
--disable-tea --disable-test-endpoint-auth

Se true, desabilite a autenticação do ponto de extremidade de teste do aplicativo.

Valores aceitos: false, true
--enable-ingress-to-app-tls

Se true, habilite a entrada para o aplicativo tls.

Valores aceitos: false, true
--enable-liveness-probe
Versão Prévia

Se false, desabilitará a investigação de atividade da instância do aplicativo.

Valores aceitos: false, true
--enable-persistent-storage --enable-ps

Se true, monte um disco de 50G (tipo de preço Standard) ou 1G (tipo de preço básico) com o caminho padrão.

Valores aceitos: false, true
--enable-readiness-probe
Versão Prévia

Se false, desabilitará a investigação de preparação da instância do aplicativo.

Valores aceitos: false, true
--enable-startup-probe
Versão Prévia

Se false, desabilitará a investigação de inicialização da instância do aplicativo.

Valores aceitos: false, true
--env

Variáveis de ambiente separadas por espaço no formato 'key[=value]'.

--grace-period --termination-grace-period-seconds
Versão Prévia

Duração opcional em segundos que a instância do aplicativo precisa encerrar normalmente.

--https-only

Se for verdadeiro, acesse o aplicativo via https.

Valores aceitos: false, true
--ingress-read-timeout

Valor de tempo limite de leitura de entrada em segundos. Padrão 300, mínimo é 1, máximo é 1800.

--ingress-send-timeout

Valor de tempo limite de envio de entrada em segundos. Padrão 60, mínimo é 1, máximo é 1800.

--jvm-options

Uma string contendo opções jvm, use '=' em vez de ' ' para este argumento para evitar erro de análise bash, por exemplo: --jvm-options='-Xms1024m -Xmx2048m'.

--liveness-probe-config
Versão Prévia

Um caminho de arquivo json indica a configuração da sonda de atividade.

--loaded-public-certificate-file -f

Um caminho de arquivo json indica os certificados que seriam carregados no aplicativo.

--main-entry -m

O caminho para o executável do .NET em relação à raiz zip.

--no-wait

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

Valor padrão: False
--persistent-storage

Um caminho de arquivo json para os armazenamentos persistentes a serem montados no aplicativo.

--readiness-probe-config
Versão Prévia

Um caminho de arquivo json indica a configuração da sonda de preparação.

--runtime-version

Versão de tempo de execução da linguagem usada.

Valores aceitos: Java_11, Java_17, Java_21, Java_8, NetCore_31
--secrets

Uma lista de segredos para o aplicativo. Formate "key[=value]" e separado por espaço.

--session-affinity

Afinidade de sessão de entrada do aplicativo.

Valores aceitos: Cookie, None
--session-max-age

Tempo até que o cookie expire. O mínimo é de 1 segundo, o máximo é de 7 dias. Se definido como 0, o período de expiração será igual ao período da sessão do navegador.

--startup-probe-config
Versão Prévia

Um caminho de arquivo json indica a configuração da sonda de inicialização.

--workload-profile

O perfil de carga de trabalho usado no ambiente gerenciado. O padrão é "Consumo".

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.