Schnellstart: Erstellen und Bereitstellen von Apps in Azure Spring Apps

Hinweis

Die Pläne "Basic", "Standard" und "Enterprise" sind am 17. März 2025 in einen Ruhestandszeitraum eingetreten. Weitere Informationen finden Sie in der Ankündigung zur Ausmusterung von Azure Spring Apps.

Dieser Artikel gilt für:✅ Basic/Standard ❎ Enterprise

In dieser Schnellstartanleitung wird erläutert, wie Sie Spring-Anwendungen mithilfe der Azure CLI erstellen und in Azure Spring Apps bereitstellen.

Voraussetzungen

Abschluss der vorherigen Schnellstartanleitungen in dieser Serie:
- Bereitstellen einer Azure Spring Apps-Dienstinstanz.
- Einrichten von Azure Spring Apps Config Server.

Herunterladen der Beispiel-App

Verwenden Sie die folgenden Schritte, um die Beispiel-App herunterzuladen. Wenn Sie bisher Azure Cloud Shell verwendet haben, wechseln Sie zu einer lokalen Eingabeaufforderung.

Erstellen Sie einen neuen Ordner, und klonen Sie das Beispiel-App-Repository.

mkdir source-code

cd source-code

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

Navigieren Sie zum Repositoryverzeichnis.
```
cd azure-spring-apps-samples
```

Bereitstellen von PlanetWeatherProvider

Führen Sie die folgenden Schritte aus, um das PlanetWeatherProvider-Projekt bereitzustellen.

Erstellen Sie in Ihrer Azure Spring Apps-Instanz eine App für das PlanetWeatherProvider-Projekt.
```
az spring app create --name planet-weather-provider --runtime-version NetCore_31
```
Um die automatische Dienstregistrierung zu aktivieren, haben Sie der App den gleichen Namen geben wie den Wert von spring.application.name in der Datei appsettings.json des Projekts:
```
"spring": {
  "application": {
    "name": "planet-weather-provider"
  }
}
```
Die Ausführung dieses Befehls kann einige Minuten in Anspruch nehmen.
Wechseln Sie in das Verzeichnis des Projektordners PlanetWeatherProvider.
```
cd steeltoe-sample/src/planet-weather-provider
```
Erstellen Sie die Binärdateien und die ZIP-Datei, die bereitgestellt werden sollen.
```
dotnet publish -c release -o ./publish
```
Tipp

Die Projektdatei enthält den folgenden XML-Code zum Verpacken der Binärdateien in einer ZIP-Datei, nachdem diese in den Ordner ./publish geschrieben wurden:
```
<Target Name="Publish-Zip" AfterTargets="Publish">
  <ZipDirectory SourceDirectory="$(PublishDir)" DestinationFile="$(MSBuildProjectDirectory)/publish-deploy-planet.zip" Overwrite="true" />
</Target>
```
Stellen Sie das Projekt in Azure bereit.

Stellen Sie sicher, dass sich die Eingabeaufforderung im Projektordner befindet, bevor Sie den folgenden Befehl ausführen.
```
az spring app deploy \
    --name planet-weather-provider \
    --runtime-version NetCore_31 \
    --main-entry Microsoft.Azure.SpringCloud.Sample.PlanetWeatherProvider.dll \
    --artifact-path ./publish-deploy-planet.zip
```
Die Option --main-entry gibt den relativen Pfad vom Stammordner der ZIP-Datei zur DLL-Datei an, die den Einstiegspunkt der Anwendung enthält. Nachdem der Dienst die ZIP-Datei hochgeladen hat, werden alle Dateien und Ordner extrahiert, und es wird versucht, den Einstiegspunkt in der angegebenen DLL-Datei auszuführen.

Die Ausführung dieses Befehls kann einige Minuten in Anspruch nehmen.

Bereitstellen von SolarSystemWeather

Führen Sie die folgenden Schritte aus, um das SolarSystemWeather-Projekt bereitzustellen.

Erstellen Sie in Ihrer Azure Spring Apps-Instanz eine weitere App für das Projekt.
```
az spring app create --name solar-system-weather --runtime-version NetCore_31
```
solar-system-weather ist der Name, der in der Datei SolarSystemWeather des Projekts angegeben ist.

