Rychlý start: Nasazení první aplikace Spring Batch do Azure Spring Apps

Poznámka:

Plány Basic, Standard a Enterprise budou od poloviny března 2025 vyřazeny ze 3letého období vyřazení. Doporučujeme přejít na Azure Container Apps. Další informace najdete v oznámení o vyřazení Azure Spring Apps.

Od 30. září 2024 bude od 30. září 2024 zastaralý plán s úplným vypnutím po šesti měsících. Doporučujeme přejít na Azure Container Apps. Další informace najdete v tématu Migrace spotřeby Azure Spring Apps Úrovně Standard a vyhrazeného plánu do Azure Container Apps.

V tomto rychlém startu se dozvíte, jak nasadit dočasné aplikace Spring Batch do Azure Spring Apps. Ukázkový projekt je odvozený z ukázkové úlohy fotbalu Spring Batch. Jedná se o úlohu načítání statistik. V původní ukázce spustí test jednotek úlohu. V přizpůsobené ukázce metoda main FootballJobApplication inicializuje úlohu.

Tento článek se vztahuje na: ❎ Basic/Standard ✅ Enterprise

Následující diagram znázorňuje architekturu systému:

Tento článek obsahuje následující možnosti nasazení do Azure Spring Apps:

• Možnost webu Azure Portal je nejjednodušší a nejrychlejší způsob, jak vytvářet prostředky a nasazovat aplikace jediným kliknutím. Tato možnost je vhodná pro vývojáře Springu, kteří chtějí rychle nasazovat aplikace do cloudových služeb Azure.
• Možnost Azure CLI používá k správě prostředků Azure výkonný nástroj příkazového řádku. Tato možnost je vhodná pro vývojáře Springu, kteří jsou obeznámeni s cloudovými službami Azure.

1. Požadavky

Azure Portal

• Předplatné Azure. Pokud předplatné nemáte, vytvořte si před zahájením bezplatný účet .
• Git
• Pokud nasazujete instanci plánu Azure Spring Apps Enterprise poprvé v cílovém předplatném, přečtěte si část Požadavky plánu Enterprise na Azure Marketplace.

Azure CLI

• Předplatné Azure. Pokud předplatné nemáte, vytvořte si před zahájením bezplatný účet .
• Git
• Java Development Kit (JDK) verze 17.
• Azure CLI verze 2.55.0 nebo vyšší K instalaci rozšíření Azure Spring Apps použijte následující příkazy: az extension add --name spring.
• Pokud nasazujete instanci plánu Azure Spring Apps Enterprise poprvé v cílovém předplatném, přečtěte si část Požadavky plánu Enterprise na Azure Marketplace.

2. Příprava projektu Spring

Pomocí následujícího příkazu naklonujte ukázkový projekt z GitHubu:

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

3. Příprava cloudového prostředí

Hlavním prostředkem potřebným ke spuštění této ukázky je instance Azure Spring Apps. Tato část obsahuje kroky k vytvoření tohoto prostředku.

Azure Portal

3.1. Přihlaste se k portálu Azure Portal.

Přejděte na web Azure Portal a zadejte svoje přihlašovací údaje pro přihlášení k portálu. Výchozím zobrazením je váš řídicí panel služby.

3.2. Vytvoření instance Azure Spring Apps

Pomocí následujících kroků vytvořte instanci služby Azure Spring Apps:

1. V rohu webu Azure Portal vyberte Vytvořit prostředek .

2. Vyberte Compute>Azure Spring Apps.

3. Vyplňte formulář Základy s následujícími informacemi:

   Nastavení	Navrhovaná hodnota	Popis
   Předplatné	Název vašeho předplatného	Předplatné Azure, které chcete použít pro váš server. Pokud máte více předplatných, zvolte předplatné, ve kterém chcete prostředek fakturovat.
   Skupina prostředků	myresourcegroup	Název nové skupiny prostředků nebo některé ze stávajících ve vašem předplatném.
   Název	myasa	Jedinečný název, který identifikuje vaši službu Azure Spring Apps. Název musí mít délku 4 až 32 znaků a může obsahovat jenom malá písmena, číslice a pomlčky. První znak názvu služby musí být písmeno a poslední znak musí být písmeno nebo číslo.
   Plán	Enterprise	Cenový plán, který určuje prostředek a náklady spojené s vaší instancí.
   Oblast	Oblast, která je nejblíže vašim uživatelům.	Umístění co nejblíže vašim uživatelům.
   Zónově redundantní	Nevybráno	Možnost vytvoření služby Azure Spring Apps v zóně dostupnosti Azure Tato funkce se v současné době nepodporuje ve všech oblastech.
   Plán softwarových IP adres	Průběžné platby	Cenový plán, který vám umožní platit při přechodu pomocí Azure Spring Apps.
   Termíny	Selected	Zaškrtávací políčko smlouvy přidružené k nabídce Marketplace. Toto políčko musíte zaškrtnout.
   Nasazení ukázkového projektu	Nevybráno	Možnost použít předdefinované ukázkové aplikace.

