az spring app

Referência

Nota

Essa referência faz parte da extensão de primavera 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

Name	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	Anexe 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 fazer com 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	Associe um Azure Cosmos DB ao aplicativo.	Extensão	Preterido
az spring app binding cosmos update	Atualizar uma associação de serviço do Azure Cosmos DB do aplicativo.	Extensão	Preterido
az spring app binding list	Liste todas as associações de serviço em um aplicativo.	Extensão	Preterido
az spring app binding mysql	Comandos para gerenciar o Banco de Dados do Azure para associações 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 um Banco de Dados do Azure para associação de serviço MySQL do aplicativo.	Extensão	Preterido
az spring app binding redis	Comandos para gerenciar o Cache do Azure para associações Redis.	Extensão	Preterido
az spring app binding redis add	Associe um Cache Redis do Azure ao aplicativo.	Extensão	Preterido
az spring app binding redis update	Atualizar 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	Mostrar 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 de 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	Desvincule 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 configuração de atualização em uma implantação existente, use `az spring app deploy/update --deployment <staging deployment>`.	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 um determinado caminho de arquivo.	Extensão	GA
az spring app deployment generate-thread-dump	Gere um despejo de thread da instância do aplicativo de destino para um determinado caminho de arquivo.	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 um determinado caminho de arquivo.	Extensão	GA
az spring app disable-remote-debugging	Desative 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	Gerencie as identidades gerenciadas de um aplicativo.	Extensão	GA
az spring app identity assign	Habilite a identidade gerenciada atribuída ao 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 gerenciadas 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 gerar logs de instâncias de aplicativos 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 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	Mostrar 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 somente à implantação do código-fonte, padrão para a 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 instâncias do aplicativo, padrão para implantação de produção.	Extensão	GA
az spring app unset-deployment	Desdefinir a implantação de produção de um aplicativo.	Extensão	GA
az spring app update	Atualizar 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

Anexe 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 Obrigatórios

--certificate-name

Nome do certificado a anexar.

--load-trust-store

Se verdadeiro, o certificado seria carregado no armazenamento confiável para aplicativos Java.

Valores aceites: false, true

Default value: False

--name -n

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

--resource-group -g

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

Anexe 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

Anexe 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 Obrigatórios

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

o 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 verdadeiro, será montado em subdiretórios separados com o mesmo caminho para cada instância do aplicativo.

Valores aceites: false, true

Default value: False

--mount-options

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

--read-only

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

Valores aceites: false, true

Default value: 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 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 spring app connect

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

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

Parâmetros Obrigatórios

--name -n

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

--resource-group -g

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

--instance -i

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

--shell-cmd

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

Default value: /bin/sh

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 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 ao Registro de Serviço padrão, ao Serviço de Configuração de Aplicativo e ao 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 Obrigatórios

--name -n

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

--resource-group -g

o 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 verdadeiro, atribua URL do ponto de extremidade para acesso direto.

Valores aceites: false, true

Default value: False

--assign-public-endpoint

Se verdadeiro, 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 aceites: false, true

--backend-protocol

Ingresso no protocolo de back-end do aplicativo. Padrão significa HTTP/HTTPS/WebSocket.

Valores aceites: Default, GRPC

--bind-acs --bind-application-configuration-service

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

Default value: default

--disable-probe

Se verdadeiro, desative a sonda de vivacidade e prontidão.

Valores aceites: false, true

--disable-tea --disable-test-endpoint-auth

Se verdadeiro, desative a autenticação do ponto de extremidade de teste do aplicativo.

Valores aceites: false, true

Default value: False

--enable-liveness-probe

Pré-visualizar

Se false, desativará o teste de vivacidade da instância do aplicativo.

Valores aceites: false, true

--enable-persistent-storage --enable-ps

Se verdadeiro, monte um disco 50G (nível de preço padrão) ou 1G (nível de preço básico) com o caminho padrão.

Valores aceites: false, true

--enable-readiness-probe

Pré-visualizar

Se false, desativará o teste de prontidão da instância do aplicativo.

Valores aceites: false, true

--enable-startup-probe

Pré-visualizar

Se false, desativará o teste de inicialização da instância do aplicativo.

Valores aceites: false, true

--env

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

--grace-period --termination-grace-period-seconds

Pré-visualizar

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

--ingress-read-timeout

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

--ingress-send-timeout

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

--instance-count

Número de instâncias.

Default value: 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

Pré-visualizar

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

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

Default value: 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.

Default value: 1

--persistent-storage

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

--readiness-probe-config