Die Ausführung dieses Befehls kann einige Minuten in Anspruch nehmen.
Wechseln Sie in das Verzeichnis des Projekts SolarSystemWeather.
```
cd ../solar-system-weather
```
Erstellen Sie die Binärdateien und die ZIP-Datei, die bereitgestellt werden sollen.
```
dotnet publish -c release -o ./publish
```

Stellen Sie das Projekt in Azure bereit.

az spring app deploy \
    --name solar-system-weather \
    --runtime-version NetCore_31 \
    --main-entry Microsoft.Azure.SpringCloud.Sample.SolarSystemWeather.dll \
    --artifact-path ./publish-deploy-solar.zip

Die Ausführung dieses Befehls kann einige Minuten in Anspruch nehmen.

Zuweisen eines öffentlichen Endpunkts

Rufen Sie vor dem Testen der Anwendung einen öffentlichen Endpunkt für eine HTTP GET-Anforderung an die solar-system-weather-Anwendung ab.

Führen Sie den folgenden Befehl aus, um den Endpunkt zuzuweisen.

az spring app update --name solar-system-weather --assign-endpoint true

Führen Sie zum Abrufen der URL des Endpunkts den folgenden Befehl aus.

Windows:

az spring app show --name solar-system-weather --output table

Linux:

az spring app show --name solar-system-weather | grep url

Testen der Anwendung

Senden Sie zum Testen der Anwendung eine GET-Anforderung an die solar-system-weather-App. Navigieren Sie in einem Browser zu der öffentlichen URL, an die Sie /weatherforecast angefügt haben. Beispiel: https://servicename-solar-system-weather.azuremicroservices.io/weatherforecast

Die Ausgabe liegt im JSON-Format vor:

[{"Key":"Mercury","Value":"very warm"},{"Key":"Venus","Value":"quite unpleasant"},{"Key":"Mars","Value":"very cool"},{"Key":"Saturn","Value":"a little bit sandy"}]

Diese Antwort zeigt, dass beide Spring-Apps funktionieren. Die App SolarSystemWeather gibt Daten zurück, die sie aus der App PlanetWeatherProvider abgerufen hat.

In diesem Artikel wird erläutert, wie Sie Spring-Anwendungen erstellen und in Azure Spring Apps bereitstellen. Sie können Azure CLI, das Maven-Plug-In oder IntelliJ verwenden. In diesem Artikel werden alle diese Alternativen beschrieben.

Voraussetzungen

Abschluss der vorherigen Schnellstartanleitungen in dieser Serie:
- Bereitstellen einer Azure Spring Apps-Dienstinstanz.
- Einrichten von Azure Spring Apps Config Server.
JDK 17
Maven 3.0 oder höher
Ein Azure-Abonnement. Wenn Sie kein Abonnement besitzen, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.
Optional Azure CLI, Version 2.45.0 oder höher. Führen Sie den folgenden Befehl aus, um die Azure Spring Apps-Erweiterung zu installieren: az extension add --name spring
Optional, das Azure-Toolkit für IntelliJ.

Lokales Erstellen der Spring-Anwendungen

Verwenden Sie die folgenden Befehle, um das Beispielrepository zu klonen, zum Beispielordner zu navigieren und dann das Projekt zu erstellen.

git clone https://github.com/azure-samples/spring-petclinic-microservices
cd spring-petclinic-microservices
mvn clean package -DskipTests -Denv=cloud

Die Kompilierung des Projekts dauert fünf bis zehn Minuten. Nach der Kompilierung des Projekts sollten in den entsprechenden Ordner einzelne JAR-Dateien für jeden Dienst vorhanden sein.

Erstellen und Bereitstellen von Apps in Azure Spring Apps

Führen Sie die folgenden Schritte aus, um Apps in Azure Spring Apps zu erstellen und mithilfe der CLI bereitzustellen.