4. Výběrem možnosti Zkontrolovat a Vytvořit zkontrolujte vybrané možnosti. Pak vyberte Vytvořit a zřiďte instanci Azure Spring Apps.

5. Pokud chcete monitorovat proces nasazení, na panelu nástrojů vyberte ikonu Oznámení (zvonek). Po dokončení nasazení můžete vybrat Připnout na řídicí panel, který vytvoří dlaždici pro tuto službu na řídicím panelu webu Azure Portal jako zástupce na stránce Přehled služby.

   

6. Výběrem možnosti Přejít k prostředku přejděte na stránku Přehled služby Azure Spring Apps.

3.3. Povolení registru služby

Přejděte do instance Azure Spring Apps, kterou jste vytvořili, rozbalte spravované komponenty v navigačním podokně a pak vyberte Registr služeb. Potom na stránce Přehled vyberte Spravovat a otevřete stránku Spravovat, vyberte Povolit registr služeb a pak vyberte Použít.

3.4. Nastavení pracovního prostoru Log Analytics

Informace o dotazování dat v protokolech najdete v tématu Rychlý start: Nastavení pracovního prostoru služby Log Analytics.

Azure CLI

3.1. Zadejte názvy jednotlivých prostředků.

Pomocí následujících příkazů vytvořte proměnné, které budou obsahovat názvy prostředků. Zástupné symboly nezapomeňte nahradit vlastními hodnotami.

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

3.2. Vytvoření nové skupiny prostředků

Pomocí následujících kroků vytvořte novou skupinu prostředků:

1. Pomocí následujícího příkazu se přihlaste k Azure CLI:

   az login
   

2. K nastavení výchozího umístění použijte následující příkaz:

   az configure --defaults location=${LOCATION}
   

3. Pomocí následujícího příkazu vypíšete všechna dostupná předplatná a určíte ID předplatného, které se má použít:

   az account list --output table
   

4. K nastavení výchozího předplatného použijte následující příkaz:

   az account set --subscription <subscription-ID>
   

5. Pomocí následujícího příkazu vytvořte skupinu prostředků:

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

6. Pomocí následujícího příkazu nastavte nově vytvořenou skupinu prostředků jako výchozí skupinu prostředků:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Vytvoření instance Azure Spring Apps

Azure Spring Apps se používá k hostování webové aplikace Spring. Pomocí následujících kroků vytvořte instanci Azure Spring Apps a aplikaci v ní:

1. Pomocí následujícího příkazu vytvořte instanci služby Azure Spring Apps a povolte registr služby:

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

2. Pomocí následujícího příkazu ověřte, že se instance služby plánu Azure Spring Apps Enterprise úspěšně vytvořila:

   az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
   

4. Nasazení aplikace football-patriot do Azure Spring Apps

Azure Portal

K nasazení aplikace použijte následující postup:

1. Přejděte do instance Azure Spring Apps, kterou jste vytvořili, rozbalte nastavení v navigačním podokně a pak vyberte Aplikace.

2. V podokně Aplikace vyberte Vytvořit aplikaci a otevřete stránku Vytvořit aplikaci .

3. Nastavte název aplikace na fotbalový graf, ve sloupci Vytvořit vyberte Registr služby a pak vyberte Vytvořit.

   

4. Po vytvoření aplikace vyberte Nasadit aplikaci a zkopírujte příkaz Azure CLI pro nasazení aplikace. Potom otevřete okno Bash a vložte příkaz do příkazového řádku a nahraďte cestu artefaktu správnou hodnotou pro váš systém. Pak spusťte příkaz. Počkejte několik minut, dokud se sestavení a nasazení nepodaří. Příkaz a výstup by měly vypadat podobně jako v následujícím příkladu:

   $ 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. Po nasazení se vraťte do podokna Aplikace a vyberte football-billboard aplikaci. Pak přejděte na stránku přehledu a vyberte Přiřadit koncový bod , aby se veřejný koncový bod aplikace zpřístupnil.

Azure CLI

K nasazení aplikace použijte následující postup:

1. Pomocí následujícího příkazu přejděte do složky ukázkového projektu z kořenové složky úložiště:

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

2. Pomocí následujícího příkazu vytvořte aplikaci v instanci Azure Spring Apps a vytvořte vazbu registru služby:

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

3. K nasazení aplikace použijte následující příkaz:

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

5. Nasazení ukázky úlohy do Azure Spring Apps

Tato část obsahuje kroky pro nasazení ukázky.

Azure Portal

5.1. Vytvoření a spuštění úlohy

Pomocí následujících kroků vytvořte a spusťte úlohu:

1. Přejděte do podokna Úlohy a vyberte Vytvořit úlohu. Vyplňte název úlohy jako football. Nakonfigurujte parametry úlohy, jako je paralelismus, limit opakování a časový limit. Podle potřeby přidejte proměnné prostředí a tajné proměnné prostředí. Po potvrzení vyberte Vytvořit.

   

