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

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.

Questa guida introduttiva illustra come distribuire un'applicazione temporanea Spring Batch in Azure Spring Apps. Il progetto di esempio è derivato dal processo di calcio di esempio Spring Batch. Si tratta di un processo di caricamento delle statistiche. Nell'esempio originale, uno 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 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 dell'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

Azure portal

• Una sottoscrizione di Azure. Se non si ha già una sottoscrizione, creare un account gratuito prima di iniziare.
• Git.
• Se viene distribuita un'istanza del piano Enterprise di Azure Spring Apps per la prima volta nella sottoscrizione di destinazione, vedere la sezione Requisiti del Piano Enterprise in Azure Marketplace.

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.
• Se viene distribuita un'istanza del piano Enterprise di Azure Spring Apps per la prima volta nella sottoscrizione di destinazione, vedere la sezione Requisiti del Piano Enterprise in Azure Marketplace.

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 necessaria per eseguire questo esempio è un'istanza di Azure Spring Apps. Questa sezione illustra i passaggi per creare questa risorsa.

Azure portal

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 di>Azure Spring Apps.

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

   Impostazione	Valore suggerito	Descrizione
   Abbonamento	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.
   Piano	Funzionalità per le aziende	Piano tariffario che determina la risorsa e il costo associati all'istanza.
   Area	Area più vicina agli utenti.	Località più vicina agli utenti.
   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.
   Piano IP software	Pagamento in base al consumo	Piano tariffario che consente di pagare man mano che si usa Azure Spring Apps.
   Terms	Selected	Casella di controllo del contratto associata 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 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. Abilitare il Registro di sistema dei servizi

Passare all'istanza di Azure Spring Apps creata, espandere Componenti gestiti nel riquadro di spostamento e quindi selezionare Registro di sistema 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

App Spring di Azure viene usata per ospitare l'app Web Spring. Usare la procedura seguente 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. Distribuire l'app football-billboard in Azure Spring Apps

Azure portal

Usare la procedura seguente per distribuire l'app:

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 Distribuisci app e copiare il comando dell'interfaccia della riga di comando di Azure per distribuire 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 riquadro App 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

Usare la procedura seguente per distribuire l'app:

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. Usare il comando seguente per distribuire l'app:

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

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

Questa sezione illustra i passaggi per distribuire l'esempio.

Azure portal

5.1. Creare ed eseguire il processo

Usare la procedura seguente per creare ed eseguire il processo:

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 di sistema dei servizi. Selezionare quindi Associazione processi, selezionare Associa processo per selezionare il processo di calcio e quindi selezionare Applica per eseguire l'associazione.

   

3. Tornare al riquadro Processi 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 football processo 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

Usare la procedura seguente per creare ed eseguire il processo:

1. Usare il comando seguente per passare alla cartella del progetto di esempio dalla cartella football-billboard in cui è stata interrotta 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. Usare 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 EXECUTION_NAME variabile 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 cartellone pubblicitario

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

Azure portal

Per convalidare, seguire questa procedura:

1. Nel riquadro Esecuzioni controllare il risultato dell'esecuzione del processo. Attendere alcuni secondi e aggiornare per visualizzare lo 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 visualizzare l'interfaccia utente del cartellone. 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

Per convalidare, seguire questa procedura:

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 per l'esecuzione del processo dovrebbe essere simile all'esempio seguente:

   [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. Usare il comando seguente per recuperare l'endpoint dell'app football-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 visualizzare l'interfaccia utente del cartellone. Lasciare l'app aperta.

   

4. Usare il comando seguente per avviare di nuovo 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.

Azure portal

Usare la procedura seguente 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 e quindi selezionare il nome del gruppo di risorse.

2. Nella pagina Gruppo di risorse selezionare Elimina. Immettere il nome del gruppo di risorse nella casella di testo per confermare l'eliminazione e quindi selezionare Elimina.

Interfaccia della riga di comando di Azure

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

az group delete --name ${RESOURCE_GROUP}

8. Passaggi successivi

Per altre informazioni, vedere gli articoli seguenti:

• Esempi di App Spring di Azure.
• Azure per sviluppatori Spring
• Documentazione di Spring Cloud Azure