Partilhar via


az spring app deployment

Observação

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

Este grupo de comandos foi implicitamente preterido porque o grupo de comandos 'spring' foi preterido e será removido em uma versão futura.

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

Comandos

Name Description Tipo Status
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 Deprecated
az spring app deployment delete

Exclua uma implantação do aplicativo.

Extensão Deprecated
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 Deprecated
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 Deprecated
az spring app deployment list

Liste todas as implantações em um aplicativo.

Extensão Deprecated
az spring app deployment show

Mostrar detalhes de uma implantação.

Extensão Deprecated
az spring app deployment start-jfr

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

Extensão Deprecated

az spring app deployment create

Preterido

Este comando é implicitamente preterido porque o grupo de comandos 'spring' foi preterido e será removido em uma versão futura.

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 --termination-grace-period-seconds]
                                [--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 --sra]
                                [--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc]
                                [--scale-rule-metadata --srm]
                                [--scale-rule-name --srn]
                                [--scale-rule-type --srt]
                                [--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

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Default value: default
--config-file-patterns

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

--container-args

Os argumentos da imagem do contêiner.

Propriedade Valor
Grupo de parâmetros: Custom Container Arguments
--container-command

O comando da imagem do contêiner.

Propriedade Valor
Grupo de parâmetros: Custom Container Arguments
--container-image

A tag de imagem do contêiner.

Propriedade Valor
Grupo de parâmetros: Custom Container Arguments
--container-registry

O registro da imagem do contêiner.

Propriedade Valor
Grupo de parâmetros: Custom Container Arguments
Default value: 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.

Propriedade Valor
Default value: False
--disable-probe

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

Propriedade Valor
Valores aceites: false, true
--disable-validation

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

Propriedade Valor
Valores aceites: false, true
--enable-liveness-probe
Pré-visualizar

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

Propriedade Valor
Grupo de parâmetros: App Customization Arguments
Valores aceites: false, true
--enable-readiness-probe
Pré-visualizar

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

Propriedade Valor
Grupo de parâmetros: App Customization Arguments
Valores aceites: false, true
--enable-startup-probe
Pré-visualizar

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

Propriedade Valor
Grupo de parâmetros: App Customization Arguments
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.

Propriedade Valor
Grupo de parâmetros: App Customization Arguments
--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", "".

Propriedade Valor
Grupo de parâmetros: Custom Container Arguments
--liveness-probe-config
Pré-visualizar

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

Propriedade Valor
Grupo de parâmetros: App Customization Arguments
--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.

Propriedade Valor
Grupo de parâmetros: StandardGen2 Arguments
Default value: 10
--memory

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

--min-replicas

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

Propriedade Valor
Grupo de parâmetros: StandardGen2 Arguments
Default value: 1
--no-wait

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

Propriedade Valor
Default value: False
--readiness-probe-config
Pré-visualizar

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

Propriedade Valor
Grupo de parâmetros: App Customization Arguments
--registry-password

A senha do registro do contêiner.

Propriedade Valor
Grupo de parâmetros: Custom Container Arguments
--registry-username

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

Propriedade Valor
Grupo de parâmetros: Custom Container Arguments
--runtime-version

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

Propriedade Valor
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. Formatar <triggerParameter>=<secretRef> e separados por espaço.

Propriedade Valor
Grupo de parâmetros: StandardGen2 Arguments
--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.

Propriedade Valor
Grupo de parâmetros: StandardGen2 Arguments
--scale-rule-metadata --srm

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

Propriedade Valor
Grupo de parâmetros: StandardGen2 Arguments
--scale-rule-name --srn

O nome da regra de escala.

Propriedade Valor
Grupo de parâmetros: StandardGen2 Arguments
--scale-rule-type --srt

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

Propriedade Valor
Grupo de parâmetros: StandardGen2 Arguments
--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 table. Este recurso 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.

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

Propriedade Valor
Grupo de parâmetros: Source Code deploy Arguments
--startup-probe-config
Pré-visualizar

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

Propriedade Valor
Grupo de parâmetros: App Customization Arguments
--target-module

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

Propriedade Valor
Grupo de parâmetros: Source Code deploy Arguments
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az spring app deployment delete

Preterido

Este comando é implicitamente preterido porque o grupo de comandos 'spring' foi preterido e será removido em uma versão futura.

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

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--no-wait

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

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az spring app deployment generate-heap-dump

Preterido

Este comando é implicitamente preterido porque o grupo de comandos 'spring' foi preterido e será removido em uma versão futura.

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

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az spring app deployment generate-thread-dump

Preterido

Este comando é implicitamente preterido porque o grupo de comandos 'spring' foi preterido e será removido em uma versão futura.

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

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az spring app deployment list

Preterido

Este comando é implicitamente preterido porque o grupo de comandos 'spring' foi preterido e será removido em uma versão futura.

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

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az spring app deployment show

Preterido

Este comando é implicitamente preterido porque o grupo de comandos 'spring' foi preterido e será removido em uma versão futura.

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

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az spring app deployment start-jfr

Preterido

Este comando é implicitamente preterido porque o grupo de comandos 'spring' foi preterido e será removido em uma versão futura.

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

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Default value: 60s
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False