2. Po vytvoření úlohy rozbalte spravované komponenty v navigačním podokně a vyberte Registr služeb. Pak vyberte vazbu úlohy, vyberte Vytvořit úlohu vazby a vyberte úlohu fotbalu a pak vyberte Použít pro vazbu.

   

3. Po vytvoření vazby úlohy se vraťte do podokna Úlohy , vyberte Nasadit úlohu a pak zkopírujte příkaz Azure CLI pro nasazení úlohy. Potom otevřete okno Bash a vložte příkaz do příkazového řádku a nahraďte cestu artefaktu správnou hodnotou pro váš systém. Pak spusťte příkaz. Počkejte několik minut, dokud se sestavení a nasazení nepodaří. Příkaz a výstup by měly vypadat podobně jako v následujícím příkladu:

   $ 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. Po nasazení otevřete stránku přehledu football úlohy výběrem názvu úlohy. Výběrem možnosti Spustit zahájíte provádění úlohy. Každé spuštění úlohy můžete přizpůsobit pomocí různých parametrů, například proměnných prostředí, nebo stačí vybrat Spustit , aby se spuštění aktivovalo. Zpráva indikuje, že úloha je spuštěná.

   

Azure CLI

5.1. Vytvoření a spuštění úlohy

Pomocí následujících kroků vytvořte a spusťte úlohu:

1. Pomocí následujícího příkazu přejděte do složky ukázkového projektu ze složky football-patriot , kde jste skončili dříve:

   cd ..
   cd football
   

2. Pomocí následujícího příkazu vytvořte úlohu v instanci Azure Spring Apps a vytvořte vazbu registru služby:

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

3. Pomocí následujícího příkazu nasaďte football ukázkový projekt do úlohy. Tento příkaz nahraje a zkompiluje zdrojový kód v Azure a připraví ho ke spuštění.

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

4. Pomocí následujícího příkazu spusťte úlohu a nastavte EXECUTION_NAME proměnnou na název spuštění úlohy:

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

6. Zkontrolujte výsledek provedení úlohy a uživatelské rozhraní pro aplikaci Ui pro aplikaci Ui

Teď můžete získat přístup ke spuštění úlohy a zkontrolovat její výsledek.

Azure Portal

K ověření použijte následující postup:

1. V podokně Provádění zkontrolujte výsledek spuštění úlohy. Počkejte několik sekund a aktualizujte, abyste viděli, že se stav změní na Dokončeno. Tato hodnota znamená, že provádění úlohy se úspěšně dokončí.

2. Vyberte Zobrazit protokoly a dotazujte se na protokoly provádění úlohy.

   

3. Otevřete veřejný koncový bod aplikace v okně prohlížeče a podívejte se na uživatelské rozhraní microsoftu microsoftu. Nechte aplikaci otevřenou.

   

4. Vraťte se na stránku přehledu football úlohy a vyberte Spustit , aby se spuštění aktivovalo znovu.

5. Vraťte se na stránku koncového bodu v prohlížeči a výběrem možnosti Aktualizovat zobrazte změněné uživatelské rozhraní, jak je znázorněno na následujícím snímku obrazovky:

   

Azure CLI

K ověření použijte následující postup:

1. Pomocí následujícího příkazu zadejte dotaz na výsledek spuštění pomocí názvu úlohy a jejího názvu spuštění:

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

   Streamování protokolu úloh by mělo vypadat podobně jako v následujícím příkladu:

   [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. Pomocí následujícího příkazu načtěte koncový bod football-billboard aplikace:

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

3. Otevřete veřejný koncový bod aplikace v okně prohlížeče a podívejte se na uživatelské rozhraní microsoftu microsoftu. Nechte aplikaci otevřenou.

   

4. Znovu spusťte úlohu pomocí následujícího příkazu:

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

5. Vraťte se na stránku koncového bodu v prohlížeči a výběrem možnosti Aktualizovat zobrazte změněné uživatelské rozhraní, jak je znázorněno na následujícím snímku obrazovky:

   

7. Vyčištění prostředků

Pokud už je nepotřebujete, nezapomeňte odstranit prostředky, které jste vytvořili v tomto článku. Můžete odstranit skupinu prostředků Azure, což zahrnuje odstranění všech prostředků v této skupině prostředků.

Azure Portal

Pomocí následujících kroků odstraňte celou skupinu prostředků, včetně nově vytvořené instance služby:

1. Vyhledejte skupinu prostředků na webu Azure Portal. V navigační nabídce vyberte Skupiny prostředků a pak vyberte název vaší skupiny prostředků.

2. Na stránce Skupina prostředků vyberte Odstranit. Do textového pole zadejte název skupiny prostředků, abyste potvrdili odstranění, a pak vyberte Odstranit.

Azure CLI

Pomocí následujícího příkazu odstraňte celou skupinu prostředků, včetně nově vytvořené instance služby:

az group delete --name ${RESOURCE_GROUP}

8. Další kroky

Další informace najdete v následujících článcích:

• Ukázky Azure Spring Apps
• Azure for Spring Developers
• Dokumentace ke Službě Spring Cloud v Azure