Falls Sie die folgenden Befehle in den vorherigen Schnellstartanleitungen nicht ausgeführt haben, führen Sie sie jetzt aus, um die CLI-Standardwerte festzulegen.
```
az configure --defaults group=<resource-group-name> spring=<service-name>
```

Erstellen Sie die zwei zentralen Spring-Anwendungen für PetClinic: api-gateway und customers-service.

az spring app create \
    --name api-gateway \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi \
    --assign-endpoint
az spring app create \
    --name customers-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi

Stellen Sie die im vorherigen Schritt erstellten JAR-Dateien bereit.

az spring app deploy \
    --name api-gateway \
    --artifact-path spring-petclinic-api-gateway/target/api-gateway-3.0.1.jar \
    --jvm-options="-Xms2048m -Xmx2048m"
az spring app deploy \
    --name customers-service \
    --artifact-path spring-petclinic-customers-service/target/customers-service-3.0.1.jar \
    --jvm-options="-Xms2048m -Xmx2048m"

Fragen Sie den App-Status nach der Bereitstellung mit dem folgenden Befehl ab.

az spring app list --output table

Dieser Befehl erzeugt eine Ausgabe ähnlich wie im folgenden Beispiel:

Name               Location    ResourceGroup    Production Deployment    Public Url                                           Provisioning Status    CPU    Memory    Running Instance    Registered Instance    Persistent Storage
-----------------  ----------  ---------------  -----------------------  ---------------------------------------------------  ---------------------  -----  --------  ------------------  ---------------------  --------------------
api-gateway        eastus      xxxxxx-sp         default                  https://<service name>-api-gateway.azuremicroservices.io   Succeeded              1      2         1/1                 1/1                    -
customers-service  eastus      <service name>         default                                                                       Succeeded              1      2         1/1                 1/1                    -

Überprüfen der Dienste

Greifen Sie in einem Browser über die zuvor gezeigte api-gateway im Format customers-service auf und https://<service name>-api-gateway.azuremicroservices.io zu.

Tipp

Zum Beheben von Problemen bei der Bereitstellung können Sie den folgenden Befehl verwenden, um Protokollstreaming in Echtzeit zu erhalten, wenn die App ausgeführt wird: az spring app logs --name <app name> --follow.

Bereitstellen zusätzlicher Apps

Damit die PetClinic-App mit allen Features wie Verwaltungsserver, Besuche und Tierärzte funktioniert, stellen Sie die anderen Apps mit den folgenden Befehlen bereit:

az spring app create \
    --name admin-server \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi \
    --assign-endpoint
az spring app create \
    --name vets-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi
az spring app create \
    --name visits-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi
az spring app deploy \
    --name admin-server \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-admin-server/target/admin-server-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"
az spring app deploy \
    --name vets-service \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-vets-service/target/vets-service-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"
az spring app deploy \
    --name visits-service \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-visits-service/target/visits-service-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"

Lokales Erstellen der Spring-Anwendungen

Verwenden Sie die folgenden Befehle, um das Beispielrepository zu klonen, zum Beispielordner zu navigieren und dann das Projekt zu erstellen.

git clone https://github.com/azure-samples/spring-petclinic-microservices
cd spring-petclinic-microservices
mvn clean package -DskipTests -Denv=cloud

Die Kompilierung des Projekts dauert fünf bis zehn Minuten. Nach der Kompilierung des Projekts sollten in den entsprechenden Ordner einzelne JAR-Dateien für jeden Dienst vorhanden sein.

Generieren von Konfigurationen und Bereitstellen in Azure Spring Apps

Die folgenden Schritte zeigen, wie Sie Konfigurationen generieren und in Azure Spring Apps bereitstellen:

Wechseln Sie zum Ordner spring-petclinic-customers-service. Führen Sie den folgenden Befehl aus, um Konfigurationen zu generieren. Wenn Sie sich bereits bei der Azure CLI angemeldet haben, werden die Anmeldeinformationen automatisch vom Befehl abgerufen. Andernfalls werden Sie mit einer Eingabeaufforderung mit Anweisungen angemeldet. Weitere Informationen finden Sie unter Authentifizierung im Wiki azure-maven-plugins .
```
mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config -DappName=customers-service
```
Sie werden aufgefordert, die folgenden Werte anzugeben:
- Abonnement: Das Abonnement, das Sie zum Erstellen einer Azure Spring Apps-Instanz verwendet haben.
- Dienstinstanz: Der Name Ihrer Azure Spring Apps-Instanz.
- Öffentlicher Endpunkt: Gibt an, ob der App ein öffentlicher Endpunkt zugewiesen werden soll. Wählen Sie also Nein.

