Come distribuire applicazioni Spring Boot dall'interfaccia della riga di comando di Azure

Articolo
11/06/2024

Nota

I piani Basic, Standard ed Enterprise saranno deprecati a partire dalla metà di marzo 2025, con un periodo di ritiro di 3 anni. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere l'annuncio di ritiro di Azure Spring Apps.

Il piano Standard a consumo e dedicato sarà deprecato a partire dal 30 settembre 2024, con un arresto completo dopo sei mesi. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere Eseguire la migrazione del consumo di Azure Spring Apps Standard e del piano dedicato alle app Azure Container.

Questo articolo si applica a:✅ Java ❎ C#

Questo articolo si applica a:✅ Basic/Standard ❎️ Enterprise

App Spring di Azure abilita le applicazioni Spring Boot in Azure.

È possibile avviare applicazioni direttamente dal codice sorgente Java o da un file JAR predefinito. Questo articolo illustra le procedure di distribuzione.

Prerequisiti

Prima di iniziare, verificare che la sottoscrizione di Azure abbia le dipendenze necessarie:

Suggerimento

Azure Cloud Shell è una shell interattiva gratuita che può essere usata per eseguire la procedura di questo articolo. Include i comuni strumenti di Azure preinstallati, tra cui le ultime versioni di Git, JDK, Maven e dell'interfaccia della riga di comando di Azure. Se è stato eseguito l'accesso alla sottoscrizione di Azure, avviare Azure Cloud Shell da shell.azure.com. Per altre informazioni su Azure Cloud Shell, leggere la documentazione

Installare l'estensione dell'interfaccia della riga di comando di Azure.

Installare l'estensione Azure Spring Apps per l'interfaccia della riga di comando di Azure con il comando seguente

az extension add --name spring

Effettuare il provisioning di un'istanza del servizio usando l'interfaccia della riga di comando di Azure

Accedere all'interfaccia della riga di comando di Azure e scegliere una sottoscrizione attiva.

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

Creare un gruppo di risorse per contenere il servizio in Azure Spring Apps. Per altre informazioni, vedere Gruppi di risorse di Azure.

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

Eseguire i comandi seguenti per effettuare il provisioning di un'istanza di Azure Spring Apps. Preparare un nome per il servizio in Azure Spring Apps. Il nome deve essere composto da 4-32 caratteri e può contenere solo lettere minuscole, numeri e trattini. Il primo carattere del nome del servizio deve essere una lettera e l'ultimo deve essere una lettera o un numero.

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

La distribuzione dell'istanza del servizio richiede circa cinque minuti.

Impostare il nome del gruppo di risorse predefinito e il nome dell'istanza di Azure Spring Apps usando i comandi seguenti:

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

Creare l'applicazione in Azure Spring Apps

Il comando seguente crea un'applicazione in Azure Spring Apps nella sottoscrizione. Verrà creato un servizio vuoto in cui è possibile caricare l'applicazione.

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

Distribuire l'applicazione Spring Boot

È possibile distribuire l'applicazione da un file JAR precompilato o da un repository Gradle o Maven. Le istruzioni relative a ogni caso sono riportate di seguito.

Distribuire un file JAR predefinito

Per eseguire la distribuzione da un file JAR compilato nel computer locale, assicurarsi che la compilazione produca un file di tipo fat-JAR.

Per distribuire il fat-JAR in una distribuzione attiva

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

Per distribuire il fat-JAR in una distribuzione specifica

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

Distribuire dal codice sorgente

Azure Spring Apps usa kpack per compilare il progetto. È possibile usare l'interfaccia della riga di comando di Azure per caricare il codice sorgente, compilare il progetto usando kpack e distribuirlo all'applicazione di destinazione.

Avviso

Il progetto deve produrre un solo file JAR con una voce main-class nel file MANIFEST.MF in target (per le distribuzioni Maven) o build/libs (per le distribuzioni Gradle). Più file JAR con voci main-class determineranno l'esito negativo della distribuzione.

Per i progetti Maven/Gradle con un singolo modulo:

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

Per i progetti Maven/Gradle con più moduli, ripetere per ogni modulo:

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

Visualizzare i log di distribuzione

Esaminare i log di compilazione kpack usando il comando seguente:

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

Nota

I log kpack visualizzeranno solo la distribuzione più recente se questa è stata compilata dal codice sorgente usando kpack.

Assegnare un endpoint pubblico a un'applicazione

Aprire il riquadro App per visualizzare le app per l'istanza del servizio.
Selezionare un'applicazione per visualizzare la relativa pagina Panoramica .
Selezionare Assegna endpoint per assegnare un endpoint pubblico all'applicazione. Questo processo può richiedere alcuni minuti.
Copiare l'URL dalla pagina Panoramica e incollarlo nel browser per visualizzare l'applicazione in esecuzione.

Passaggi successivi

Guida introduttiva: Monitoraggio di Azure Spring Apps con log, metriche e traccia

Altri esempi sono disponibili in GitHub: Esempi di Azure Spring Apps.

Condividi tramite