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

Artigo
04/23/2024

Nota

Azure Spring Apps é o novo nome para o serviço Azure Spring Cloud. Embora o serviço tenha um novo nome, você verá o nome antigo em alguns lugares por um tempo enquanto trabalhamos para atualizar ativos, como capturas de tela, vídeos e diagramas.

Este artigo aplica-se a: ✔️ Java ❌ C#

Este artigo aplica-se a: ✔️ Basic/Standard ❌️ Enterprise

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.

Pré-requisitos

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

Gorjeta

O Azure Cloud Shell é um shell interativo gratuito que pode utilizar para executar os passos 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 levará cerca de cinco minutos para ser implantada.

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.

Implantar um JAR pré-criado

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 implantar o fat-JAR em uma implantaçã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.

Aviso

O projeto deve produzir apenas um arquivo JAR com uma main-class entrada no in target (para implantações do Maven) ou build/libs (para implantações do MANIFEST.MF Gradle). Vários arquivos JAR com entradas farão com main-class 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>

Nota

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

Abra o painel Aplicativos para exibir aplicativos para sua instância de serviço.
Selecione um aplicativo para exibir sua página Visão geral .
Selecione Atribuir ponto de extremidade para atribuir um ponto de extremidade público ao aplicativo. Este processo pode demorar alguns minutos.
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: monitorando o Azure Spring Apps com logs, métricas e rastreamento

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

Share via