Überprüfen Sie, ob die appName-Elemente in den POM-Dateien korrekt sind:

<build>
    <plugins>
        <plugin>
            <groupId>com.microsoft.azure</groupId>
            <artifactId>azure-spring-apps-maven-plugin</artifactId>
            <version>1.19.0</version>
            <configuration>
                <subscriptionId>xxxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx</subscriptionId>
                <clusterName>v-spr-cld</clusterName>
                <appName>customers-service</appName>

Das POM enthält jetzt die Plug-In-Abhängigkeiten und -Konfigurationen.

Stellen Sie die Apps mit dem folgenden Befehl bereit:
```
mvn azure-spring-apps:deploy
```
Wechseln Sie zum Ordner spring-petclinic-api-gateway. Führen Sie die folgenden Befehle aus, um die Konfiguration zu generieren und api-gateway bereitzustellen. Wählen Sie Ja für Öffentlicher Endpunkt aus.
```
mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config -DappName=api-gateway
mvn azure-spring-apps:deploy
```

Überprüfen der Dienste

Von einem erfolgreichen Bereitstellungsbefehl wird eine URL im folgenden Format zurückgegeben: https://<service name>-spring-petclinic-api-gateway.azuremicroservices.io. Navigieren Sie damit zum ausgeführten Dienst.

Sie können auch im Azure-Portal navigieren, um die URL zu suchen.

Navigieren Sie zum Dienst.
Wählen Sie Apps.
Wählen Sie api-gateway aus.
Suchen Sie auf der Seite api-gateway | Übersicht nach der URL.

Bereitstellen zusätzlicher Apps

Damit die PetClinic-App mit allen Abschnitten wie Verwaltungsserver, Besuche und Tierärzte funktioniert, können Sie die anderen Spring-Anwendungen bereitstellen. Führen Sie den Konfigurationsbefehl erneut aus, und wählen Sie die folgenden Spring-Anwendungen aus.

admin-server
vets-service
visits-service

Korrigieren Sie die App-Namen in jeder pom.xml-Datei für diese Module, und führen Sie dann erneut den Befehl deploy aus.

Importieren eines Beispielprojekts in IntelliJ

Führen Sie die folgenden Schritte aus, um das Beispielprojekt in IntelliJ zu importieren.

Laden Sie das Quellrepository für dieses Tutorial herunter, und entpacken Sie es, oder klonen Sie es mithilfe von Git: git clone https://github.com/azure-samples/spring-petclinic-microservices.
Öffnen Sie das IntelliJ-Dialogfeld Willkommen, und wählen Sie Projekt importieren aus, um den Import-Assistenten zu öffnen.
Wählen Sie den Ordner spring-petclinic-microservices aus.

Bereitstellen der App „api-gateway“ in Azure Spring Apps

Für die Bereitstellung in Azure müssen Sie sich mit Ihrem Azure-Konto beim Azure-Toolkit für IntelliJ anmelden und Ihr Abonnement auswählen. Informationen zu den Anmeldedetails finden Sie unter Erstellen einer „Hello World“-Web-App für Azure App Service mithilfe von IntelliJ.

