Avvio rapido: Implementare la prima applicazione Spring Batch in Azure Spring Apps

Note

I piani Basic, Standard ed Enterprise sono entrati in un periodo di ritiro il 17 marzo 2025. Per altre informazioni, vedere l'annuncio di ritiro di Azure Spring Apps.

Questa guida di avvio rapido illustra come implementare un'applicazione temporanea Spring Batch in Azure Spring Apps. Il progetto di esempio è derivato dall’esempio di Spring Batch Football Job. Si tratta di un processo di caricamento delle statistiche. Nell'esempio originale, un unit test attiva il processo. Nell'esempio adattato, il main metodo di FootballJobApplication avvia il processo.

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

Il diagramma seguente illustra l'architettura del sistema:

Questo articolo offre le opzioni seguenti per la distribuzione in Azure Spring Apps:

• L'opzione con il portale di Azure è il modo più semplice e rapido per creare risorse e distribuire applicazioni con un solo clic. Questa opzione è adatta agli sviluppatori Spring che vogliono distribuire rapidamente le applicazioni nei servizi cloud di Azure.
• L'opzione con l'interfaccia della riga di comando di Azure usa un potente strumento da riga di comando per gestire le risorse di Azure. Questa opzione è adatta agli sviluppatori Spring che hanno familiarità con i servizi cloud di Azure.

1. Prerequisiti

Portale di Azure

• Una sottoscrizione di Azure. Se non si ha già una sottoscrizione, creare un account gratuito prima di iniziare.
• Git.

Interfaccia della riga di comando di Azure

• Una sottoscrizione di Azure. Se non si ha già una sottoscrizione, creare un account gratuito prima di iniziare.
• Git.
• Java Development Kit (JDK) versione 17.
• Interfaccia della riga di comando di Azure versione 2.55.0 o successiva. Usare i comandi seguenti per installare l'estensione Azure Spring Apps: az extension add --name spring.

2. Preparare il progetto Spring

Usare il comando seguente per clonare il progetto di esempio da GitHub:

git clone https://github.com/Azure-Samples/azure-spring-apps-samples.git

3. Preparare l'ambiente cloud

La risorsa principale richiesta per eseguire questo esempio è un'istanza di Azure Spring Apps. In questa sezione vengono illustrati i passi per creare questa risorsa.

Portale di Azure

3.1. Accedere al portale di Azure

Passare al portale di Azure e immettere le credenziali per accedere al portale. La visualizzazione predefinita è il dashboard del servizio.

3.2. Creare un'istanza di Azure Spring Apps

Usare la procedura seguente per creare un'istanza del servizio Azure Spring Apps:

1. Selezionare Crea una risorsa nell'angolo del portale di Azure.

2. Selezionare Calcolo>Azure Spring Apps.

3. Compilare il modulo Informazioni di base con le informazioni seguenti:

   Impostazione	Valore consigliato	Descrizione
   Sottoscrizione	Nome della sottoscrizione.	Sottoscrizione di Azure da usare per il server. Se si hanno più sottoscrizioni, scegliere quella in cui si desidera che venga fatturata la risorsa.
   Gruppo di risorse	myresourcegroup	Nuovo nome di gruppo di risorse o uno esistente nella sottoscrizione.
   Nome	myasa	Nome univoco che identifica il servizio Azure Spring Apps. Il nome deve essere composto da 4-32 caratteri e può contenere solo lettere in minuscolo, numeri e trattini. Il primo carattere del nome del servizio deve essere una lettera e l'ultimo deve essere una lettera o un numero.
   Pianificare	Enterprise	Piano tariffario che determina la risorsa e il costo associati all'istanza.
   Area	Area più vicina agli utenti.	Località più vicina agli utenti.
   Con ridondanza della zona	Opzione non selezionata	Opzione per creare il servizio Azure Spring Apps in una zona di disponibilità di Azure. Questa funzionalità non è attualmente supportata in tutte le aree geografiche.
   Piano IP software	Con pagamento in base al consumo	Piano tariffario che consente di pagare Azure Spring Apps a consumo.
   Terms	Selezionato	Casella di controllo del contratto associato all'offerta Marketplace. È necessario selezionare questa casella di controllo.
   Distribuire un progetto di esempio	Opzione non selezionata	Opzione per usare l'applicazione di esempio predefinita.

