Bereitstellen von Spring Boot-Anwendungen über die Azure CLI

Artikel
12/04/2024

Hinweis

Die Pläne Basic, Standard und Enterprise gelten ab Mitte März 2025 als veraltet und werden über einen Zeitraum von drei Jahren eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie in der Ankündigung zur Einstellung von Azure Spring Apps.

Der Plan Standardverbrauch und dediziert gilt ab dem 30. September 2024 als veraltet und wird nach sechs Monaten vollständig eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie unter Migrieren des Plans „Standardverbrauch und dediziert“ von Azure Spring Apps zu Azure Container Apps.

Dieser Artikel gilt für:✅️ Java ❎ C#

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

Azure Spring Apps ermöglicht die Erstellung von Spring Boot-Anwendungen in Azure.

Sie können Anwendungen direkt aus dem Java-Quellcode oder über eine vorgefertigte JAR-Datei starten. In diesem Artikel werden die Bereitstellungsverfahren erläutert.

Voraussetzungen

Stellen Sie vor dem Beginn sicher, dass Ihr Azure-Abonnement über die erforderlichen Abhängigkeiten verfügt:

Tipp

Azure Cloud Shell ist eine kostenlose interaktive Shell, mit der Sie die Schritte in diesem Artikel ausführen können. Sie verfügt über allgemeine vorinstallierte Azure-Tools, u. a. die aktuellen Versionen von Git, JDK, Maven und der Azure-Befehlszeilenschnittstelle. Wenn Sie bei Ihrem Azure-Abonnement angemeldet sind, starten Sie Azure Cloud Shell über shell.azure.com. Weitere Informationen zu Azure Cloud Shell finden Sie in der Dokumentation.

Installieren der Erweiterung für die Azure-Befehlszeilenschnittstelle

Führen Sie den folgenden Befehl aus, um die Azure Spring Apps-Erweiterung für die Azure CLI zu installieren:

az extension add --name spring

Bereitstellen einer Dienstinstanz mithilfe der Azure-Befehlszeilenschnittstelle

Melden Sie sich bei der Azure CLI an, und wählen Sie Ihr aktives Abonnement aus.

az login
az account list -o table
az account set --subscription <subscription-id>

Erstellen Sie eine Ressourcengruppe für Ihren Dienst in Azure Spring Apps. Informieren Sie sich weiter über Azure-Ressourcengruppen.

az group create --location eastus --name <resource-group-name>

Führen Sie die folgenden Befehle aus, um eine Instanz von Azure Spring Apps bereitzustellen. Bereiten Sie einen Namen für Ihren Dienst in Azure Spring Apps vor. 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.

az spring create --resource-group <resource-group-name> --name <resource-name>

Die Bereitstellung der Dienstinstanz dauert ungefähr fünf Minuten.

Legen Sie den Standardnamen für die Ressourcengruppe und für die Azure Spring Apps-Instanz mithilfe der folgenden Befehle fest:

az config set defaults.group=<service-group-name>
az config set defaults.spring=<service-instance-name>

Erstellen der Anwendung in Azure Spring Apps

Mit dem folgenden Befehl erstellen Sie eine Anwendung in Azure Spring Apps in Ihrem Abonnement. Damit wird ein leerer Dienst erstellt, in den Sie Ihre Anwendung hochladen können.

az spring app create --name <app-name>

Bereitstellen der Spring Boot-Anwendung

Sie können Ihre Anwendung über eine vorkonfigurierte JAR-Datei oder ein Gradle- oder Maven-Repository bereitstellen. Im Folgenden finden Sie Anweisungen für die einzelnen Fälle.

Bereitstellen einer vorgefertigten JAR-Datei

Stellen Sie zum Bereitstellen aus einer auf Ihrem lokalen Computer erstellten JAR-Datei sicher, dass der Build eine fat-JAR-Datei erzeugt.

So stellen Sie die fat-JAR-Datei für eine aktive Bereitstellung bereit

az spring app deploy --name <app-name> --artifact-path <path-to-fat-JAR>

So stellen Sie die fat-JAR-Datei für eine bestimmte Bereitstellung bereit

az spring app deployment create --app <app-name> \
    --name <deployment-name> \
    --artifact-path <path-to-fat-JAR>

Bereitstellen aus dem Quellcode

Azure Spring Apps verwendet kpack, um Ihr Projekt zu erstellen. Sie können mithilfe der Azure-Befehlszeilenschnittstelle Ihren Quellcode hochladen, das Projekt mit kpack erstellen und es in der Zielanwendung bereitstellen.

Warnung

Das Projekt darf nur eine JAR-Datei mit einem main-class-Eintrag in der Datei MANIFEST.MF in target (für Maven-Bereitstellungen) oder build/libs (für Gradle-Bereitstellungen) erzeugen. Wenn mehrere JAR-Dateien mit main-class-Einträgen vorhanden sind, führt die Bereitstellung zu einem Fehler.

Für Maven-/Gradle-Projekte mit einem Modul:

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path

Für Maven-/Gradle-Projekte mit mehreren Modulen wiederholen Sie diesen Schritt für jedes Modul:

cd <path-to-maven-or-gradle-source-root>
az spring app deploy --name <app-name> --source-path \
    --target-module <relative-path-to-module>

Anzeigen von Bereitstellungsprotokollen

Sie überprüfen die kpack-Buildprotokolle mit dem folgenden Befehl:

az spring app show-deploy-log --name <app-name>

Hinweis

In den kpack-Protokollen wird nur die letzte Bereitstellung angezeigt, wenn diese Bereitstellung aus dem Quellcode mithilfe von kpack erstellt wurde.

Zuweisen eines öffentlichen Endpunkts zu einer Anwendung

Öffnen Sie den Bereich Apps, um die Apps für Ihre Dienstinstanz anzuzeigen.
Wählen Sie eine Anwendung aus, um die zugehörige Übersichtsseite anzuzeigen.
Wählen Sie Endpunkt zuweisen aus, um der Anwendung einen öffentlichen Endpunkt zuzuweisen. Dieser Vorgang kann einige Minuten dauern.
Kopieren Sie die URL von der Übersichtsseite, und fügen Sie sie in Ihren Browser ein, um die ausgeführte Anwendung anzuzeigen.

Nächste Schritte

Schnellstart: Überwachen von Azure Spring Apps mit Protokollen, Metriken und Ablaufverfolgung

Weitere Beispiele finden Sie auf GitHub: Azure Spring Apps-Beispiele.

Freigeben über