Compartilhar via

az spring app deployment

  • 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 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 <staging deployment>.

Comandos

Nome Description Tipo Status
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 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>.

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

Implante o código-fonte em uma nova implantação de um aplicativo. Isso empacotará o diretório atual, criará 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 predefinido 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

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

az spring app deployment create -n green-deployment --app 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 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=<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-env

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

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

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

--instance-count

Número de instância.

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

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

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

--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á 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 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=<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 deployment generate-heap-dump

Gere um despejo de heap 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 de 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=<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 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 de 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=<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 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=<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 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=<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 deployment start-jfr

Inicie um JFR em sua instância de 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 de 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=<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.

--duration

Duração do JFR.

Valor padrão: 60s
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.