Snabbstart: Distribuera ditt första Spring Batch-program till Azure Spring Apps

Kommentar

Basic-, Standard- och Enterprise-planerna kommer att vara inaktuella från och med mitten av mars 2025, med en 3-årig pensionsperiod. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i meddelandet om azure Spring Apps-pensionering.

Standardförbrukningen och den dedikerade planen kommer att vara inaktuell från och med den 30 september 2024, med en fullständig avstängning efter sex månader. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i Migrera Azure Spring Apps Standard-förbrukning och dedikerad plan till Azure Container Apps.

Den här snabbstarten visar hur du distribuerar ett tillfälliga Spring Batch-program till Azure Spring Apps. Exempelprojektet härleds från Spring Batch-exempelfotbollsjobbet. Det är ett statistikinläsningsjobb. I det ursprungliga exemplet utlöser ett enhetstest jobbet. I det anpassade exemplet main initierar metoden FootballJobApplication för jobbet.

Den här artikeln gäller för:❌ Basic/Standard ✔️ Enterprise

Följande diagram visar systemets arkitektur:

Den här artikeln innehåller följande alternativ för att distribuera till Azure Spring Apps:

• Alternativet Azure Portal är det enklaste och snabbaste sättet att skapa resurser och distribuera program med ett enda klick. Det här alternativet är lämpligt för Spring-utvecklare som snabbt vill distribuera program till Azure-molntjänster.
• Azure CLI-alternativet använder ett kraftfullt kommandoradsverktyg för att hantera Azure-resurser. Det här alternativet är lämpligt för Spring-utvecklare som är bekanta med Azure-molntjänster.

1. Förutsättningar

Azure-portalen

• En Azure-prenumeration Om du inte har någon prenumeration skapar du ett kostnadsfritt konto innan du börjar.
• Git.
• Om du distribuerar en Azure Spring Apps Enterprise-planinstans för första gången i målprenumerationen läser du avsnittet Krav i Enterprise-plan på Azure Marketplace.

Azure CLI

• En Azure-prenumeration Om du inte har någon prenumeration skapar du ett kostnadsfritt konto innan du börjar.
• Git.
• Java Development Kit (JDK), version 17.
• Azure CLI version 2.55.0 eller senare. Använd följande kommandon för att installera Azure Spring Apps-tillägget: az extension add --name spring.
• Om du distribuerar en Azure Spring Apps Enterprise-planinstans för första gången i målprenumerationen läser du avsnittet Krav i Enterprise-plan på Azure Marketplace.

2. Förbereda Spring-projektet

Använd följande kommando för att klona exempelprojektet från GitHub:

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

3. Förbereda molnmiljön

Den viktigaste resursen som krävs för att köra det här exemplet är en Azure Spring Apps-instans. Det här avsnittet innehåller stegen för att skapa den här resursen.

Azure-portalen

3.1. Logga in på Azure-portalen

Gå till Azure Portal och ange dina autentiseringsuppgifter för att logga in på portalen. Standardvyn är instrumentpanelen.

3.2. Skapa en Azure Spring Apps-instans

Använd följande steg för att skapa en Azure Spring Apps-tjänstinstans:

1. Välj Skapa en resurs i hörnet av Azure Portal.

2. Välj Beräkna>Azure Spring Apps.

3. Fyll i formuläret Grundläggande med följande information:

   Inställning	Föreslaget värde	beskrivning
   Abonnemang	Namnet på din prenumeration.	Den Azure-prenumeration som ska användas för servern. Om du har flera prenumerationer väljer du den prenumeration där du vill debiteras för resursen.
   Resursgrupp	myresourcegroup	Ett nytt resursgruppnamn eller ett befintligt namn i prenumerationen.
   Namn	myasa	Ett unikt namn som identifierar din Azure Spring Apps-tjänst. Namnet måste vara mellan 4 och 32 tecken långt och får endast innehålla gemener, siffror och bindestreck. Det första tecknet i tjänstnamnet måste vara en bokstav och det sista tecknet måste vara antingen en bokstav eller ett tal.
   Planera	Enterprise	Prisplanen som avgör vilken resurs och kostnad som är associerad med din instans.
   Region	Den region som är närmast dina användare.	Den plats som är närmast dina användare.
   Zonredundant	Inte markerat	Alternativet att skapa din Azure Spring Apps-tjänst i en Azure-tillgänglighetszon. Den här funktionen stöds för närvarande inte i alla regioner.
   Ip-plan för programvara	Betala per användning	Prisplanen som låter dig betala per användning med Azure Spring Apps.
   Villkor	Har valts	Kryssrutan avtal som är associerad med Marketplace-erbjudandet. Du måste markera den här kryssrutan.
   Distribuera exempelprojekt	Inte markerat	Alternativet att använda det inbyggda exempelprogrammet.

