Schnellstart: Bereitstellen Ihrer ersten Spring-Batch-App in Azure Spring Apps

• Ein Azure-Abonnement. Wenn Sie kein Abonnement besitzen, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.
• Git.
• Wenn Sie eine Instanz des Azure Spring Apps Enterprise-Plans zum ersten Mal im Zielabonnement bereitstellen, finden Sie Informationen hierzu im Abschnitt Voraussetzungen des Enterprise-Plans in Azure Marketplace.

• Ein Azure-Abonnement. Wenn Sie kein Abonnement besitzen, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.
• Git.
• Java Development Kit (JDK), Version 17.
• Azure-Befehlszeilenschnittstelle Version 2.55.0 oder höher Verwenden Sie die folgenden Befehle, um die Azure Spring Apps-Erweiterung zu installieren: az extension add --name spring.
• Wenn Sie eine Instanz des Azure Spring Apps Enterprise-Plans zum ersten Mal im Zielabonnement bereitstellen, finden Sie Informationen hierzu im Abschnitt Voraussetzungen des Enterprise-Plans in Azure Marketplace.

3.1. Melden Sie sich auf dem Azure-Portal an.

Wechseln Sie zum Azure-Portal und geben Sie Ihre Anmeldeinformationen ein, um sich beim Portal anzumelden. Die Standardansicht ist Ihr Dienstdashboard.

3.2. Erstellen einer Azure Spring Apps-Instanz

Gehen Sie wie folgt vor, um eine Azure Spring Apps-Dienstinstanz zu erstellen:

1. Wählen Sie in der Ecke des Azure-Portals Ressource erstellen aus.

2. Wählen Sie Compute>Azure Spring Apps aus.

3. Füllen Sie dann das Formular Grundlagen mit den folgenden Informationen aus:

   Einstellung	Vorgeschlagener Wert	BESCHREIBUNG
   Abonnement	Der Name Ihres Abonnements	Das Azure-Abonnement, das Sie für Ihren Server verwenden möchten. Falls Sie über mehrere Abonnements verfügen, wählen Sie das Abonnement aus, über das die Ressource abgerechnet werden soll.
   Ressourcengruppe	myresourcegroup	Ein neuer Ressourcengruppenname oder ein bereits vorhandener Name aus Ihrem Abonnement
   Name	myasa	Ein eindeutiger Name, der Ihren Azure Spring Apps-Dienst identifiziert. Der Name muss zwischen 4 und 32 Zeichen lang sein und darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten. Das erste Zeichen des Dienstnamens muss ein Buchstabe und das letzte Zeichen entweder ein Buchstabe oder eine Ziffer sein.
   Planen	Enterprise	Der Tarif, der die Ressource und die Kosten bestimmt, die mit Ihrer Instanz verbunden sind.
   Region	Die Region, die Ihren Benutzern am nächsten ist.	Der Standort, der Ihren Benutzern am nächsten ist.
   Zonenredundant	Nicht markiert	Die Option zum Erstellen Ihres Azure Spring Apps-Diensts in einer Azure-Verfügbarkeitszone. Dieses Feature wird derzeit nicht in allen Regionen unterstützt.
   Software-IP-Plan	Nutzungsbasierte Bezahlung	Der Preisplan, mit dem die nutzungsbasierte Bezahlung für Azure Spring Apps möglich ist.
   Terms	Ausgewählt	Kontrollkästchen „Vereinbarung“, das dem Marketplace-Angebot zugeordnet ist. Sie müssen dieses Kontrollkästchen aktivieren.
   Bereitstellen eines Beispielprojekts	Nicht markiert	Die Option zum Verwenden der integrierten Beispielanwendung.

4. Wählen Sie Überprüfen und erstellen aus, um ihre Auswahl zu überprüfen. Wählen Sie dann Erstellen aus, um die Azure Spring Apps-Instanz bereitzustellen.

5. Klicken Sie auf der Symbolleiste auf das Symbol Benachrichtigungen (eine Glocke), um den Bereitstellungsprozess zu überwachen. Nach Abschluss der Bereitstellung können Sie An Dashboard anheften auswählen, wodurch auf Ihrem Azure-Portal-Dashboard eine Kachel für diesen Dienst erstellt wird, die als Verknüpfung zur Seite Übersicht des Diensts fungiert.

   

6. Wählen Sie Zu Ressource wechseln aus, um zur Seite Übersicht für Azure Spring Apps zu wechseln.

3.3. Aktivieren der Dienstregistrierung

Navigieren Sie zu der Azure Spring Apps-Instanz, die Sie erstellt haben, erweitern Sie im Navigationsbereich Verwaltete Komponenten, und wählen Sie dann Dienstregistrierung aus. Wählen Sie dann auf der Übersichtsseite die Option Verwalten aus, um die Seite Verwalten zu öffnen, wählen Sie Dienstregistrierung aktivieren und dann Übernehmen aus.

3.4. Einrichten eines Log Analytics-Arbeitsbereichs