4. Selezionare Rivedi e crea per rivedere le selezioni. Selezionare quindi Crea per effettuare il provisioning dell'istanza di Azure Spring Apps.

5. Sulla barra degli strumenti selezionare l'icona Notifiche a forma di campana per monitorare il processo di distribuzione. Al termine della distribuzione, è possibile selezionare Aggiungi al dashboard, che crea un riquadro per questo servizio nel dashboard del portale di Azure come collegamento alla pagina Panoramica del servizio.

   

6. Selezionare Vai alla risorsa per passare alla pagina Panoramica di Azure Spring Apps.

3.3. Abilita registro del servizio

Passare all'istanza di Azure Spring Apps creata, espandere Componenti gestiti nel riquadro di spostamento e quindi selezionare Registro dei servizi. Quindi, nella pagina Panoramica selezionare Gestisci per aprire la pagina Gestisci, selezionare Abilita registro dei servizi e quindi selezionare Applica.

3.4. Configurare un'area di lavoro Log Analytics

Per informazioni sull'esecuzione di query sui dati nei log, vedere Avvio rapido: Configurare un'area di lavoro Log Analytics.

Interfaccia della riga di comando di Azure

3.1. Specificare i nomi per ogni risorsa

Creare variabili per contenere i nomi delle risorse usando i comandi seguenti. Assicurarsi di sostituire i segnaposto con i propri valori.

export LOCATION=<location>
export RESOURCE_GROUP=<resource-group-name>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-name>

3.2. Creare un nuovo gruppo di risorse

Usare la procedura seguente per creare un nuovo gruppo di risorse:

1. Usare il comando seguente per accedere all'interfaccia della riga di comando di Azure:

   az login
   

2. Usare il comando seguente per impostare il percorso predefinito:

   az configure --defaults location=${LOCATION}
   

3. Usare il comando seguente per elencare tutte le sottoscrizioni disponibili per determinare l'ID sottoscrizione da usare:

   az account list --output table
   

4. Usare il comando seguente per impostare la sottoscrizione predefinita:

   az account set --subscription <subscription-ID>
   

5. Usare il comando seguente per creare un gruppo di risorse:

   az group create --resource-group ${RESOURCE_GROUP}
   

6. Usare il comando seguente per impostare il gruppo di risorse appena creato come gruppo di risorse predefinito:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Creare un'istanza di Azure Spring Apps

Azure Spring Apps viene usato per ospitare l'app Web Spring. Usare i seguenti passi per creare un'istanza di Azure Spring Apps e un'applicazione al suo interno:

1. Usare il comando seguente per creare un'istanza del servizio Azure Spring Apps e abilitare il Registro di sistema del servizio:

   az spring create \
       --name ${AZURE_SPRING_APPS_INSTANCE} \
       --sku enterprise \
       --enable-sr
   

2. Usare il comando seguente per verificare che l'istanza del servizio piano Enterprise di Azure Spring Apps sia stata creata correttamente:

   az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
   

4. Implementare l'app football-billboard in Azure Spring Apps

Portale di Azure

Per implementare l'app, seguire questi passi:

1. Passare all'istanza di Azure Spring Apps creata, espandere Impostazioni nel riquadro di spostamento e quindi selezionare App.

2. Nel riquadro App, selezionare Crea app per aprire la pagina Crea app.

3. Impostare Nome app su football-billboard, selezionare Registro di servizio nella colonna Bind e quindi selezionare Crea.

   

