Compartilhar via

az spring app

  • Referência

Nota

Essa referência faz parte da extensão spring para a CLI do Azure (versão 2.56.0 ou superior). A extensão instalará 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 Deprecado
az spring app binding cosmos

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

 Extensão Deprecado
az spring app binding cosmos add

Associe um Azure Cosmos DB ao aplicativo.

 Extensão Deprecado
az spring app binding cosmos update

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

 Extensão Deprecado
az spring app binding list

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

 Extensão Deprecado
az spring app binding mysql

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

 Extensão Deprecado
az spring app binding mysql add

Associe um Banco de Dados do Azure para MySQL com o aplicativo.

 Extensão Deprecado
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 Deprecado
az spring app binding redis

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

 Extensão Deprecado
az spring app binding redis add

Associe um Cache do Azure para Redis com o aplicativo.

 Extensão Deprecado
az spring app binding redis update

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

 Extensão Deprecado
az spring app binding remove

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

 Extensão Deprecado
az spring app binding show

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

 Extensão Deprecado
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

Desvinme 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

Excluir 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 de 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 <staging deployment>.

 Extensão GA
az spring app deployment create

Crie uma implantação de preparo para o aplicativo. Para implantar o código ou a 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 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 determinado caminho de arquivo.

 Extensão GA
az spring app deployment list

Listar 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 em sua instância de aplicativo de destino para determinado caminho de arquivo.

 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

Force 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

Exibir 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 executar logs de instâncias de aplicativo com várias opções. Se o aplicativo tiver apenas uma instância, o nome da instância será opcional.

 Extensão Deprecado
az spring app log tail

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

 Extensão Deprecado
az spring app logs

Mostrar logs de uma instância de 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 o log de build da última implantação, aplicar somente à 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

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

 Extensão GA
az spring app unset-deployment

Desvinme a implantação de produção 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 acrescentado.

--load-trust-store

Se for true, o certificado será carregado no repositório de confiança 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=<name>.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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 do armazenamento persistente volumedo.

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

--storage-name

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

Parâmetros Opcionais

--enable-sub-path

[opcional] Se for true, montará 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 for true, o volume de armazenamento persistente será somente leitura.

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

O nome do compartilhamento de arquivo pré-criado. O ShareName só deverá ser fornecido se o tipo do volume de armazenamento persistente for AzureFileVolume.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. 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 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=<name>.

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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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-identity {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 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 Aplicativo e o Servidor de Configuração do Spring Cloud.

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

Parâmetros Opcionais

--assign-endpoint

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

Valores aceitos: false, true
Valor padrão: False
--assign-identity
Preterido

A opção '--assign-identity' foi preterida e será removida em uma versão futura. Em vez disso, use '--atribuído pelo sistema'.

Habilite a identidade gerenciada atribuída pelo sistema.

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

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

Associe o aplicativo ao servidor de configuração padrão automaticamente.

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

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

Valor padrão: default
--disable-probe

Se for verdade, desabilite a investigação de vida e preparação.

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

Se for 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 for false, desabilite a investigação de atividade da instância do aplicativo.

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

Se for true, monte um disco de 50G (tipo de preço padrão) 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 for falso, desabilite a investigação de preparação da instância do aplicativo.

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

Se for falso, desabilite 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 terminar 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

A entrada envia o valor do tempo limite em segundos. Padrão 60, mínimo é 1, máximo é 1800.

--instance-count

Número de instância.

Valor padrão: 1
--jvm-options

Uma cadeia de caracteres que contém opções de jvm, use '=' em vez de ' para esse argumento para evitar o 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 de investigação de dinâmica.

--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 que os armazenamentos persistentes sejam montados no aplicativo.

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

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

--runtime-version

Versão de runtime do idioma usado.

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. Formatar <triggerParameter>=<secretRef> 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 de escalar horizontalmente. Há suporte apenas para regras de escala http e tcp.

--scale-rule-metadata --srm

Metadados de regra de escala. 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

Hora 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 de sessão do navegador.

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

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

--system-assigned

Habilite 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 pelo espaço para assginar em um aplicativo.

--workload-profile

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az spring app delete

Excluir 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=<name>.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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, criará 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 predefinido em um aplicativo com opções de 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

Implantar uma guerra pré-criada em um aplicativo com a versão do servidor, opções de 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

Implantar uma imagem de contêiner no Hub do Docker 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 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=<name>.

Parâmetros Opcionais

--apms

(Somente camada da empresa) Nomes do APM separados por espaço.

--artifact-path

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

--build-certificates

(Somente camada da empresa) Nomes de certificado separados por espaço, os certificados são usados durante o tempo de build.

--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 camada da empresa) Compilar o construtor de serviços usado para criar o executável.

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