Pré-visualizar

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

--runtime-version

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

Valores aceites: Java_11, Java_17, Java_21, Java_8, NetCore_31

--scale-rule-auth --sra

Parâmetros de autenticação da 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. Apenas suportado para regras de escala http e tcp.

--scale-rule-metadata --srm

Dimensionar metadados da 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 segredo(s) para o aplicativo. Formate "key[=value]" e separado por espaço.

--session-affinity

Afinidade de sessão de ingresso do aplicativo.

Valores aceites: Cookie, None

--session-max-age

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

--startup-probe-config

Pré-visualizar

Um caminho de arquivo json indica a configuração do teste de inicialização.

--system-assigned

Habilite a identidade gerenciada atribuída ao sistema.

Valores aceites: false, true

--user-assigned

Pré-visualizar

IDs de recursos de identidade gerenciados atribuídos pelo usuário separados por espaço para assgin em um aplicativo.

--workload-profile

O perfil de carga de trabalho usado no ambiente gerenciado. Padrão para "Consumo".

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

Exclua um aplicativo no Azure Spring Apps.

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

Parâmetros Obrigatórios

--name -n

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

--resource-group -g

o 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 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 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á 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é-criado 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 uma guerra pré-criada em um aplicativo com versão do servidor, opções da 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 Aplicativo 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 Obrigatórios

--name -n

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

--resource-group -g

o 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 APM separados por espaço.

--artifact-path

Implante o artefato pré-construído especificado (jar, war ou netcore zip, war is in public preview).

--build-certificates

(Somente nível Enterprise) Nomes de certificados 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.

Default value: 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.

Default value: 2Gi

--builder

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

Default value: 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 Aplicativo 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 do contêiner.

Default value: docker.io

--custom-actuator-path

(Somente nível Enterprise) Caminho do atuador personalizado para o aplicativo. Padrão para "/atuator".

--custom-actuator-port

(Somente nível Enterprise) Porta de atuador personalizada 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 especificado.

--disable-app-log

Não imprima logs de aplicativos ao implantar aplicativos.

Default value: False

--disable-probe

Se verdadeiro, desative a sonda de vivacidade e prontidão.

Valores aceites: false, true

--disable-validation

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

Valores aceites: false, true

--enable-liveness-probe

Pré-visualizar

Se false, desativará o teste de vivacidade da instância do aplicativo.

Valores aceites: false, true

--enable-readiness-probe

Pré-visualizar

Se false, desativará o teste de prontidão da instância do aplicativo.

Valores aceites: false, true

--enable-startup-probe

Pré-visualizar

Se false, desativará o teste de inicialização da instância do aplicativo.

Valores aceites: false, true

--env

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

--grace-period --termination-grace-period-seconds

Pré-visualizar

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

Pré-visualizar

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

--main-entry -m

Uma cadeia de caracteres que contém o caminho para o executável .NET relativo à raiz zip.

--no-wait

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

Default value: False

--readiness-probe-config

Pré-visualizar

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

--registry-password

A senha do registro do contêiner.

--registry-username

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

--runtime-version

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

Valores aceites: Java_11, Java_17, Java_21, Java_8, NetCore_31

--server-version