Weitere Informationen zum Abfragen der Daten in Protokollen finden Sie im Schnellstart: Einrichten eines Log Analytics-Arbeitsbereichs.

3.1. Geben Sie einen Namen für jede Ressource an.

Erstellen Sie Variablen zur Aufnahme der Ressourcennamen, indem Sie die folgenden Befehle verwenden. Ersetzen Sie die Platzhalter durch Ihre eigenen Werte.

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

3.2. Erstellen einer neuen Ressourcengruppe

Führen Sie die folgenden Schritte aus, um eine neue Ressourcengruppe zu erstellen:

1. Verwenden Sie den folgenden Befehl, um sich bei der Azure CLI anzumelden:

   az login
   

2. Verwenden Sie den folgenden Befehl, um den Standardspeicherort festzulegen:

   az configure --defaults location=${LOCATION}
   

3. Verwenden Sie den folgenden Befehl, um alle verfügbaren Abonnements aufzulisten, um die zu verwendende Abonnement-ID zu bestimmen:

   az account list --output table
   

4. Verwenden Sie den folgenden Befehl, um das Standardabonnement festzulegen:

   az account set --subscription <subscription-ID>
   

5. Verwenden Sie den folgenden Befehl, um eine Ressourcengruppe zu erstellen:

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

6. Verwenden Sie den folgenden Befehl, um die neu erstellte Ressourcengruppe als Standardressourcengruppe festzulegen:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Erstellen einer Azure Spring Apps-Instanz

Azure Spring Apps wird als Host für die Spring-Web-App verwendet. Führen Sie die folgenden Schritte aus, um eine Azure Spring Apps-Instanz mit einer darin enthaltenen Anwendung zu erstellen:

1. Verwenden Sie den folgenden Befehl, um eine Azure Spring Apps-Dienstinstanz zu erstellen und die Dienstregistrierung zu aktivieren:

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

2. Verwenden Sie den folgenden Befehl, um zu überprüfen, ob die Azure Spring Apps-Dienstinstanz im Enterprise-Plans erfolgreich erstellt wurde:

   az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
   

Führen Sie die folgenden Schritte aus, um die App bereitzustellen:

1. Navigieren Sie zu der Azure Spring Apps-Instanz, die Sie erstellt haben, erweitern Sie im Navigationsbereich Einstellungen, und wählen Sie dann Apps aus.

2. Wählen Sie im Bereich Apps die Option App erstellen aus, um die Seite App erstellen zu öffnen.

3. Legen Sie App-Name auf football-billboard fest, wählen Sie in der Spalte Binden die Option Dienstregistrierung und dann Erstellen aus.

   

4. Nachdem Sie die App erstellt haben, wählen Sie App bereitstellen aus, und kopieren Sie den Azure CLI-Befehl zum Bereitstellen der App. Öffnen Sie dann ein Bash-Fenster, und fügen Sie den Befehl in die Befehlszeile ein. Ersetzen Sie den Artefaktpfad durch den richtigen Wert für Ihr System. Führen Sie anschließend den Befehl aus. Warten Sie einige Minuten, bis Build und Bereitstellung erfolgreich abgeschlossen wurden. Der Befehl und die Ausgabe sollten ungefähr wie im folgenden Beispiel aussehen:

   $ 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. Wechseln Sie nach der Bereitstellung zurück zum Bereich Apps, und wählen Sie die football-billboard-App aus. Wählen Sie auf der Übersichtsseite die Option Endpunkt zuweisen aus, um den öffentlichen Endpunkt für die App verfügbar zu machen.

Führen Sie die folgenden Schritte aus, um die App bereitzustellen:

1. Verwenden Sie den folgenden Befehl, um vom Stammordner des Repositorys zum Ordner des Beispielprojekts zu navigieren:

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

2. Verwenden Sie den folgenden Befehl, um eine Anwendung in der Azure Spring Apps-Instanz zu erstellen und die Dienstregistrierung zu binden:

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

3. Verwenden Sie den folgenden Befehl, um die App bereitzustellen:

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

5.1. Erstellen und Ausführen des Auftrags

Führen Sie die folgenden Schritte aus, um den Auftrag zu erstellen und auszuführen:

1. Navigieren Sie zum Bereich Aufträge, und wählen Sie dann Auftrag erstellen aus. Geben Sie als Auftragsnamen football ein. Konfigurieren Sie die Auftragsparameter wie Parallelität, Wiederholungslimit und Timeout. Fügen Sie bei Bedarf Umgebungsvariablen und geheime Umgebungsvariablen hinzu. Wählen Sie nach der Bestätigung Erstellen aus.

   

2. Erweitern Sie nach dem Erstellen des Auftrags im Navigationsbereich die Option Verwaltete Komponenten, und wählen Sie Dienstregistrierung aus. Wählen Sie anschließend Auftragsbindung und dann Auftrag binden aus, um den Fußballauftrag auszuwählen, und wählen Sie dann Übernehmen, um eine Bindung zu erstellen.

   

