Compartilhar 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 instalará automaticamente na primeira vez que você executar um comando az spring app deployment. Saiba mais sobre extensões.

Esse grupo de comandos foi substituído implicitamente 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

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 para uma implantação existente, use az spring app deploy/update --deployment <staging deployment>o .

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 o caminho do arquivo especificado.

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

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

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 o caminho do arquivo especificado.

Extensão Deprecated

az spring app deployment create

Preterido

Esse comando foi substituído implicitamente 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 atualizar a configuração para uma implantação existente, use az spring app deploy/update --deployment <staging deployment>o .

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

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

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

O comando da imagem de contêiner.

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

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

Propriedade Valor
Valor padrão: False
--disable-probe

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

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

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

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

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

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

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

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

Propriedade Valor
Grupo de parâmetros: Custom Container Arguments
--liveness-probe-config
Versão Prévia

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

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 em relação à raiz zip.

--max-replicas

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

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

Propriedade Valor
Grupo de parâmetros: StandardGen2 Arguments
Valor padrão: 1
--no-wait

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

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

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

A senha do registro de 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 de runtime do idioma usado.

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

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. Com suporte apenas para regras de escala http e tcp.

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

Dimensionar metadados de 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

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

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

Propriedade Valor
Grupo de parâmetros: Source Code deploy Arguments
--startup-probe-config
Versão Prévia

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 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.

Propriedade Valor
Valor padrão: False

az spring app deployment delete

Preterido

Esse comando foi substituído implicitamente 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 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

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

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 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.

Propriedade Valor
Valor padrão: False

az spring app deployment generate-heap-dump

Preterido

Esse comando foi substituído implicitamente 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 o caminho do arquivo especificado.

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 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.

Propriedade Valor
Valor padrão: False

az spring app deployment generate-thread-dump

Preterido

Esse comando foi substituído implicitamente 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 o caminho do arquivo especificado.

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 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.

Propriedade Valor
Valor padrão: False

az spring app deployment list

Preterido

Esse comando foi substituído implicitamente 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 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.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 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.

Propriedade Valor
Valor padrão: False

az spring app deployment show

Preterido

Esse comando foi substituído implicitamente 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 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.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 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.

Propriedade Valor
Valor padrão: False

az spring app deployment start-jfr

Preterido

Esse comando foi substituído implicitamente 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 o caminho do arquivo especificado.

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 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.

Propriedade Valor
Valor padrão: False