4. Dopo aver creato l'app, selezionare Implementa App e copiare il comando dell'interfaccia della riga di comando di Azure per implementare l'app. Aprire quindi una finestra Bash e incollare il comando nella riga di comando, sostituendo il percorso dell'artefatto con il valore corretto per il sistema. Eseguire quindi il comando. Attendere alcuni minuti fino al completamento della compilazione e della distribuzione. Il comando e l'output dovrebbero essere simili all'esempio seguente:

   $ az spring app deploy -s job-demo -g job-demo -n football-billboard --artifact-path target/spring-batch-football-billboard-0.0.1-SNAPSHOT.jar
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football-billboard'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

5. Dopo la distribuzione, tornare al riquadroApp e selezionare l'app football-billboard. Passare quindi alla pagina di panoramica e selezionare Assegna endpoint per esporre l'endpoint pubblico per l'app.

Interfaccia della riga di comando di Azure

Per implementare l'app, seguire questi passi:

1. Usare il comando seguente per passare alla cartella del progetto di esempio dalla cartella radice del repository:

   cd azure-spring-apps-samples/job-samples/football-billboard
   

2. Usare il comando seguente per creare un'applicazione nell'istanza di Azure Spring Apps e associare il registro dei servizi:

   az spring app create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --assign-endpoint true \
       --bind-sr
   

3. Per distribuire l'app, usare il comando seguente:

   az spring app deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

5. Implementare l'esempio di processo in Azure Spring Apps

In questa sezione vengono illustrati i passi per distribuire l'esempio.

Portale di Azure

5.1. Creare ed eseguire il processo

Per creare ed eseguire il processo, seguire questi passi:

1. Passare al riquadro Processi e quindi selezionare Crea processo. Immettere il nome del processo come football. Configurare i parametri del processo, ad esempio parallelismo, limite di tentativi e timeout. Aggiungere variabili di ambiente e variabili di ambiente segrete in base alle esigenze. Dopo la conferma, selezionare Crea.

   

2. Dopo aver creato il processo, espandere Componenti gestiti nel riquadro di spostamento e selezionare Registro dei servizi. Selezionare quindi Associazione processo, selezionare Associa processo per selezionare il processo di football, e quindi selezionare Applica per eseguire l'associazione.

   

3. Tornare al riquadroProcessi dopo l'associazione del processo, selezionare Distribuisci processo e quindi copiare il comando dell'interfaccia della riga di comando di Azure per distribuire il processo. Aprire quindi una finestra Bash e incollare il comando nella riga di comando, sostituendo il percorso dell'artefatto con il valore corretto per il sistema. Eseguire quindi il comando. Attendere alcuni minuti fino al completamento della compilazione e della distribuzione. Il comando e l'output dovrebbero essere simili all'esempio seguente:

   $ az spring job deploy -s job-demo -g job-demo -n football --artifact-path target/spring-batch-football-0.0.1-SNAPSHOT-jar-with-dependencies.jar --build-env BP_JVM_VERSION=17
   This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

4. Dopo la distribuzione, aprire la pagina di panoramica del processofootball selezionando il nome del processo. Selezionare Esegui per avviare l'esecuzione dell'attività. È possibile personalizzare ogni esecuzione del processo con parametri diversi, ad esempio variabili di ambiente, oppure selezionare Esegui per attivare l'esecuzione. Un messaggio indica che il processo è in esecuzione.

   

Interfaccia della riga di comando di Azure

5.1. Creare ed eseguire il processo

Per creare ed eseguire il processo, seguire questi passi:

1. Usare il comando seguente per passare alla cartella del progetto di esempio dalla cartella football-billboard in cui si era interrotto in precedenza:

   cd ..
   cd football
   

2. Usare il comando seguente per creare un processo nell'istanza di Azure Spring Apps e associare il registro dei servizi:

   az spring job create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --bind-sr
   

3. Utilizzare il comando seguente per distribuire il football progetto di esempio nel processo. Questo comando carica e compila il codice sorgente in Azure e lo rende pronto per l'avvio.

   az spring job deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