3. Navigieren Sie zurück zum Bereich Aufgaben, nachdem Sie den Auftrag gebunden haben, wählen Sie Auftrag bereitstellen aus, und kopieren Sie dann den Azure CLI-Befehl zum Bereitstellen des Auftrags. Öffnen Sie dann ein Bash-Fenster, und fügen Sie den Befehl in die Befehlszeile ein. Ersetzen Sie den Artefaktpfad durch den richtigen Wert für Ihr System. Führen Sie anschließend den Befehl aus. Warten Sie einige Minuten, bis Build und Bereitstellung erfolgreich abgeschlossen wurden. Der Befehl und die Ausgabe sollten ungefähr wie im folgenden Beispiel aussehen:

   $ 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. Öffnen Sie nach der Bereitstellung die Übersichtsseite des football-Auftrags, indem Sie den Auftragsnamen auswählen. Wählen Sie Ausführen aus, um die Aufgabenausführung zu initiieren. Sie können jede Ausführung des Auftrags mit verschiedenen Parametern anpassen (z. B. Umgebungsvariablen) oder einfach Ausführen auswählen, um die Ausführung auszulösen. Sie werden in einer Meldung darüber informiert, dass der Auftrag ausgeführt wird.

   

5.1. Erstellen und Ausführen des Auftrags

Führen Sie die folgenden Schritte aus, um den Auftrag zu erstellen und auszuführen:

1. Verwenden Sie den folgenden Befehl, um aus dem Ordner football-billboard zum Ordner des Beispielprojekts zu navigieren, in dem Sie zuletzt aufgehört haben:

   cd ..
   cd football
   

2. Verwenden Sie den folgenden Befehl, um einen Auftrag in der Azure Spring Apps-Instanz zu erstellen und die Dienstregistrierung zu binden:

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

3. Verwenden Sie den folgenden Befehl, um das Beispielprojekt football für den Auftrag bereitzustellen. Dieser Befehl lädt den Quellcode in Azure hoch, kompiliert ihn und bereit ihn zum Starten vor.

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

4. Verwenden Sie den folgenden Befehl, um den Auftrag zu starten, und legen Sie die Variable EXECUTION_NAME auf den Auftragsausführungsnamen fest:

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

Verwenden Sie die folgenden Schritte zur Überprüfung:

1. Überprüfen Sie im Bereich Ausführungen das Ergebnis der Auftragsausführung. Warten Sie einige Sekunden, und aktualisieren Sie den Bereich, bis als Status Abgeschlossen angezeigt wird. Dieser Wert bedeutet, dass die Auftragsausführung erfolgreich abgeschlossen wurde.

2. Wählen Sie Protokolle anzeigen aus, um die Protokolle der Auftragsausführung abzufragen.

   

3. Öffnen Sie den öffentlichen Endpunkt der App in einem Browserfenster, um die Billboard-Benutzeroberfläche anzuzeigen. Lassen Sie die App geöffnet.

   

4. Wechseln Sie zurück zur Übersichtsseite des football-Auftrags, und wählen Sie Ausführen aus, um die Ausführung erneut auszulösen.

5. Navigieren Sie im Browser zurück zur Endpunktseite, und wählen Sie Aktualisieren aus, um die geänderte Benutzeroberfläche anzuzeigen, wie im folgenden Screenshot dargestellt:

   

Verwenden Sie die folgenden Schritte zur Überprüfung:

1. Verwenden Sie den folgenden Befehl, um das Ausführungsergebnis mithilfe des Auftragsnamens und des Ausführungsnamens abzufragen:

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

   Das Auftragsprotokollstreaming der Auftragsausführung sollte dem folgenden Beispiel ähneln:

   [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. Verwenden Sie den folgenden Befehl, um den Endpunkt der football-billboard-App abzurufen:

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

3. Öffnen Sie den öffentlichen Endpunkt der App in einem Browserfenster, um die Billboard-Benutzeroberfläche anzuzeigen. Lassen Sie die App geöffnet.

   

4. Verwenden Sie den folgenden Befehl, um den Auftrag erneut zu starten:

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

5. Navigieren Sie im Browser zurück zur Endpunktseite, und wählen Sie Aktualisieren aus, um die geänderte Benutzeroberfläche anzuzeigen, wie im folgenden Screenshot dargestellt:

   

Führen Sie die folgenden Schritte aus, um die gesamte Ressourcengruppe zu löschen, einschließlich der neu erstellten Dienstinstanz:

1. Navigieren Sie im Azure-Portal zu Ihrer Ressourcengruppe. Wählen Sie im Navigationsmenü Ressourcengruppen und dann den Namen Ihrer Ressourcengruppe aus.

2. Wählen Sie auf der Seite Ressourcengruppe die Option Löschen. Geben Sie den Namen Ihrer Ressourcengruppe in das Textfeld ein, um das Löschen zu bestätigen, und wählen Sie dann Löschen aus.

Führen Sie den folgenden Befehl aus, um die gesamte Ressourcengruppe einschließlich der neu erstellten Dienstinstanz zu löschen:

az group delete --name ${RESOURCE_GROUP}