az spring app deployment

Observação

Essa referência faz parte da extensão de mola 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 deployment . Saiba mais sobre extensões.

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 .

Comandos

Nome Description Tipo Status
az spring app deployment create

Crie uma implantação de preparo para o aplicativo. Para implantar código ou atualizar a configuraçã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 pilha 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 na instância do aplicativo de destino para determinado caminho de arquivo.

Extensão GA

az spring app deployment create

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

az spring app deployment create --app
                                --name
                                --resource-group
                                --service
                                [--apms]
                                [--artifact-path]
                                [--build-certificates]
                                [--build-env]
                                [--builder]
                                [--config-file-patterns]
                                [--container-args]
                                [--container-command]
                                [--container-image]
                                [--container-registry]
                                [--cpu]
                                [--custom-actuator-path]
                                [--custom-actuator-port]
                                [--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]
                                [--instance-count]
                                [--jvm-options]
                                [--language-framework]
                                [--liveness-probe-config]
                                [--main-entry]
                                [--max-replicas]
                                [--memory]
                                [--min-replicas]
                                [--no-wait]
                                [--readiness-probe-config]
                                [--registry-password]
                                [--registry-username]
                                [--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]
                                [--server-version]
                                [--skip-clone-settings]
                                [--source-path]
                                [--startup-probe-config]
                                [--target-module]
                                [--version]

Exemplos

Implantar o código-fonte em uma nova implantação de um aplicativo. Isso empacotará o diretório atual, compilará o binário com o Pivotal Build Service e, em seguida, implantará.

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

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

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

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

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

Implantar uma imagem de contêiner em um registro particular em um aplicativo.

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

Parâmetros Exigidos

--app

Nome do aplicativo.

--name -n

Nome da implantação.

--resource-group -g

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

--service -s

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

Parâmetros Opcionais

--apms

(Somente camada Enterprise) Nomes APM separados por espaço.

--artifact-path

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

--build-certificates

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

--build-env

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

--builder

(Somente camada Enterprise) Construtor de serviços de compilação usado para compilar o executável.

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

(Somente camada 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.

valor padrão: docker.io
--cpu

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

--custom-actuator-path

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

--custom-actuator-port

(Somente camada Enterprise) Porta do atuador personalizada para o aplicativo. O padrão é 8080.

--disable-app-log

Não imprima logs de aplicativo ao implantar o aplicativo.

valor padrão: False
--disable-probe

Se for verdade, desative o teste de disponibilidade e prontidão.

valores aceitos: false, true
--disable-validation

Se true, desative a validação jar.

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

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

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

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

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

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

valores aceitos: false, true
--env

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

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

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

--instance-count

Número de instâncias.

--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 idioma da imagem de contêiner carregada. Valores suportados: "springboot", "".

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

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

--main-entry -m

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

--max-replicas

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

valor padrão: 10
--memory

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

--min-replicas

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

valor padrão: 1
--no-wait

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

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

Um caminho de arquivo json indica a configuração do teste 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 aceitos: Java_11, Java_17, Java_21, Java_8, NetCore_31
--scale-rule-auth --sra

Parâmetros de autenticação de regra de escala. Formato "=" 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 do dimensionamento. 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.

--server-version

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

--skip-clone-settings

Criar implantação de preparo copiará automaticamente as configurações da implantação de produção.

valor padrão: False
--source-path

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

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

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

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

--verbose

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

az spring app deployment delete

Exclua uma implantação do aplicativo.

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

Parâmetros Exigidos

--app

Nome do aplicativo.

--name -n

Nome da implantação.

--resource-group -g

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

--service -s

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

Parâmetros Opcionais

--no-wait

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

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

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

--verbose

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

az spring app deployment generate-heap-dump

Gere um despejo de pilha da instância do aplicativo de destino para determinado caminho de arquivo.

az spring app deployment generate-heap-dump --app
                                            --app-instance
                                            --file-path
                                            --resource-group
                                            --service
                                            [--deployment]

Parâmetros Exigidos

--app

Nome do aplicativo.

--app-instance

Instância do aplicativo de destino que você deseja despejar.

--file-path

O caminho do arquivo de montagem para o arquivo de despejo.

--resource-group -g

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

--service -s

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

Parâmetros Opcionais

--deployment -d

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

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

--verbose

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

az spring app deployment generate-thread-dump

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

az spring app deployment generate-thread-dump --app
                                              --app-instance
                                              --file-path
                                              --resource-group
                                              --service
                                              [--deployment]

Parâmetros Exigidos

--app

Nome do aplicativo.

--app-instance

Instância do aplicativo de destino que você deseja despejar.

--file-path

O caminho do arquivo de montagem para o arquivo de despejo.

--resource-group -g

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

--service -s

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

Parâmetros Opcionais

--deployment -d

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

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

--verbose

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

az spring app deployment list

Listar todas as implantações em um aplicativo.

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

Parâmetros Exigidos

--app

Nome do aplicativo.

--resource-group -g

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

--service -s

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

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

--verbose

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

az spring app deployment show

Mostrar detalhes de uma implantação.

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

Parâmetros Exigidos

--app

Nome do aplicativo.

--name -n

Nome da implantação.

--resource-group -g

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

--service -s

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

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

--verbose

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

az spring app deployment start-jfr

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

az spring app deployment start-jfr --app
                                   --app-instance
                                   --file-path
                                   --resource-group
                                   --service
                                   [--deployment]
                                   [--duration]

Parâmetros Exigidos

--app

Nome do aplicativo.

--app-instance

Instância do aplicativo de destino que você deseja despejar.

--file-path

O caminho do arquivo de montagem para o arquivo de despejo.

--resource-group -g

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

--service -s

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

Parâmetros Opcionais

--deployment -d

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

--duration

Duração do JFR.

valor padrão: 60s
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

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

--verbose

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