4. Usare il comando seguente per avviare il processo e impostare la variabile EXECUTION_NAME sul nome dell'esecuzione del processo:

   export EXECUTION_NAME=$(az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --query name \
       --output tsv)
   

6. Controllare il risultato dell'esecuzione del processo e l'interfaccia utente del pannello

È ora possibile accedere all'esecuzione del processo e controllarne il risultato.

Portale di Azure

Usare la procedura seguente per convalidare:

1. Nel riquadro Esecuzioni, controllare il risultato dell'esecuzione del processo. Attendere alcuni secondi e aggiornare per visualizzare il turno di stato su Completato. Questo valore indica che l'esecuzione del processo viene completata correttamente.

2. Selezionare Visualizza log per eseguire query sui log dell'esecuzione del processo.

   

3. Aprire l'endpoint pubblico dell'app in una finestra del browser per vedere l'interfaccia di billboard. Lasciare l'app aperta.

   

4. Tornare alla pagina di panoramica del football processo e selezionare Esegui per attivare nuovamente l'esecuzione.

5. Tornare alla pagina dell'endpoint nel browser e selezionare Aggiorna per visualizzare la modifica dell'interfaccia utente, come illustrato nello screenshot seguente:

   

Interfaccia della riga di comando di Azure

Usare la procedura seguente per convalidare:

1. Usare il comando seguente per eseguire una query sul risultato dell'esecuzione usando il nome del processo e il relativo nome di esecuzione:

   az spring job logs \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --execution ${EXECUTION_NAME} \
       --all-instances
   

   Il flusso del log del processo durante l'esecuzione del processo dovrebbe essere simile al seguente esempio:

   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - No TaskExecutor has been set, defaulting to synchronous executor.
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is {} player summary before job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] launched with the following parameters: [{}]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [playerLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [playerLoad] executed in 200ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [gameLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [gameLoad] executed in 290ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [summarizationStep]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [summarizationStep] executed in 7ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] completed with the following parameters: [{}] and the following status: [COMPLETED] in 519ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is 1 player summary after job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseFactory - Shutting down embedded database: url='jdbc:hsqldb:mem:testdb'
   ...
   

2. Usa il comando seguente per recuperare il punto finale dell'applicazionefootball-billboard:

   az spring app show \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --query properties.url
   

3. Aprire l'endpoint pubblico dell'app in una finestra del browser per vedere l'interfaccia di billboard. Lasciare l'app aperta.

   

4. Usare il comando seguente per riavviare il processo:

   az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football
   

5. Tornare alla pagina dell'endpoint nel browser e selezionare Aggiorna per visualizzare la modifica dell'interfaccia utente, come illustrato nello screenshot seguente:

   

7. Pulire le risorse

Assicurarsi di eliminare le risorse create in questo articolo quando non sono più necessarie. È possibile eliminare il gruppo di risorse di Azure, che include tutte le risorse del gruppo.

Portale di Azure

Usare la seguente procedura per eliminare l'intero gruppo di risorse, inclusa l'istanza del servizio appena creata:

1. Individuare il gruppo di risorse nel portale di Azure. Nel menu di spostamento selezionare Gruppi di risorse, quindi selezionare il nome del gruppo di risorse.

2. Nella pagina Gruppo di risorse selezionare Elimina. Per confermare l'eliminazione, immettere il nome del gruppo di risorse nella casella di testo, quindi selezionare Elimina.

Interfaccia della riga di comando di Azure

Per eliminare l'intero gruppo di risorse, inclusa l'istanza del servizio appena creata, usare il comando seguente:

az group delete --name ${RESOURCE_GROUP}

8. Passaggi successivi

Per altre informazioni, vedere gli articoli seguenti:

• Esempi di Azure Spring Apps.
• Azure for sviluppatori Spring
• Documentazione di Spring Cloud di Azure