4. Välj Granska och skapa för att granska dina val. Välj sedan Skapa för att etablera Azure Spring Apps-instansen.

5. Välj ikonen Aviseringar (en bjällra) i verktygsfältet för att övervaka distributionsprocessen. När distributionen är klar kan du välja Fäst på instrumentpanelen, vilket skapar en panel för den här tjänsten på din Azure Portal instrumentpanel som en genväg till tjänstens översiktssida.

   

6. Välj Gå till resurs för att gå till översiktssidan för Azure Spring Apps .

3.3. Aktivera tjänstregister

Gå till den Azure Spring Apps-instans som du skapade, expandera Hanterade komponenter i navigeringsfönstret och välj sedan Tjänstregister. På sidan Översikt väljer du Sedan Hantera för att öppna sidan Hantera, välj Aktivera tjänstregister och välj sedan Använd.

3.4. Ställ in en Log Analytics-arbetsyta

Information om hur du frågar efter data i loggar finns i Snabbstart: Konfigurera en Log Analytics-arbetsyta.

Azure CLI

3.1. Ange namn för varje resurs

Skapa variabler för att lagra resursnamnen med hjälp av följande kommandon. Se till att ersätta platshållarna med dina egna värden.

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

3.2. Skapa en ny resursgrupp

Använd följande steg för att skapa en ny resursgrupp:

1. Använd följande kommando för att logga in på Azure CLI:

   az login
   

2. Använd följande kommando för att ange standardplatsen:

   az configure --defaults location=${LOCATION}
   

3. Använd följande kommando för att lista alla tillgängliga prenumerationer för att fastställa vilket prenumerations-ID som ska användas:

   az account list --output table
   

4. Använd följande kommando för att ange standardprenumerationen:

   az account set --subscription <subscription-ID>
   

5. Använd följande kommando för att skapa en resursgrupp:

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

6. Använd följande kommando för att ange den nyligen skapade resursgruppen som standardresursgrupp:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Skapa en Azure Spring Apps-instans

Azure Spring Apps används som värd för Spring-webbappen. Använd följande steg för att skapa en Azure Spring Apps-instans och ett program i den:

1. Använd följande kommando för att skapa en Azure Spring Apps-tjänstinstans och aktivera tjänstregistret:

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

2. Använd följande kommando för att kontrollera att Azure Spring Apps Enterprise-plantjänstinstansen har skapats:

   az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
   

4. Distribuera appen football-billboard till Azure Spring Apps

Azure-portalen

Använd följande steg för att distribuera appen:

1. Gå till den Azure Spring Apps-instans som du skapade, expandera Inställningar i navigeringsfönstret och välj sedan Appar.

2. I fönstret Appar väljer du Skapa app för att öppna sidan Skapa app .

3. Ange Appnamn till football-billboard, välj Service Registry i kolumnen Bind och välj sedan Skapa.

   

4. När du har skapat appen väljer du Distribuera app och kopierar Azure CLI-kommandot för att distribuera appen. Öppna sedan ett Bash-fönster och klistra in kommandot på kommandoraden och ersätt artefaktsökvägen med rätt värde för systemet. Kör sedan kommandot . Vänta några minuter tills bygget och distributionen lyckas. Kommandot och utdata bör se ut ungefär som i följande exempel:

   $ 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. Efter distributionen går du tillbaka till fönstret Appar och väljer football-billboard appen. Gå sedan till översiktssidan och välj Tilldela slutpunkt för att exponera appens offentliga slutpunkt.

Azure CLI

Använd följande steg för att distribuera appen:

1. Använd följande kommando för att navigera till exempelprojektmappen från rotmappen på lagringsplatsen:

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

2. Använd följande kommando för att skapa ett program i Azure Spring Apps-instansen och binda tjänstregistret:

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

3. Använd följande kommando för att distribuera appen:

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

5. Distribuera jobbexemplet till Azure Spring Apps

Det här avsnittet innehåller stegen för att distribuera exemplet.

Azure-portalen

5.1. Skapa och köra jobbet

Använd följande steg för att skapa och köra jobbet:

1. Gå till fönstret Jobb och välj sedan Skapa jobb. Fyll i jobbnamnet som football. Konfigurera jobbparametrarna, till exempel parallellitet, återförsöksgräns och tidsgräns. Lägg till miljövariabler och hemliga miljövariabler efter behov. Efter bekräftelse väljer du Skapa.

   

