az spring app deployment

  • Referência

Nota

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

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

Comandos

Name Description Tipo Estado
az spring app deployment create

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

 Extensão GA
az spring app deployment delete

Exclua uma implantação do aplicativo.

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

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

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

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

 Extensão GA
az spring app deployment list

Liste todas as implantações em um aplicativo.

 Extensão GA
az spring app deployment show

Mostrar detalhes de uma implantação.

 Extensão GA
az spring app deployment start-jfr

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

 Extensão GA

az spring app deployment create

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

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, compilará 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 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

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

--app

Nome do aplicativo.

--name -n

Nome da implantação.

--resource-group -g

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

--service -s

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

Parâmetros Opcionais

--apms

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

--artifact-path

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

--build-certificates

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

--build-env

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

--builder

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

valor predefinido: default
--config-file-patterns

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

--container-args

Os argumentos da imagem do contêiner.

--container-command

O comando da imagem do contêiner.

--container-image

A tag de imagem do contêiner.

--container-registry

O registro da imagem do contêiner.

valor predefinido: 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 nível Enterprise) Caminho do atuador personalizado para o aplicativo. Padrão para "/atuator".

--custom-actuator-port

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

--disable-app-log

Não imprima logs de aplicativos ao implantar aplicativos.

valor predefinido: False
--disable-probe

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

valores aceites: false, true
--disable-validation

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

valores aceites: false, true
--enable-liveness-probe
Pré-visualizar

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

valores aceites: false, true
--enable-readiness-probe
Pré-visualizar

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

valores aceites: false, true
--enable-startup-probe
Pré-visualizar

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

valores aceites: false, true
--env

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

--grace-period --termination-grace-period-seconds
Pré-visualizar

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

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

--liveness-probe-config
Pré-visualizar

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

--main-entry -m

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

--max-replicas

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

valor predefinido: 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 predefinido: 1
--no-wait

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

valor predefinido: False
--readiness-probe-config
Pré-visualizar

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

--registry-password

A senha do registro do contêiner.

--registry-username

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

--runtime-version

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

valores aceites: Java_11, Java_17, Java_21, Java_8, NetCore_31
--scale-rule-auth --sra

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

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

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

--scale-rule-metadata --srm

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

--scale-rule-name --srn

O nome da regra de escala.

--scale-rule-type --srt

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

--server-version

(Apenas níveis Standard e Basic) Versão do servidor Tomcat. Liste todas as versões de servidor suportadas executando az spring list-support-server-versions -o tableo . Esta funcionalidade está em pré-visualização pública.

--skip-clone-settings

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

valor predefinido: False
--source-path

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

--startup-probe-config
Pré-visualizar

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

--target-module

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

--version

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az spring app deployment delete

Exclua uma implantação do aplicativo.

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

Parâmetros Obrigatórios

--app

Nome do aplicativo.

--name -n

Nome da implantação.

--resource-group -g

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

--service -s

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

Parâmetros Opcionais

--no-wait

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

valor predefinido: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az spring app deployment generate-heap-dump

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

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

Parâmetros Obrigatórios

--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 seu arquivo de despejo.

--resource-group -g

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

--service -s

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

Parâmetros Opcionais

--deployment -d

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az spring app deployment generate-thread-dump

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

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

Parâmetros Obrigatórios

--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 seu arquivo de despejo.

--resource-group -g

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

--service -s

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

Parâmetros Opcionais

--deployment -d

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az spring app deployment list

Liste todas as implantações em um aplicativo.

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

Parâmetros Obrigatórios

--app

Nome do aplicativo.

--resource-group -g

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

--service -s

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az spring app deployment show

Mostrar detalhes de uma implantação.

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

Parâmetros Obrigatórios

--app

Nome do aplicativo.

--name -n

Nome da implantação.

--resource-group -g

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

--service -s

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az spring app deployment start-jfr

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

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

Parâmetros Obrigatórios

--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 seu arquivo de despejo.

--resource-group -g

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

--service -s

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

Parâmetros Opcionais

--deployment -d

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

--duration

Duração do JFR.

valor predefinido: 60s
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.