Klicken Sie im Projektexplorer von IntelliJ mit der rechten Maustaste auf Ihr Projekt, und wählen Sie Azure –>In Azure Spring Apps bereitstellen aus.
Fügen Sie im Feld Name die Zeichenfolge :api-gateway an den vorhandenen Namen an.
Wählen Sie im Textfeld Artefakt die Option spring-petclinic-api-gateway-3.0.1 aus.
Überprüfen Sie im Textfeld Abonnement Ihr Abonnement.
Wählen Sie im Textfeld Spring Apps die Instanz von Azure Spring Apps aus, die Sie in Bereitstellen des Azure Spring Apps-Diensts erstellt haben.
Wählen Sie im Textfeld App: die Option App erstellen... aus.
Geben Sie api-gateway ein, und wählen Sie OK aus.
Legen Sie Öffentlicher Endpunkt auf Aktivieren fest.
Legen Sie Speicher auf 2.0Gi - und JVM-Optionen auf -Xms2048m -Xmx2048m fest.
Doppelklicken Sie im Abschnitt Before launch (Vor dem Start) des Dialogfelds auf Run Maven Goal (Maven-Ziel ausführen).
Navigieren Sie im Textfeld Arbeitsverzeichnis zum Ordner spring-petclinic-microservices/spring-petclinic-api-gateway.
Geben Sie im Textfeld Befehlszeile die Zeichenfolge package -DskipTests ein. Klicken Sie auf OK.
Starten Sie die Bereitstellung, indem Sie unten im Dialogfeld Azure Spring Apps-App bereitstellen die Schaltfläche Ausführen auswählen. Das Plug-In führt den Befehl mvn package für die App api-gateway aus, und stellt die vom package-Befehl generierte JAR-Datei bereit.

Bereitstellen der App „customers-service“ und weiterer Apps in Azure Spring Apps

Wiederholen Sie die oben beschriebenen Schritte, um customers-service und weitere Tierklinik-Apps in Azure Spring Apps bereitzustellen:

Ändern Sie die Werte für Name und Artefakt zur Identifizierung der App customers-service.
Wählen Sie im Textfeld App: die Option App erstellen... aus, um die App customers-service zu erstellen.
Vergewissern Sie sich, dass die Option Öffentlicher Endpunkt auf Deaktiviert festgelegt ist.
Stellen Sie im Abschnitt Before launch (Vor dem Start) des Dialogfelds das Arbeitsverzeichnis auf den Ordner petclinic/customers-service um.
Starten Sie die Bereitstellung, indem Sie unten im Dialogfeld Azure Spring Apps-App bereitstellen die Schaltfläche Ausführen auswählen.

Überprüfen der Dienste

Navigieren Sie zur URL im Format https://<service name>-spring-petclinic-api-gateway.azuremicroservices.io.

Sie können auch im Azure-Portal navigieren, um die URL zu suchen.

Navigieren Sie zum Dienst.
Wählen Sie Apps aus.
Wählen Sie api-gateway aus.
Suchen Sie auf der Seite api-gateway | Übersicht nach der URL.

Bereitstellen zusätzlicher Apps

Andere in diesem Beispiel enthaltene Spring-Anwendungen können auf ähnliche Weise bereitgestellt werden.

admin-server
vets-service
visits-service

Bereinigen von Ressourcen

Falls Sie mit weiteren Schnellstartanleitungen und Tutorials fortfahren möchten, sollten Sie die Ressourcen nicht bereinigen. Wenn Sie die Ressourcen nicht mehr benötigen, löschen Sie die Ressourcengruppe. Dadurch werden die Ressourcen in der Ressourcengruppe gelöscht. Wenn Sie die Ressourcengruppe mithilfe der Azure CLI löschen möchten, verwenden Sie die folgenden Befehle:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Nächste Schritte

Schnellstart: Einrichten eines Log Analytics-Arbeitsbereichs

Feedback

War diese Seite hilfreich?

Last updated on 2025-08-19

Freigeben über

Schnellstart: Erstellen und Bereitstellen von Apps in Azure Spring Apps

Voraussetzungen

Herunterladen der Beispiel-App

Bereitstellen von PlanetWeatherProvider

Bereitstellen von SolarSystemWeather

Zuweisen eines öffentlichen Endpunkts

Testen der Anwendung

Voraussetzungen

Lokales Erstellen der Spring-Anwendungen

Erstellen und Bereitstellen von Apps in Azure Spring Apps

Überprüfen der Dienste

Bereitstellen zusätzlicher Apps

Bereinigen von Ressourcen

Nächste Schritte

Feedback

Zusätzliche Ressourcen