2. När du har skapat jobbet expanderar du Hanterade komponenter i navigeringsfönstret och väljer Tjänstregister. Välj sedan Jobbbindning, välj Bind jobb för att välja fotbollsjobbet och välj sedan Använd för bindning.

   

3. Gå tillbaka till Jobbfönstret efter att jobbet har bindts väljer du Distribuera jobb och kopierar sedan Azure CLI-kommandot för att distribuera jobbet. Öppna sedan ett Bash-fönster och klistra in kommandot på kommandoraden och ersätt artefaktsökvägen med rätt värde för systemet. Kör sedan kommandot . Vänta några minuter tills bygget och distributionen lyckas. Kommandot och utdata bör se ut ungefär som i följande exempel:

   $ 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. Efter distributionen öppnar du översiktssidan för football jobbet genom att välja jobbnamnet. Välj Kör för att initiera aktivitetskörningen. Du kan anpassa varje körning av jobbet med olika parametrar, till exempel miljövariabler, eller bara välja Kör för att utlösa körningen. Ett meddelande anger att jobbet körs.

   

Azure CLI

5.1. Skapa och köra jobbet

Använd följande steg för att skapa och köra jobbet:

1. Använd följande kommando för att navigera till exempelprojektmappen från mappen football-billboard där du slutade tidigare:

   cd ..
   cd football
   

2. Använd följande kommando för att skapa ett jobb i Azure Spring Apps-instansen och binda tjänstregistret:

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

3. Använd följande kommando för att distribuera football exempelprojektet till jobbet. Det här kommandot laddar upp och kompilerar källkoden i Azure och gör den redo att starta.

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

4. Använd följande kommando för att starta jobbet och ange variabeln EXECUTION_NAME till jobbets körningsnamn:

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

6. Kontrollera resultatet av jobbkörningen och affischtavlans användargränssnitt

Nu kan du komma åt körningen av jobbet och kontrollera resultatet.

Azure-portalen

Använd följande steg för att verifiera:

1. I fönstret Körningar kontrollerar du resultatet av jobbkörningen. Vänta några sekunder och uppdatera för att se statusen till Slutförd. Det här värdet innebär att jobbkörningen har slutförts.

2. Välj Visa loggar för att köra frågor mot loggarna för jobbkörningen.

   

3. Öppna appens offentliga slutpunkt i ett webbläsarfönster för att se användargränssnittet för affischtavlor. Låt appen vara öppen.

   

4. Gå tillbaka till översiktssidan för football jobbet och välj Kör för att utlösa körningen igen.

5. Gå tillbaka till slutpunktssidan i webbläsaren och välj Uppdatera för att se att användargränssnittet har ändrats, enligt följande skärmbild:

   

Azure CLI

Använd följande steg för att verifiera:

1. Använd följande kommando för att köra frågor mot körningsresultatet med hjälp av jobbnamnet och dess körningsnamn:

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

   Jobbloggen som strömmar jobbkörningen bör se ut ungefär som i följande exempel:

   [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. Använd följande kommando för att hämta appens football-billboard slutpunkt:

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

3. Öppna appens offentliga slutpunkt i ett webbläsarfönster för att se användargränssnittet för affischtavlor. Låt appen vara öppen.

   

4. Använd följande kommando för att starta jobbet igen:

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

5. Gå tillbaka till slutpunktssidan i webbläsaren och välj Uppdatera för att se att användargränssnittet har ändrats, enligt följande skärmbild:

   

7. Rensa resurser

Se till att ta bort de resurser som du skapade i den här artikeln när du inte längre behöver dem. Du kan ta bort den Azure-resursgrupp som innehåller alla resurser i resursgruppen.

Azure-portalen

Använd följande steg för att ta bort hela resursgruppen, inklusive den nyligen skapade tjänstinstansen:

1. Leta reda på resursgruppen på Azure Portal. På navigeringsmenyn väljer du Resursgrupper och sedan namnet på resursgruppen.

2. På sidan Resursgrupp väljer du Ta bort. Ange namnet på resursgruppen i textrutan för att bekräfta borttagningen och välj sedan Ta bort.

Azure CLI

Använd följande kommando för att ta bort hela resursgruppen, inklusive den nyligen skapade tjänstinstansen:

az group delete --name ${RESOURCE_GROUP}

8. Nästa steg

Mer information finns i följande artiklar:

• Azure Spring Apps-exempel.
• Azure for Spring-utvecklare
• Dokumentation om Spring Cloud Azure