Partilhar via

Como implantar aplicativos do Spring Boot a partir da CLI do Azure

Note

Os planos Basic, Standarde Enterprise entraram em um período de aposentadoria em 17 de março de 2025. Para obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.

O plano de consumo padrão e dedicado entrou em um período de aposentadoria em 30 de setembro de 2024, com uma paralisação completa até o final de março de 2025. Para obter mais informações, consulte Migrar o plano de consumo padrão e dedicado do Azure Spring Apps para Azure Container Apps.

Este artigo aplica-se a:✅ Java ❎ C#

Este artigo aplica-se a:✅ Empresa Básica/Padrão ❎️

O Azure Spring Apps habilita os aplicativos Spring Boot no Azure.

Você pode iniciar aplicativos diretamente do código-fonte Java ou de um JAR pré-construído. Este artigo explica os procedimentos de implantação.

Prerequisites

Antes de começar, verifique se sua assinatura do Azure tem as dependências necessárias:

  1. Instale o Git.
  2. Instalar o JDK 8
  3. Instale o Maven 3.0 ou superior
  4. Instalar a CLI do Azure
  5. Inscreva-se para uma assinatura do Azure

Tip

O Azure Cloud Shell é um shell interativo gratuito que você pode usar para executar as etapas neste artigo. Ele tem ferramentas comuns do Azure pré-instaladas, incluindo as versões mais recentes do Git, JDK, Maven e da CLI do Azure. Se tiver sessão iniciada na sua subscrição do Azure, inicie o Azure Cloud Shell a partir do shell.azure.com. Você pode saber mais sobre o Azure Cloud Shell lendo nossa documentação

Instalar a extensão da CLI do Azure

Instale a extensão Azure Spring Apps para a CLI do Azure com o seguinte comando

az extension add --name spring

Provisionar uma instância de serviço usando a CLI do Azure

Entre na CLI do Azure e escolha sua assinatura ativa.

az login
az account list -o table
az account set --subscription <subscription-id>

Crie um grupo de recursos para conter seu serviço no Azure Spring Apps. Você pode saber mais sobre os Grupos de Recursos do Azure.

az group create --___location eastus --name <resource-group-name>

Execute os comandos a seguir para provisionar uma instância do Azure Spring Apps. Prepare um nome para o seu serviço no Azure Spring Apps. O nome deve ter entre 4 e 32 caracteres e pode conter apenas letras minúsculas, números e hífenes. O primeiro caractere do nome do serviço deve ser uma letra e o último caractere deve ser uma letra ou um número.

az spring create --resource-group <resource-group-name> --name <resource-name>

A instância de serviço demorará aproximadamente cinco minutos para ser implementada.

Defina o nome do grupo de recursos padrão e o nome da instância do Azure Spring Apps usando os seguintes comandos:

az config set defaults.group=<service-group-name>
az config set defaults.spring=<service-instance-name>

Criar o aplicativo no Azure Spring Apps

O comando a seguir cria um aplicativo no Azure Spring Apps em sua assinatura. Isso cria um serviço vazio para o qual você pode carregar seu aplicativo.

az spring app create --name <app-name>

Implante seu aplicativo Spring Boot

Você pode implantar seu aplicativo a partir de um JAR pré-criado ou de um repositório Gradle ou Maven. Encontre instruções para cada caso abaixo.

Implementar um JAR pré-construído

Para implantar a partir de um JAR construído em sua máquina local, certifique-se de que sua compilação produza um fat-JAR.

Para desplegar o fat-JAR numa desplegação ativa

az spring app deploy --name <app-name> --artifact-path <path-to-fat-JAR>

Para implantar o fat-JAR em uma implantação específica

az spring app deployment create --app <app-name> \
    --name <deployment-name> \
    --artifact-path <path-to-fat-JAR>

Implantar a partir do código-fonte

O Azure Spring Apps usa o kpack para criar seu projeto. Você pode usar a CLI do Azure para carregar seu código-fonte, criar seu projeto usando kpack e implantá-lo no aplicativo de destino.

Warning

O projeto deve produzir apenas um arquivo JAR com uma main-class entrada em MANIFEST.MF (para implementações do Maven) ou build/libs (para implementações do Gradle). Vários arquivos JAR com main-class entradas farão com que a implantação falhe.

Para projetos Maven / Gradle de módulo único:

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path

Para projetos Maven / Gradle com vários módulos, repita para cada módulo:

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path \
    --target-module <relative-path-to-module>

Mostrar logs de implantação

Revise os logs de compilação do kpack usando o seguinte comando:

az spring app show-deploy-log --name <app-name>

Note

Os logs do kpack só mostrarão a implantação mais recente se essa implantação tiver sido criada a partir do código-fonte usando o kpack.

Atribuir um ponto de extremidade público a um aplicativo

  1. Abra o painel Aplicativos para exibir aplicativos para sua instância de serviço.
  2. Selecione um aplicativo para exibir sua página Visão geral .
  3. Selecione Atribuir ponto de extremidade para atribuir um ponto de extremidade público ao aplicativo. Este processo pode demorar alguns minutos.
  4. Copie o URL da página Visão geral e cole-o em seu navegador para visualizar o aplicativo em execução.

Próximos passos

Guia de Início Rápido: Monitorizar o Azure Spring Apps com logs, métricas e rastreio

Mais exemplos estão disponíveis no GitHub: Azure Spring Apps Samples.