(Somente camada da empresa) Padrões de arquivo de configuração separados com ',' 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 de contêiner.

--container-command

O comando da imagem de contêiner.

--container-image

A marca de imagem do contêiner.

--container-registry

O registro da imagem do contêiner.

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

(Somente camada da empresa) Caminho do atuador personalizado para o aplicativo. Padrão para "/actuator".

--custom-actuator-port

(Somente camada da empresa) Porta do atuador personalizado para o aplicativo. Padrão para 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 aplicativo ao implantar o aplicativo.

Valor padrão: False
--disable-probe

Se for verdade, desabilite a investigação de vida e preparação.

Valores aceitos: false, true
--disable-validation

Se for true, desabilite a validação jar.

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

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

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

Se for falso, desabilite a investigação de preparação da instância do aplicativo.

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

Se for falso, desabilite 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 terminar normalmente.

--jvm-options

Uma cadeia de caracteres que contém opções de jvm, use '=' em vez de ' para esse argumento para evitar o erro de análise bash, por exemplo: --jvm-options='-Xms1024m -Xmx2048m'.

--language-framework

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

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

Um caminho de arquivo json indica a configuração de investigação de dinâmica.

--main-entry -m

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

--no-wait

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

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

Um caminho de arquivo json indica a configuração de investigação 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 runtime do idioma usado.

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

(Somente camadas padrão e básica) Versão do servidor Tomcat. Listar todas as versões de servidor com suporte executando az spring list-support-server-versions -o table. Esse recurso está em versão prévia pública.

--source-path

Implante a pasta de origem especificada. A pasta será empacotada em tar, carregada e criada usando kpack. Padrão para 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 investigação 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 da implantação, mantenha-se inalterada se não estiver definida.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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=<name>.

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

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

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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=<name>.

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

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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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=<name>.

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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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

Consultar o status 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=<name>.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az spring app logs

Mostrar logs de uma instância de 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=<name>.

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 logs JSON se o log estruturado estiver habilitado.

--instance -i

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

--limit

Máximo de quilobytes 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

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. 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 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=<name>.

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

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

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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

Escalar 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

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

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

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

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

Parâmetros de autenticação de regra de escala. Formatar <triggerParameter>=<secretRef> 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 de escalar horizontalmente. Há suporte apenas para regras de escala http e tcp.

--scale-rule-metadata --srm

Metadados de regra de escala. 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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

Alterne 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=<name>.

Parâmetros Opcionais

--no-wait

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

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

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. 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 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=<name>.

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az spring app show-deploy-log

Mostrar o log de build da última implantação, aplicar somente à 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=<name>.

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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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=<name>.

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

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

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az spring app stop

Interrompa 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 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=<name>.

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

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

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az spring app unset-deployment

Desvinme 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 para o 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=<name>.

Parâmetros Opcionais

--no-wait

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

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

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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=<name>.

Parâmetros Opcionais

--assign-endpoint

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

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

Se for 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. 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 certificados existentes.

--config-file-patterns

(Somente camada da empresa) Padrões de arquivo de configuração separados com ',' para decidir quais padrões do Serviço de Configuração de Aplicativo serão usados. Use '""' para limpar as configurações existentes.

--custom-actuator-path

(Somente camada da empresa) Caminho do atuador personalizado para o aplicativo. Padrão para "/actuator".

--custom-actuator-port

(Somente camada da empresa) Porta do atuador personalizado para o aplicativo. Padrão para 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 verdade, desabilite a investigação de vida e preparação.

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

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

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

Se for true, habilite a entrada para tls de aplicativo.

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

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

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

Se for true, monte um disco de 50G (tipo de preço padrão) 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 for falso, desabilite a investigação de preparação da instância do aplicativo.

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

Se for falso, desabilite 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 terminar normalmente.

--https-only

Se for true, acesse o aplicativo por meio de 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

A entrada envia o valor do tempo limite em segundos. Padrão 60, mínimo é 1, máximo é 1800.

--jvm-options

Uma cadeia de caracteres que contém opções de jvm, use '=' em vez de ' para esse argumento para evitar o 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 de investigação de dinâmica.

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

Valor padrão: False
--persistent-storage

Um caminho de arquivo json para que os armazenamentos persistentes sejam montados no aplicativo.

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

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

--runtime-version

Versão de runtime do idioma usado.

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

Hora 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 de sessão do navegador.

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

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

--workload-profile

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.