(Apenas 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 . Esta funcionalidade está em pré-visualização pública.

--source-path

Implante a pasta de origem especificada. A pasta será embalada em tar, carregada e construída usando kpack. Padrão para a pasta atual se nenhum valor fornecido.

--startup-probe-config

Pré-visualizar

Um caminho de arquivo json indica a configuração do teste de inicialização.

--target-module

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

--version

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

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

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

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

Parâmetros Obrigatórios

--name -n

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

--resource-group -g

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

--no-wait

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

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 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 Obrigatórios

--name -n

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

--resource-group -g

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

--no-wait

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

Default value: False

--port -p

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

Default value: 5005

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 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 Obrigatórios

--name -n

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

--resource-group -g

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

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 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 Obrigatórios

--resource-group -g

o 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 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 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 Obrigatórios

--name -n

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

--resource-group -g

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

--follow -f

Especifique se os logs devem ser transmitidos.

Default value: False

--format-json

Formate 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 máximo é 2048.

Default value: 2048

--lines

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

Default value: 50

--since

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

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

Reinicie 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 Obrigatórios

--name -n

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

--resource-group -g

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

--no-wait

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

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

Aumente a escala de 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

Dimensione 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 Obrigatórios

--name -n

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

--resource-group -g

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

--instance-count

Número de instâncias.

--max-replicas

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

Default value: 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.

Default value: 1

--no-wait

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

Default value: False

--scale-rule-auth --sra

Parâmetros de autenticação da 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. Apenas suportado para regras de escala http e tcp.

--scale-rule-metadata --srm

Dimensionar metadados da 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 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 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 a produção.

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

Parâmetros Obrigatórios

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

o 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 espere que a operação de longa duração termine.

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

Mostrar os detalhes de um aplicativo no Azure Spring Apps.

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

Parâmetros Obrigatórios

--name -n

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

--resource-group -g

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

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

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

Parâmetros Obrigatórios

--name -n

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

--resource-group -g

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

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 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 Obrigatórios

--name -n

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

--resource-group -g

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

--no-wait

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

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

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

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

Parâmetros Obrigatórios

--name -n

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

--resource-group -g

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

--no-wait

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

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

Desdefinir a implantação de produção 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 por preparo se o aplicativo tiver a implantação de produção.

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

Parâmetros Obrigatórios

--name -n

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

--resource-group -g

o 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 espere que a operação de longa duração termine.

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

Atualizar 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 Obrigatórios

--name -n

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

--resource-group -g

o 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 verdadeiro, atribua URL do ponto de extremidade para acesso direto.

Valores aceites: false, true

--assign-public-endpoint

Se verdadeiro, 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 aceites: false, true

--backend-protocol

Ingresso no protocolo de back-end do aplicativo. Padrão significa HTTP/HTTPS/WebSocket.

Valores aceites: Default, GRPC

--client-auth-certs

--config-file-patterns

--custom-actuator-path

(Somente nível Enterprise) Caminho do atuador personalizado para o aplicativo. Padrão para "/atuator".

--custom-actuator-port

(Somente nível Enterprise) Porta de atuador personalizada 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 especificado.

--disable-probe

Se verdadeiro, desative a sonda de vivacidade e prontidão.

Valores aceites: false, true

--disable-tea --disable-test-endpoint-auth

Se verdadeiro, desative a autenticação do ponto de extremidade de teste do aplicativo.

Valores aceites: false, true

--enable-ingress-to-app-tls

Se verdadeiro, habilite a entrada no aplicativo tls.

Valores aceites: false, true

--enable-liveness-probe

Pré-visualizar

Se false, desativará o teste de vivacidade da instância do aplicativo.

Valores aceites: false, true

--enable-persistent-storage --enable-ps

Se verdadeiro, monte um disco 50G (nível de preço padrão) ou 1G (nível de preço básico) com o caminho padrão.

Valores aceites: false, true

--enable-readiness-probe

Pré-visualizar

Se false, desativará o teste de prontidão da instância do aplicativo.

Valores aceites: false, true

--enable-startup-probe

Pré-visualizar

Se false, desativará o teste de inicialização da instância do aplicativo.

Valores aceites: false, true

--env

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

--grace-period --termination-grace-period-seconds

Pré-visualizar

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

--https-only

Se verdadeiro, acesse o aplicativo via https.

Valores aceites: false, true

--ingress-read-timeout

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

--ingress-send-timeout

Valor de tempo limite de envio de ingresso 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

Pré-visualizar

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

--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 .NET relativo à raiz zip.

--no-wait

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

Default value: False

--persistent-storage

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

--readiness-probe-config

Pré-visualizar

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

--runtime-version

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

Valores aceites: Java_11, Java_17, Java_21, Java_8, NetCore_31

--secrets

Uma lista de segredo(s) para o aplicativo. Formate "key[=value]" e separado por espaço.

--session-affinity

Afinidade de sessão de ingresso do aplicativo.

Valores aceites: Cookie, None

--session-max-age

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

--startup-probe-config

Pré-visualizar

Um caminho de arquivo json indica a configuração do teste de inicialização.

--workload-profile

O perfil de carga de trabalho usado no ambiente gerenciado. Padrão para "Consumo".

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.

Partilhar via

az spring app

Comandos

az spring app append-loaded-public-certificate

Exemplos

Parâmetros Obrigatórios

az spring app append-persistent-storage

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app connect

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app create

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app delete

Parâmetros Obrigatórios

az spring app deploy

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app disable-remote-debugging

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app enable-remote-debugging

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app get-remote-debugging-config

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app list

Exemplos

Parâmetros Obrigatórios

az spring app logs

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app restart

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app scale

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app set-deployment

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app show

Parâmetros Obrigatórios

az spring app show-deploy-log

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app start

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app stop

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app unset-deployment

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az spring app update

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

Recursos adicionais