Schnellstart: Bereitstellen Ihrer ersten Web-App in Azure Spring Apps
Artikel
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.
In dieser Schnellstartanleitung wird gezeigt, wie Sie eine Spring Boot-Web-App in Azure Spring Apps bereitstellen. Das Beispielprojekt ist eine einfache ToDo-App, mit der Aufgaben hinzugefügt, bei Abschluss markiert und anschließend gelöscht werden können. Der folgende Screenshot zeigt die App:
Diese App ist eine typische Web-App mit drei Ebenen:
Eine Back-End-Spring-Web-App, die Spring Data JPA für den Zugriff auf eine rationale Datenbank verwendet.
Eine relationale Datenbank. Für localhost verwendet die App die H2-Datenbank-Engine. Für Azure Spring Apps verwendet die App Azure Database for PostgreSQL. Weitere Informationen zu Azur Database for PostgreSQL finden Sie in der Dokumentation zu flexiblen Servern.
Das folgende Diagramm zeigt die Architektur des Systems:
Dieser Artikel enthält die folgenden Optionen für die Bereitstellung in Azure Spring Apps:
Die Azure-Portal-Option ist die einfachste und schnellste Möglichkeit, Ressourcen zu erstellen und Anwendungen mit einem einzigen Klick bereitzustellen. Diese Option eignet sich für Spring-Entwickler, die Anwendungen schnell in Azure Cloud Services bereitstellen möchten.
Die Azure-Portal + Maven-Plug-In-Option bietet eine herkömmlichere Möglichkeit, Ressourcen zu erstellen und Anwendungen schrittweise bereitzustellen. Sie eignet sich für Spring-Entwickler, die Azure Cloud Services zum ersten Mal verwenden.
Die Azure Developer CLI ist eine effizientere Möglichkeit, um Ressourcen automatisch zu erstellen und Anwendungen mithilfe einfacher Befehle bereitzustellen. Die Azure Developer CLI verwendet eine Vorlage, um die erforderlichen Azure-Ressourcen und den Anwendungscode bereitzustellen. Diese Option eignet sich für Spring-Entwickler, die mit Azure Cloud Services vertraut sind.
Dieser Artikel enthält die folgenden Optionen für die Bereitstellung in Azure Spring Apps:
Die Azure-Portal-Option ist die einfachste und schnellste Möglichkeit, Ressourcen zu erstellen und Anwendungen mit einem einzigen Klick bereitzustellen. Diese Option eignet sich für Spring-Entwickler, die Anwendungen schnell in Azure Cloud Services bereitstellen möchten.
Die Azure-Portal + Maven-Plug-In-Option bietet eine herkömmlichere Möglichkeit, Ressourcen zu erstellen und Anwendungen schrittweise bereitzustellen. Sie eignet sich für Spring-Entwickler, die Azure Cloud Services zum ersten Mal verwenden.
Die Azure CLI nutzt ein leistungsfähiges Befehlszeilentool zum Verwalten von Azure-Ressourcen. Diese Option eignet sich für Spring-Entwickler, die mit Azure Cloud Services vertraut sind.
Azure CLI (ab Version 2.45.0) Verwenden Sie den folgenden Befehl, 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.
Die Schaltfläche Bereitstellen in Azure im nächsten Abschnitt startet eine Azure-Portal-Erfahrung, die ein JAR-Paket von der Seite Versionen von ASA-Samples-Web-Application auf GitHub herunterlädt. Es sind keine lokalen Vorbereitungsschritte erforderlich.
Obwohl Sie das Azure-Portal in späteren Schritten verwenden, müssen Sie die Bash-Befehlszeile verwenden, um das Projekt lokal vorzubereiten. Führen Sie die folgenden Schritte aus, um die App zu klonen und lokal auszuführen:
Verwenden Sie den folgenden Befehl, um das Beispielprojekt von GitHub zu klonen:
Verwenden Sie den folgenden Befehl, um das Beispielprojekt mit Maven zu erstellen:
cd ASA-Samples-Web-Application
./mvnw clean package
Verwenden Sie den folgenden Befehl, um die Beispielanwendung auszuführen:
java -jar web/target/simple-todo-web.jar
Navigieren Sie in Ihrem Browser zu http://localhost:8080, um die App aufzurufen.
3. Cloudumgebung vorbereiten
Die wichtigsten Ressourcen, die Sie zum Ausführen dieses Beispiels benötigen, sind eine Azure Spring Apps-Instanz und eine Azure Database for PostgreSQL-Instanz. Dieser Abschnitt beschreibt die Schritte zum Erstellen dieser Ressourcen.
In diesem Abschnitt wird eine Schaltfläche Bereitstellen in Azure verwendet, um eine Bereitstellung im Azure-Portal zu starten. Diese Erfahrung verwendet eine ARM-Vorlage zum Erstellen von Azure-Ressourcen.
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 von Azure-Ressourcen
Führen Sie die folgenden Schritte aus, um alle Azure-Ressourcen zu erstellen, von denen die App abhängig ist:
Wählen Sie die folgende Schaltfläche In Azure bereitstellen aus, um die Bereitstellung im Azure-Portal zu starten:
Füllen Sie das Formular auf der Registerkarte Grundlagen aus. Verwenden Sie die folgende Tabelle als Leitfaden zum Ausfüllen des Formulars:
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
Region
Die Region, die Ihren Benutzern am nächsten ist.
Die Region wird verwendet, um die Ressourcengruppe zu erstellen.
Postgre-SQL-Administratorkennwort zurücksetzen
Nicht zutreffend
Legen Sie das Kennwort für diesen PostgreSQL-Administrator fest.
Postgre-SQL-Benutzerkennwort
Nicht zutreffend
Das Kennwort für den PostgreSQL-Anwendungsbenutzer, der in der Anwendung verwendet wird.
Wählen Sie Überprüfen und erstellen aus, um ihre Auswahl zu überprüfen. Wählen Sie dann Erstellen aus, um die App in Azure Spring Apps bereitzustellen.
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. Wählen Sie Zu Ressource wechseln aus, um die Seite Übersicht des Diensts zu öffnen.
3.1. Melden Sie sich auf dem Azure-Portal an.
Navigieren Sie zum Azure-Portal, geben Sie Ihre Anmeldeinformationen ein, und melden Sie sich beim Portal an. Die Standardansicht ist Ihr Dienstdashboard.
3.2. Erstellen einer Azure Spring Apps-Instanz
Führen Sie die folgenden Schritte aus, um die Dienstinstanz zu erstellen:
Wählen Sie in der Ecke des Azure-Portals Ressource erstellen aus.
Wählen Sie Compute>Azure Spring Apps aus.
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
Bei Azure Spring Apps zahlen Sie nutzungsbasiert.
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.
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.
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.
Wählen Sie Zu Ressource wechseln aus, um zur Seite Übersicht für Azure Spring Apps zu wechseln.
3.3. Vorbereiten der PostgreSQL-Instanz
Führen Sie die folgenden Schritte aus, um einen Azure Database for PostgreSQL-Server zu erstellen:
Klicken Sie im Azure-Portal auf Ressource erstellen.
Wählen Sie Datenbanken>Azure Database for PostgreSQL Flexible Server aus.
Füllen Sie die Registerkarte Grundlagen mit den folgenden Informationen aus:
Servername: my-demo-pgsql
Region: USA, Osten
PostgreSQL-Version: 14
Workloadtyp: Entwicklung
Aktivieren von Hochverfügbarkeit: nicht ausgewählt
Authentifizierungsmethode: Nur PostgreSQL-Authentifizierung
Administratorbenutzername: myadmin
Kennwort und Kennwort bestätigen: Geben Sie ein Kennwort ein.
Konfigurieren Sie die Registerkarte Netzwerk mit den folgenden Informationen:
Öffentlichen Zugriff auf diesen Server über beliebigen Azure-Dienst in Azure gestatten: ausgewählt
Wählen Sie Überprüfen + erstellen aus, um Ihre Auswahl zu überprüfen, und wählen Sie dann Erstellen aus, um den Server bereitzustellen. Dieser Vorgang kann einige Minuten dauern.
Wechseln Sie im Azure-Portal zu Ihrem PostgreSQL-Server.
Wählen Sie im Navigationsmenü Datenbanken aus, um eine Datenbank zu erstellen, z. B. Todo.
3.4. Verbinden der App-Instanz mit der PostgreSQL-Instanz
Führen Sie die folgenden Schritte aus, um Ihre Dienstinstanzen zu verbinden:
Wechseln Sie im Azure-Portal zu Ihrer Azure Spring Apps-Instanz.
Öffnen Sie im Navigationsbereich Apps, und wählen Sie dann App erstellen aus.
Verwenden Sie auf der Seite App erstellen für den App-Namen simple-todo-web, und übernehmen Sie für alle anderen Felder die Standardwerte.
Wählen Sie Erstellen aus, um die App-Erstellung abzuschließen, und wählen Sie dann die App aus, um Details anzuzeigen.
Wählen Sie im Navigationsbereich Dienstconnector und dann Erstellen aus, um eine neue Dienstverbindung zu erstellen.
Füllen Sie die Registerkarte Grundlagen mit den folgenden Informationen aus:
Diensttyp: DB for PostgreSQL – Flexibler Server
Verbindungsname: Wird mit einem automatisch generierten Namen aufgefüllt, den Sie ändern können.
Abonnement: Wählen Sie Ihr Abonnement aus.
PostgreSQL – Flexibler Server: my-demo-pgsql
PostgreSQL-Datenbank: Wählen Sie die Datenbank aus, die Sie erstellt haben.
Clienttyp: SpringBoot
Konfigurieren Sie die Registerkarte Weiter: Authentifizierung mit den folgenden Informationen:
Hinweis
Microsoft empfiehlt, immer den sichersten Authentifizierungsflow zu verwenden, der verfügbar ist. Der in diesem Verfahren beschriebene Authentifizierungsflow, beispielsweise für Datenbanken, Zwischenspeicher, Nachrichten oder KI-Dienste, erfordert ein sehr hohes Maß an Vertrauen in die Anwendung und birgt Risiken, die bei anderen Flows nicht vorhanden sind. Verwenden Sie diesen Flow nur, wenn sicherere Optionen wie verwaltete Identitäten für kennwortlose oder schlüssellose Verbindungen nicht geeignet sind. Bei Vorgängen des lokalen Computers bevorzugen Sie Benutzeridentitäten für kennwortlose oder schlüssellose Verbindungen.
Wählen Sie den Authentifizierungstyp aus, den Sie zwischen Ihrem Compute- und Zieldienst verwenden möchten: Wählen Sie Verbindungszeichenfolge aus.
Fortfahren mit...: Wählen Sie Datenbankanmeldeinformationen aus.
Benutzername: myadmin
Kennwort: Geben Sie Ihr Kennwort ein.
Klicken Sie auf Weiter: Netzwerk. Verwenden Sie die Standardoption Firewallregeln konfigurieren, um den Zugriff auf den Zieldienst zu aktivieren.
Wählen Sie Weiter: Überprüfen und erstellen aus, um Ihre Auswahl zu überprüfen, und wählen Sie dann Erstellen aus, um die Verbindung zu erstellen.
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.
Hinweis
Microsoft empfiehlt, immer den sichersten Authentifizierungsflow zu verwenden, der verfügbar ist. Der in diesem Verfahren beschriebene Authentifizierungsflow, beispielsweise für Datenbanken, Zwischenspeicher, Nachrichten oder KI-Dienste, erfordert ein sehr hohes Maß an Vertrauen in die Anwendung und birgt Risiken, die bei anderen Flows nicht vorhanden sind. Verwenden Sie diesen Flow nur, wenn sicherere Optionen wie verwaltete Identitäten für kennwortlose oder schlüssellose Verbindungen nicht geeignet sind. Bei Vorgängen des lokalen Computers bevorzugen Sie Benutzeridentitäten für kennwortlose oder schlüssellose Verbindungen.
Führen Sie die folgenden Schritte aus, um eine neue Ressourcengruppe zu erstellen.
Verwenden Sie den folgenden Befehl aus, um sich bei der Azure CLI anzumelden.
az login
Verwenden Sie den folgenden Befehl, um den Standardspeicherort festzulegen.
az configure --defaults location=${LOCATION}
Verwenden Sie den folgenden Befehl, um alle verfügbaren Abonnements aufzulisten, um die zu verwendende Abonnement-ID zu bestimmen.
az account list --output table
Verwenden Sie den folgenden Befehl, um das Standardabonnement festzulegen:
az account set --subscription <subscription-ID>
Verwenden Sie den folgenden Befehl, um eine Ressourcengruppe zu erstellen.
az group create --resource-group ${RESOURCE_GROUP}
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. Erstellen Sie eine Azure Spring Apps-Instanz und eine darin enthaltene App.
Verwenden Sie den folgenden Befehl, um eine Azure Spring Apps-Dienstinstanz zu erstellen:
az spring create --name ${AZURE_SPRING_APPS_NAME} --sku enterprise
Verwenden Sie den folgenden Befehl, um eine App in der Azure Spring Apps-Instanz zu erstellen.
az spring app create \
--service ${AZURE_SPRING_APPS_NAME} \
--name ${APP_NAME} \
--assign-endpoint true
3.4. Vorbereiten der PostgreSQL-Instanz
Die Spring-Web-App verwendet H2 für die Datenbank in localhost und Azure Database for PostgreSQL für die Datenbank in Azure.
Verwenden Sie den folgenden Befehl, um eine PostgreSQL-Instanz zu erstellen:
Hinweis
Microsoft empfiehlt, immer den sichersten Authentifizierungsflow zu verwenden, der verfügbar ist. Der in diesem Verfahren beschriebene Authentifizierungsflow, beispielsweise für Datenbanken, Zwischenspeicher, Nachrichten oder KI-Dienste, erfordert ein sehr hohes Maß an Vertrauen in die Anwendung und birgt Risiken, die bei anderen Flows nicht vorhanden sind. Verwenden Sie diesen Flow nur, wenn sicherere Optionen wie verwaltete Identitäten für kennwortlose oder schlüssellose Verbindungen nicht geeignet sind. Bei Vorgängen des lokalen Computers bevorzugen Sie Benutzeridentitäten für kennwortlose oder schlüssellose Verbindungen.
Die Angabe von 0.0.0.0 ermöglicht den öffentlichen Zugriff von allen in Azure bereitgestellten Ressourcen aus auf Ihren Server.
3.5. Verbinden der App-Instanz mit der PostgreSQL-Instanz
Nachdem die App-Instanz und die PostgreSQL-Instanz erstellt wurden, kann die App-Instanz nicht direkt auf die PostgreSQL-Instanz zugreifen. Führen Sie die folgenden Schritte aus, damit die App eine Verbindung mit der PostgreSQL-Instanz herstellen kann.
Verwenden Sie den folgenden Befehl, um den vollqualifizierten Domänennamen der PostgreSQL-Instanz abzurufen:
Verwenden Sie den folgenden Befehl, um der App die spring.datasource.-Eigenschaften über eine Umgebungsvariablen bereitzustellen:
Hinweis
Microsoft empfiehlt, immer den sichersten Authentifizierungsflow zu verwenden, der verfügbar ist. Der in diesem Verfahren beschriebene Authentifizierungsflow, beispielsweise für Datenbanken, Zwischenspeicher, Nachrichten oder KI-Dienste, erfordert ein sehr hohes Maß an Vertrauen in die Anwendung und birgt Risiken, die bei anderen Flows nicht vorhanden sind. Verwenden Sie diesen Flow nur, wenn sicherere Optionen wie verwaltete Identitäten für kennwortlose oder schlüssellose Verbindungen nicht geeignet sind. Bei Vorgängen des lokalen Computers bevorzugen Sie Benutzeridentitäten für kennwortlose oder schlüssellose Verbindungen.
az spring app update \
--service ${AZURE_SPRING_APPS_NAME} \
--name ${APP_NAME} \
--env SPRING_DATASOURCE_URL="jdbc:postgresql://${PSQL_FQDN}:5432/${POSTGRESQL_DB}?sslmode=require" \
SPRING_DATASOURCE_USERNAME="${POSTGRESQL_ADMIN_USERNAME}" \
SPRING_DATASOURCE_PASSWORD="${POSTGRESQL_ADMIN_PASSWORD}"
Die Schaltfläche Bereitstellen in Azure im vorherigen Abschnitt startet eine Azure-Portal-Erfahrung, die die Anwendungsbereitstellung umfasst, sodass nichts anderes erforderlich ist.
In der folgenden Liste werden die Befehlsinteraktionen beschrieben:
Zu konfigurierende untergeordnete Module auswählen: Wählen Sie das zu konfigurierende Modul aus, und geben Sie dann die Nummer des SimpleTodo Web-Moduls ein.
OAuth2-Anmeldung: Sie müssen die Anmeldung bei Azure, basierend auf dem OAuth2-Protokoll, autorisieren.
Abonnement auswählen: Wählen Sie die Nummer der von Ihnen erstellten Azure Spring Apps-Instanz in der Abonnementliste aus, die standardmäßig das erste Abonnement in der Liste ist. Wenn Sie die Standardnummer verwenden, drücken Sie direkt die EINGABETASTE.
Vorhandene Azure Spring Apps-Instanz in Azure verwenden: Drücken Sie y, um die vorhandene Azure Spring Apps-Instanz zu verwenden.
Auswählen von Azure Spring Apps für die Bereitstellung: Wählen Sie die Nummer der von Ihnen erstellten Azure Spring Apps-Instanz aus. Wenn Sie die Standardnummer verwenden, drücken Sie direkt die EINGABETASTE.
Öffentlichen Zugriff für diese App verfügbar machen: Drücken Sie y.
Bestätigen, dass alle oben genannten Konfigurationen gespeichert werden sollen: Drücken Sie y. Wenn Sie n drücken, wird die Konfiguration nicht in den POM-Dateien gespeichert.
Verwenden Sie den folgenden Befehl, um die App bereitzustellen:
./mvnw azure-spring-apps:deploy
In der folgenden Liste wird die Befehlsinteraktion beschrieben:
OAuth2-Anmeldung: Sie müssen die Anmeldung bei Azure, basierend auf dem OAuth2-Protokoll, autorisieren.
Nachdem der Befehl ausgeführt wurde, ersehen Sie aus der folgenden Protokollbenachrichtigung, dass die Bereitstellung erfolgreich war:
[INFO] Deployment Status: Running
[INFO] InstanceName:simple-todo-web-default-15-xxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:N/A
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.azuremicroservices.io
Die ausgegebene Anwendungs-URL ist der Endpunkt für den Zugriff auf die todo-Anwendung.
Nachdem die Cloudumgebung vorbereitet ist, kann die App bereitgestellt werden. Verwenden Sie den folgenden Befehl, um die App bereitzustellen:
az spring app deploy \
--service ${AZURE_SPRING_APPS_NAME} \
--name ${APP_NAME} \
--artifact-path web/target/simple-todo-web.jar
Die Schaltfläche Bereitstellen in Azure im nächsten Abschnitt startet eine Azure-Portal-Erfahrung, die ein JAR-Paket von der Seite Versionen von ASA-Samples-Web-Application auf GitHub herunterlädt. Es sind keine lokalen Vorbereitungsschritte erforderlich.
Obwohl Sie das Azure-Portal in späteren Schritten verwenden, müssen Sie die Bash-Befehlszeile verwenden, um das Projekt lokal vorzubereiten. Führen Sie die folgenden Schritte aus, um die App zu klonen und lokal auszuführen:
Verwenden Sie den folgenden Befehl, um das Beispielprojekt von GitHub zu klonen:
In der folgenden Liste wird die Befehlsinteraktion beschrieben:
Geben Sie einen neuen Umgebungsnamen ein: Geben Sie einen Umgebungsnamen an, der als Suffix für die Ressourcengruppe verwendet wird, die alle Azure-Ressourcen aufnehmen soll. Dieser Name muss in Ihrem Azure-Abonnement eindeutig sein.
Die Konsole gibt Meldungen aus, die dem folgenden Beispiel ähneln:
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. Cloudumgebung vorbereiten
Die wichtigsten Ressourcen, die Sie zum Ausführen dieses Beispiels benötigen, sind eine Azure Spring Apps-Instanz und eine Azure Database for PostgreSQL-Instanz. Dieser Abschnitt beschreibt die Schritte zum Erstellen dieser Ressourcen.
In diesem Abschnitt wird eine Schaltfläche Bereitstellen in Azure verwendet, um eine Bereitstellung im Azure-Portal zu starten. Diese Erfahrung verwendet eine ARM-Vorlage zum Erstellen von Azure-Ressourcen.
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 von Azure-Ressourcen
Führen Sie die folgenden Schritte aus, um alle Azure-Ressourcen zu erstellen, von denen die App abhängig ist:
Wählen Sie die folgende Schaltfläche In Azure bereitstellen aus, um die Bereitstellung im Azure-Portal zu starten:
Füllen Sie das Formular auf der Registerkarte Grundlagen aus. Verwenden Sie die folgende Tabelle als Leitfaden zum Ausfüllen des Formulars:
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
Region
Die Region, die Ihren Benutzern am nächsten ist.
Die Region wird verwendet, um die Ressourcengruppe zu erstellen.
PostgreSQL-Administratorkennwort
N/V
Legen Sie das Kennwort für diesen PostgreSQL-Administrator fest.
PostgreSQL-Benutzerkennwort
N/V
Das Kennwort für den PostgreSQL-Anwendungsbenutzer, der in der Anwendung verwendet wird.
Wählen Sie Überprüfen und erstellen aus, um ihre Auswahl zu überprüfen. Wählen Sie dann Erstellen aus, um die App in Azure Spring Apps bereitzustellen.
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. Wählen Sie Zu Ressource wechseln aus, um die Seite Übersicht des Diensts zu öffnen.
Führen Sie die folgenden Schritte aus, um eine Azure Spring Apps-Instanz und eine Azure Database for PostgreSQL-Instanz zu erstellen:
3.1. Melden Sie sich auf dem Azure-Portal an.
Navigieren Sie zum Azure-Portal, geben Sie Ihre Anmeldeinformationen ein, und melden Sie sich beim Portal an. Die Standardansicht ist Ihr Dienstdashboard.
3.2. Erstellen einer Azure Spring Apps-Instanz
Führen Sie die folgenden Schritte aus, um eine Dienstinstanz zu erstellen:
Wählen Sie in der Ecke des Portals Ressource erstellen aus.
Wählen Sie Compute>Azure Spring Apps aus.
Füllen Sie das Formular auf der Registerkarte Grundlagen aus. Verwenden Sie die folgende Tabelle als Leitfaden zum Ausfüllen des Formulars:
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
Standardverbrauch und dediziert (Preview)
Der Tarif bestimmt die mit Ihrer Instanz verbundenen Ressourcen und Kosten.
Region
Die Region, die Ihren Benutzern am nächsten ist.
Der Standort, der Ihren Benutzern am nächsten ist.
Container Apps-Umgebung
myacaenv
Diese Umgebung ist eine sichere Grenze um eine oder mehrere Container-Apps herum, die miteinander kommunizieren und ein virtuelles Netzwerk, die Protokollierung und die Dapr-Konfiguration gemeinsam nutzen können.
(Optional) Füllen Sie die Registerkarte Grundlagen mit den folgenden Informationen aus, um die Container Apps-Umgebung zu erstellen:
Name der Umgebung: myacaenv
Plan: Verbrauch
Zonenredundanz: Deaktiviert
Wählen Sie dann Erstellen aus, um die Container Apps-Umgebung zu erstellen.
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.
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. Wählen Sie Zu Ressource wechseln aus, um die Seite Übersicht des Diensts zu öffnen.
3.3. Vorbereiten der PostgreSQL-Instanz
Führen Sie die folgenden Schritte aus, um einen Azure Database for PostgreSQL-Server zu erstellen:
Klicken Sie im Azure-Portal auf Ressource erstellen.
Wählen Sie Datenbanken>Azure Database for PostgreSQL Flexible Server aus.
Füllen Sie die Registerkarte Grundlagen mit den folgenden Informationen aus:
Servername: my-demo-pgsql
Region: USA, Osten
PostgreSQL-Version: 14
Workloadtyp: Entwicklung
Aktivieren von Hochverfügbarkeit: nicht ausgewählt
Authentifizierungsmethode: Nur PostgreSQL-Authentifizierung
Administratorbenutzername: myadmin
Kennwort und Kennwort bestätigen: Geben Sie ein Kennwort ein.
Konfigurieren Sie die Registerkarte Netzwerk mit den folgenden Informationen:
Öffentlichen Zugriff auf diesen Server über beliebigen Azure-Dienst in Azure gestatten: ausgewählt
Wählen Sie Überprüfen + erstellen aus, um Ihre Auswahl zu überprüfen, und wählen Sie dann Erstellen aus, um den Server bereitzustellen. Dieser Vorgang kann einige Minuten dauern.
Wechseln Sie im Azure-Portal zu Ihrem PostgreSQL-Server.
Wählen Sie im Navigationsmenü Datenbanken aus, um eine Datenbank zu erstellen, z. B. Todo.
3.4. Verbinden der App-Instanz mit der PostgreSQL-Instanz
Führen Sie die folgenden Schritte aus, um Ihre Dienstinstanzen zu verbinden:
Wechseln Sie im Azure-Portal zu Ihrer Azure Spring Apps-Instanz.
Öffnen Sie im Navigationsbereich Apps, und wählen Sie dann App erstellen aus.
Verwenden Sie auf der Seite App erstellen für den App-Namen simple-todo-web, und wählen Sie dann Schnellstartbeispiel-App verwenden, um die App zu erstellen.
Wählen Sie Erstellen aus, um die App-Erstellung abzuschließen, und wählen Sie dann die App aus, um ihre Details anzuzeigen.
Wählen Sie im Navigationsbereich Konfiguration aus und konfigurieren Sie dann die folgenden Eigenschaften auf der Registerkarte Umgebungsvariablen:
SPRING_DATASOURCE_PASSWORD: Geben Sie Ihr Kennwort ein.
Wählen Sie Speichern aus, um die Verbindungseigenschaften zu speichern.
Führen Sie die folgenden Schritte aus, um eine Azure Spring Apps-Instanz und eine Azure Database for PostgreSQL-Instanz zu erstellen:
Verwenden Sie den folgenden Befehl, um sich bei Azure mit OAuth2 anzumelden. Ignorieren Sie diesen Schritt, wenn Sie bereits angemeldet sind.
azd auth login
Die Konsole gibt Meldungen aus, die dem folgenden Beispiel ähneln:
Logged in to Azure.
Führen Sie den folgenden Befehl aus, um die Infrastruktur der Vorlage in Azure bereitzustellen:
azd provision
In der folgenden Liste werden die Befehlsinteraktionen beschrieben:
Wählen Sie ein zu verwendendes Azure-Abonnement aus: Verwenden Sie Pfeile zum Verschieben, geben Sie Text ein, um zu filtern, und drücken Sie dann die EINGABETASTE.
Wählen Sie einen zu verwendenden Azure-Standort aus: Verwenden Sie Pfeile zum Verschieben, geben Sie Text ein, um zu filtern, und drücken Sie dann die EINGABETASTE.
Die Konsole gibt Meldungen aus, die dem folgenden Beispiel ähneln:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Hinweis
Die Ausführung des Befehls kann eine Weile dauern. Beim Bereitstellen von Azure-Ressourcen wird Ihnen ein Statusindikator angezeigt.
Die Schaltfläche Bereitstellen in Azure im vorherigen Abschnitt startet eine Azure-Portal-Erfahrung, die die Anwendungsbereitstellung umfasst, sodass nichts anderes erforderlich ist.
In der folgenden Liste werden die Befehlsinteraktionen beschrieben:
Zu konfigurierende untergeordnete Module auswählen: Wählen Sie das zu konfigurierende Modul aus, und geben Sie dann die Nummer des SimpleTodo Web-Moduls ein.
OAuth2-Anmeldung: Sie müssen die Anmeldung bei Azure, basierend auf dem OAuth2-Protokoll, autorisieren.
Abonnement auswählen: Wählen Sie die Nummer der von Ihnen erstellten Azure Spring Apps-Instanz in der Abonnementliste aus, die standardmäßig das erste Abonnement in der Liste ist. Wenn Sie die Standardnummer verwenden, drücken Sie direkt die EINGABETASTE.
Vorhandene Azure Spring Apps-Instanz in Azure verwenden: Drücken Sie y, um die vorhandene Azure Spring Apps-Instanz zu verwenden.
Auswählen von Azure Spring Apps für die Bereitstellung: Wählen Sie die Nummer der von Ihnen erstellten Azure Spring Apps-Instanz aus. Wenn Sie die Standardnummer verwenden, drücken Sie direkt die EINGABETASTE.
Öffentlichen Zugriff für diese App verfügbar machen: Drücken Sie y.
Bestätigen, dass alle oben genannten Konfigurationen gespeichert werden sollen: Drücken Sie y. Wenn Sie n drücken, wird die Konfiguration nicht in den POM-Dateien gespeichert.
Verwenden Sie den folgenden Befehl, um die App bereitzustellen:
./mvnw azure-spring-apps:deploy
In der folgenden Liste wird die Befehlsinteraktion beschrieben:
OAuth2-Anmeldung: Sie müssen die Anmeldung bei Azure, basierend auf dem OAuth2-Protokoll, autorisieren.
Nachdem der Befehl ausgeführt wurde, ersehen Sie aus der folgenden Protokollbenachrichtigung, dass die Bereitstellung erfolgreich war:
[INFO] Start updating app(simple-todo-web)...
[INFO] App(simple-todo-web) is successfully updated.
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:simple-todo-web--default-xxxxxxx-xxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:NONE
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://simple-todo-web.<unique-identifier>.<region-name>.azurecontainerapps.io
Die ausgegebene Anwendungs-URL ist der Endpunkt für den Zugriff auf die todo-Anwendung.
Sie können die App jetzt in Azure Spring Apps bereitstellen. Führen Sie die folgenden Schritte aus, um die App zu packen, die für die Webanwendung erforderlichen Azure-Ressourcen bereitzustellen und dann in Azure Spring Apps bereitzustellen:
Verwenden Sie den folgenden Befehl, um eine bereitstellbare Kopie Ihrer Anwendung zu packen:
azd package
Die Konsole gibt Meldungen aus, die dem folgenden Beispiel ähneln:
SUCCESS: Your application was packaged for Azure in xx seconds.
Verwenden Sie den folgenden Befehl, um den Anwendungscode für diese neu bereitgestellten Ressourcen bereitzustellen:
azd deploy
Die Konsole gibt Meldungen aus, die dem folgenden Beispiel ähneln:
Deploying services (azd deploy)
(✓) Done: Deploying service simple-todo-web
- Endpoint: https://simple-todo-web.xxx.<your-azure-location>.azurecontainerapps.io
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Der ausgegebene Endpunkt ist der Endpunkt für den Zugriff auf die todo-Anwendung.
Hinweis
Sie können auch azd up verwenden, um die vorherigen drei Befehle zu kombinieren: azd provision (stellt Azure-Ressourcen bereit), azd package (verpackt eine einsatzfähige Kopie Ihrer Anwendung) und azd deploy (stellt den Anwendungscode bereit). Weitere Informationen finden Sie unter Azure-Samples/ASA-Samples-Web-Application.
Die Schaltfläche Bereitstellen in Azure im nächsten Abschnitt startet eine Azure-Portal-Erfahrung, die ein JAR-Paket von der Seite Versionen von ASA-Samples-Web-Application auf GitHub herunterlädt. Es sind keine lokalen Vorbereitungsschritte erforderlich.
Obwohl Sie das Azure-Portal in späteren Schritten verwenden, müssen Sie die Bash-Befehlszeile verwenden, um das Projekt lokal vorzubereiten. Führen Sie die folgenden Schritte aus, um die App zu klonen und lokal auszuführen:
Verwenden Sie den folgenden Befehl, um das Beispielprojekt von GitHub zu klonen:
In der folgenden Liste wird die Befehlsinteraktion beschrieben:
Geben Sie einen neuen Umgebungsnamen ein: Geben Sie einen Umgebungsnamen an, der als Suffix für die Ressourcengruppe verwendet wird, die alle Azure-Ressourcen aufnehmen soll. Dieser Name muss in Ihrem Azure-Abonnement eindeutig sein.
Die Konsole gibt Meldungen aus, die dem folgenden Beispiel ähneln:
Initializing a new project (azd init)
(✓) Done: Initialized git repository
(✓) Done: Downloading template code to: <your-local-path>
Please enter a new environment name: <your-env-name>
SUCCESS: New project initialized!
You can view the template code in your directory: <your-local-path>
Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
3. Cloudumgebung vorbereiten
Die wichtigsten Ressourcen, die Sie zum Ausführen dieses Beispiels benötigen, sind eine Azure Spring Apps-Instanz und eine Azure Database for PostgreSQL-Instanz. Dieser Abschnitt beschreibt die Schritte zum Erstellen dieser Ressourcen.
In diesem Abschnitt wird eine Schaltfläche Bereitstellen in Azure verwendet, um eine Bereitstellung im Azure-Portal zu starten. Diese Erfahrung verwendet eine ARM-Vorlage zum Erstellen von Azure-Ressourcen.
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 von Azure-Ressourcen
Führen Sie die folgenden Schritte aus, um alle Azure-Ressourcen zu erstellen, von denen die App abhängig ist:
Wählen Sie die folgende Schaltfläche In Azure bereitstellen aus, um die Bereitstellung im Azure-Portal zu starten:
Füllen Sie das Formular auf der Registerkarte Grundlagen aus. Verwenden Sie die folgende Tabelle als Leitfaden zum Ausfüllen des Formulars:
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
Region
Die Region, die Ihren Benutzern am nächsten ist.
Die Region wird verwendet, um die Ressourcengruppe zu erstellen.
Postgre-SQL-Administratorkennwort zurücksetzen
Nicht zutreffend
Legen Sie das Kennwort für diesen PostgreSQL-Administrator fest.
Postgre-SQL-Benutzerkennwort
Nicht zutreffend
Das Kennwort für den PostgreSQL-Anwendungsbenutzer, der in der Anwendung verwendet wird.
Wählen Sie Überprüfen und erstellen aus, um ihre Auswahl zu überprüfen. Wählen Sie dann Erstellen aus, um die App in Azure Spring Apps bereitzustellen.
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. Wählen Sie Zu Ressource wechseln aus, um die Seite Übersicht des Diensts zu öffnen.
Führen Sie die folgenden Schritte aus, um eine Azure Spring Apps-Instanz und eine Azure Database for PostgreSQL-Instanz zu erstellen:
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
Führen Sie die folgenden Schritte aus, um eine Dienstinstanz zu erstellen:
Wählen Sie in der Ecke des Portals Ressource erstellen aus.
Wählen Sie Compute>Azure Spring Apps aus.
Füllen Sie das Formular auf der Registerkarte Grundlagen aus. Verwenden Sie die folgende Tabelle als Leitfaden zum Ausfüllen des Formulars:
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
Grundlegend
Der Tarif bestimmt die mit Ihrer Instanz verbundenen Ressourcen und Kosten.
Region
Die Region, die Ihren Benutzern am nächsten ist.
Der Standort, der Ihren Benutzern am nächsten ist.
Zonenredundant
Nicht markiert
Ob Ihr Azure Spring Apps-Dienst in einer Azure-Verfügbarkeitszone erstellt werden soll. Derzeit wird dieses Feature nur in einigen Regionen unterstützt.
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.
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. Wählen Sie Zu Ressource wechseln aus, um die Seite Übersicht des Diensts zu öffnen.
3.3. Vorbereiten der PostgreSQL-Instanz
Führen Sie die folgenden Schritte aus, um einen Azure Database for PostgreSQL-Server zu erstellen:
Klicken Sie im Azure-Portal auf Ressource erstellen.
Wählen Sie Datenbanken>Azure Database for PostgreSQL Flexible Server aus.
Füllen Sie die Registerkarte Grundlagen mit den folgenden Informationen aus:
Servername: my-demo-pgsql
Region: USA, Osten
PostgreSQL-Version: 14
Workloadtyp: Entwicklung
Aktivieren von Hochverfügbarkeit: nicht ausgewählt
Authentifizierungsmethode: Nur PostgreSQL-Authentifizierung
Administratorbenutzername: myadmin
Kennwort und Kennwort bestätigen: Geben Sie ein Kennwort ein.
Konfigurieren Sie die Registerkarte Netzwerk mit den folgenden Informationen:
Öffentlichen Zugriff auf diesen Server über beliebigen Azure-Dienst in Azure gestatten: ausgewählt
Wählen Sie Überprüfen + erstellen aus, um Ihre Auswahl zu überprüfen, und wählen Sie dann Erstellen aus, um den Server bereitzustellen. Dieser Vorgang kann einige Minuten dauern.
Wechseln Sie im Azure-Portal zu Ihrem PostgreSQL-Server.
Wählen Sie im Navigationsmenü Datenbanken aus, um eine Datenbank zu erstellen, z. B. Todo.
3.4. Verbinden der App-Instanz mit der PostgreSQL-Instanz
Führen Sie die folgenden Schritte aus, um Ihre Dienstinstanzen zu verbinden:
Wechseln Sie im Azure-Portal zu Ihrer Azure Spring Apps-Instanz.
Öffnen Sie im Navigationsbereich den Bereich Apps, und wählen Sie App erstellen aus.
Verwenden Sie auf der Seite App erstellen für den App-Namen simple-todo-web, und wählen Sie für die Runtimeplattform Java 17 aus.
Wählen Sie Erstellen aus, um die App-Erstellung abzuschließen, und wählen Sie die App aus, um Details anzuzeigen.
Wählen Sie im Navigationsbereich Dienstconnector und dann Erstellen aus, um eine neue Dienstverbindung zu erstellen.
Füllen Sie die Registerkarte Grundlagen mit den folgenden Informationen aus:
Diensttyp: DB for PostgreSQL – Flexibler Server
Verbindungsname: Wird mit einem automatisch generierten Namen aufgefüllt, den Sie ändern können.
Abonnement: Wählen Sie Ihr Abonnement aus.
PostgreSQL – Flexibler Server: my-demo-pgsql
PostgreSQL-Datenbank: Wählen Sie die Datenbank aus, die Sie erstellt haben.
Clienttyp: SpringBoot
Konfigurieren Sie die Registerkarte Weiter: Authentifizierung mit den folgenden Informationen:
Wählen Sie den Authentifizierungstyp aus, den Sie zwischen Ihrem Compute- und Zieldienst verwenden möchten: Wählen Sie Verbindungszeichenfolge aus.
Fortfahren mit...: Wählen Sie Datenbankanmeldeinformationen aus.
Benutzername: myadmin
Kennwort: Geben Sie Ihr Kennwort ein.
Klicken Sie auf Weiter: Netzwerk. Verwenden Sie die Standardoption Firewallregeln konfigurieren, um den Zugriff auf den Zieldienst zu aktivieren.
Wählen Sie Weiter: Überprüfen und erstellen aus, um Ihre Auswahl zu überprüfen, und wählen Sie dann Erstellen aus, um die Verbindung zu erstellen.
Führen Sie die folgenden Schritte aus, um eine Azure Spring Apps-Instanz und eine Azure Database for PostgreSQL-Instanz zu erstellen:
Verwenden Sie den folgenden Befehl, um sich bei Azure mit OAuth2 anzumelden. Ignorieren Sie diesen Schritt, wenn Sie bereits angemeldet sind.
azd auth login
Die Konsole gibt Meldungen aus, die dem folgenden Beispiel ähneln:
Logged in to Azure.
Verwenden Sie den folgenden Befehl, um die Vorlage unter Verwendung des Standardplans festzulegen:
azd env set PLAN standard
Führen Sie den folgenden Befehl aus, um die Infrastruktur der Vorlage in Azure bereitzustellen:
azd provision
In der folgenden Liste werden die Befehlsinteraktionen beschrieben:
Wählen Sie ein zu verwendendes Azure-Abonnement aus: Verwenden Sie Pfeile zum Verschieben, geben Sie Text ein, um zu filtern, und drücken Sie dann die EINGABETASTE.
Wählen Sie einen zu verwendenden Azure-Standort aus: Verwenden Sie Pfeile zum Verschieben, geben Sie Text ein, um zu filtern, und drücken Sie dann die EINGABETASTE.
Die Konsole gibt Meldungen aus, die dem folgenden Beispiel ähneln:
SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Hinweis
Die Ausführung des Befehls kann eine Weile dauern. Beim Bereitstellen von Azure-Ressourcen wird Ihnen ein Statusindikator angezeigt.
Die Schaltfläche Bereitstellen in Azure im vorherigen Abschnitt startet eine Azure-Portal-Erfahrung, die die Anwendungsbereitstellung umfasst, sodass nichts anderes erforderlich ist.
Sie können die App jetzt in Azure Spring Apps bereitstellen.
In der folgenden Liste werden die Befehlsinteraktionen beschrieben:
Zu konfigurierende untergeordnete Module auswählen: Wählen Sie das zu konfigurierende Modul aus, und geben Sie dann die Nummer des SimpleTodo Web-Moduls ein.
OAuth2-Anmeldung: Autorisieren Sie die Anmeldung bei Azure basierend auf dem OAuth2-Protokoll.
Abonnement auswählen: Wählen Sie die Nummer der von Ihnen erstellten Azure Spring Apps-Instanz in der Abonnementliste aus, die standardmäßig das erste Abonnement in der Liste ist. Wenn Sie die Standardnummer verwenden, drücken Sie direkt die EINGABETASTE.
Azure Spring Apps auswählen: Wählen Sie die Nummer der von Ihnen erstellten Azure Spring Apps-Instanz aus. Wenn Sie die Standardnummer verwenden, drücken Sie direkt die EINGABETASTE.
Öffentlichen Zugriff für diese App verfügbar machen?: Drücken Sie y (j).
Bestätigen Sie, dass alle oben genannten Konfigurationen (Y/n) gespeichert werden sollen: Drücken Sie y. Wenn Sie n drücken, wird die Konfiguration nicht in den POM-Dateien gespeichert.
Verwenden Sie den folgenden Befehl, um die App bereitzustellen:
./mvnw azure-spring-apps:deploy
In der folgenden Liste wird die Befehlsinteraktion beschrieben:
OAuth2-Anmeldung: Sie müssen die Anmeldung bei Azure, basierend auf dem OAuth2-Protokoll, autorisieren.
Nachdem der Befehl ausgeführt wurde, ersehen Sie aus der folgenden Protokollbenachrichtigung, dass die Bereitstellung erfolgreich war:
[INFO] Deployment(default) is successfully created
[INFO] Starting Spring App after deploying artifacts...
[INFO] Deployment Status: Running
[INFO] InstanceName:simple-todo-web-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:UNREGISTERED
[INFO] InstanceName:simple-todo-web-default-x-xxxxxxxxx-xxxxx Status:Terminating Reason:null DiscoverStatus:UNREGISTERED
[INFO] Getting public url of app(simple-todo-web)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.azuremicroservices.io
Die ausgegebene Anwendungs-URL ist der Endpunkt für den Zugriff auf die todo-Anwendung.
Sie können die App jetzt in Azure Spring Apps bereitstellen. Führen Sie die folgenden Schritte aus, um die App zu packen, die für die Webanwendung erforderlichen Azure-Ressourcen bereitzustellen und dann in Azure Spring Apps bereitzustellen:
Verwenden Sie den folgenden Befehl, um eine bereitstellbare Kopie Ihrer Anwendung zu packen:
azd package
Die Konsole gibt Meldungen aus, die dem folgenden Beispiel ähneln:
SUCCESS: Your application was packaged for Azure in xx seconds.
Verwenden Sie den folgenden Befehl, um den Anwendungscode für diese neu bereitgestellten Ressourcen bereitzustellen:
azd deploy
Die Konsole gibt Meldungen aus, die dem folgenden Beispiel ähneln:
Deploying services (azd deploy)
(✓) Done: Deploying service simple-todo-web
- Endpoint: https://<your-Azure-Spring-Apps-instance-name>-simple-todo-web.azuremicroservices.io/
SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
Der ausgegebene Endpunkt ist der Endpunkt für den Zugriff auf die todo-Anwendung.
Hinweis
Sie können auch azd up verwenden, um die vorherigen drei Befehle zu kombinieren: azd package (packt eine bereitstellungsfähige Kopie Ihrer Anwendung), azd provision (stellt Azure-Ressourcen bereit) und azd deploy (stellt Anwendungscode bereit). Weitere Informationen finden Sie unter Azure-Samples/ASA-Samples-Web-Application.
5. Überprüfen der Web-App
Jetzt können Sie auf die bereitgestellte App zugreifen, um festzustellen, ob sie funktioniert.
Verwenden Sie die folgenden Schritte zur Überprüfung:
Nach Abschluss der Bereitstellung können Sie die Anwendungs-URL in den Bereitstellungsausgaben finden:
Greifen Sie mit der Ausgabeanwendungs-URL auf die Anwendung zu. Die Seite sollte wie in localhost angezeigt werden.
Überprüfen Sie die Details für jede Ressourcenbereitstellung, die für die Untersuchung von Bereitstellungsproblemen hilfreich sind.
Greifen Sie mit der Ausgabeanwendungs-URL auf die Anwendung zu. Die Seite sollte wie in localhost angezeigt werden.
Verwenden Sie die folgenden Schritte zur Überprüfung:
Nach dem Abschluss der Bereitstellung können Sie unter https://${AZURE_SPRING_APPS_NAME}-${APP_NAME}.azuremicroservices.io/ auf die App zugreifen. Die Seite sollte wie in localhost angezeigt werden.
Um das Protokoll der App zu überprüfen, um Bereitstellungsprobleme zu untersuchen, verwenden Sie den folgenden Befehl:
az spring app logs \
--service ${AZURE_SPRING_APPS_NAME} \
--name ${APP_NAME}
Verwenden Sie die folgenden Schritte zur Überprüfung:
Suchen Sie nach Abschluss der Bereitstellung die Anwendungs-URL aus den Bereitstellungsausgaben:
Greifen Sie auf die Anwendungs-URL zu. Die Seite sollte wie in localhost angezeigt werden.
Überprüfen Sie die Details für jede Ressourcenbereitstellung, die für die Untersuchung von Bereitstellungsproblemen hilfreich sind.
Greifen Sie mit der Ausgabeanwendungs-URL auf die Anwendung zu. Die Seite sollte wie in localhost angezeigt werden.
Greifen Sie mit dem Ausgabeendpunkt auf die Anwendung zu. Die Seite sollte wie in localhost angezeigt werden.
6. Bereinigen von Ressourcen
Vergessen Sie nicht, die in diesem Artikel erstellten Ressourcen zu löschen, wenn Sie sie nicht mehr benötigen. Sie können die Azure-Ressourcengruppe einschließlich aller darin enthaltenen Ressourcen löschen.
Führen Sie die folgenden Schritte aus, um die gesamte Ressourcengruppe zu löschen, einschließlich der neu erstellten Dienstinstanz:
Navigieren Sie im Azure-Portal zu Ihrer Ressourcengruppe. Wählen Sie im Navigationsmenü Ressourcengruppen und dann den Namen Ihrer Ressourcengruppe aus.
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 die folgenden Schritte aus, um die gesamte Ressourcengruppe zu löschen, einschließlich der neu erstellten Dienstinstanz:
Navigieren Sie im Azure-Portal zu Ihrer Ressourcengruppe. Wählen Sie im Navigationsmenü Ressourcengruppen und dann den Namen Ihrer Ressourcengruppe aus.
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.
Verwenden Sie den folgenden Befehl, um alle Azure-Ressourcen zu löschen, die in dieser Beispielanwendung verwendet werden:
azd down
In der folgenden Liste wird die Befehlsinteraktion beschrieben:
Zu löschende Ressourcen insgesamt: <Ressourcen insgesamt>, möchten Sie fortfahren?: Drücken Sie y.
Die Konsole gibt Meldungen aus, die dem folgenden Beispiel ähneln:
SUCCESS: Your application was removed from Azure in xx minutes xx seconds.
Führen Sie die folgenden Schritte aus, um die gesamte Ressourcengruppe zu löschen, einschließlich der neu erstellten Dienstinstanz:
Navigieren Sie im Azure-Portal zu Ihrer Ressourcengruppe. Wählen Sie im Navigationsmenü Ressourcengruppen und dann den Namen Ihrer Ressourcengruppe aus.
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 die folgenden Schritte aus, um die gesamte Ressourcengruppe zu löschen, einschließlich der neu erstellten Dienstinstanz:
Navigieren Sie im Azure-Portal zu Ihrer Ressourcengruppe. Wählen Sie im Navigationsmenü Ressourcengruppen und dann den Namen Ihrer Ressourcengruppe aus.
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 zu löschen, einschließlich des neu erstellten Diensts:
