Como implantar aplicativos Spring Boot usando a CLI do Azure

Artigo
10/02/2024

Observação

Os planos Básico, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de desativação de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira o anúncio de desativação dos Aplicativos Spring do Azure.

O plano Standard de consumo e dedicado será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira Migrar o plano Standard de consumo e dedicado dos Aplicativos Spring do Azure para os Aplicativos de Contêiner do Azure.

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

Este artigo se aplica a: ✔️ nível Básico/Standard ❌ nível Enterprise

O Azure Spring Apps habilita aplicativos Spring Boot no Azure.

Você pode inicializar aplicativos diretamente do código-fonte Java ou de um JAR predefinido. Este artigo explica os procedimentos de implantação.

Pré-requisitos

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

Dica

O Azure Cloud Shell é um shell interativo grátis que pode ser usado para executar as etapas neste artigo. Ele tem ferramentas comuns do Azure pré-instaladas, incluindo as versões mais recentes do Git, do JDK, do Maven e da CLI do Azure. Se você fez logon na assinatura do Azure, inicie o Azure Cloud Shell em shell.azure.com. Você pode saber mais sobre o Azure Cloud Shell lendo nossa documentação

Instalar a extensão da CLI do Azure

Instalar a extensão do 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 o 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 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 hifens. 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á aproximadamente 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 no qual você pode carregar seu aplicativo.

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

Implantar o aplicativo Spring Boot

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

Implantar um JAR predefinido

Para implantar a partir de um JAR compilado em seu computador local, verifique se sua compilação produz 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 do código-fonte

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

Aviso

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

Exibir logs de implantação

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

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

Observação

Os logs do kpack mostrarão apenas a implantação mais recente se essa implantação foi criada a partir da origem usando kpack.

Atribuir um ponto de extremidade público a um aplicativo

Abra o painel Aplicativos para exibir aplicativos na 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. Esse processo pode levar alguns minutos.
Copie a URL da página Visão geral e cole-a em seu navegador para exibir o aplicativo em execução.

Próximas etapas

Início Rápido: Monitoramento do Azure Spring Apps com logs, métricas e rastreamento

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

Compartilhar via