Übung: Umgebung für eine Beispielanwendung

Abgeschlossen

In dieser Übung konfigurieren Sie eine Beispielanwendung so, dass sie überwacht werden kann. Später greifen Sie auf die erfassten Überwachungsdaten zu und zeigen sie im Azure-Portal an.

Einführung

In dieser Übung klonen Sie ein Git-Repository und führen ein Skript aus, das eine Azure Spring Apps-Anwendung und eine Azure Database for MySQL-Instanz einrichtet. Das Skript stellt eine bereits bekannte PetClinic-Microserviceanwendung bereit und basiert auf kleinen unabhängigen Diensten, die über HTTP über eine REST-API miteinander kommunizieren.

Die Microservicebeispielanwendung

Die PetClinic-Anwendung wird in vier Kernmicroservices aufgeteilt. Alle sind eigenständig bereitstellbare Anwendungen, die nach Geschäftsbereichen organisiert sind.

• customers-service: Enthält allgemeine Benutzereingabelogik und -validierung, einschließlich Informationen zu Haustieren und Besitzern (Name, Adresse, Ort, Telefon).
• Besuchsdienst: Speichert Informationen zu den Besuchen für die Anmerkungen zu den einzelnen Haustieren und zeigt sie an.
• vets-service: Speichert Informationen zu Tierärzten und zeigt sie an, u. a. Name und Besonderheiten.
• API-Gateway: Ein einzelner Einstiegspunkt in das System, mit dem Anforderungen verarbeitet, an den zuständigen Dienst weitergeleitet und die Ergebnisse aggregiert werden.

Einrichten der Microservicebeispielanwendung

1. Öffnen Sie in einem Webbrowser https://shell.azure.com in einem neuen Fenster.

2. Klicken Sie oben rechts auf den Modus Bash.

3. Wählen Sie im Cloud Shell-Fenster rechts auf dem Bildschirm Einstellungen>Zur klassischen Version wechseln aus.

4. Führen Sie als Nächstes die folgenden Befehle aus, um das Beispielrepository zu klonen und den integrierten Azure-Editor zu öffnen:

   git clone https://github.com/MicrosoftDocs/mslearn-monitoring-java
   cd mslearn-monitoring-java
   code deployPetClinicApp.sh
   

Einrichten und Ausführen des Einrichtungsskripts

Wenn Sie den obigen Befehl ausführen, wird ein Fenster angezeigt, in dem Sie die Datei deployPetClinicApp.sh finden. Diese können Sie im integrierten Azure-Editor bearbeiten.

1. Bearbeiten Sie oben in der Datei deployPetClinicApp.sh die folgenden Variablen, um die Skriptparameter für Ihre Umgebung anzupassen. Verwenden Sie für alle Ressourcennamen Kleinbuchstaben. Sie können auch Bindestriche und Zahlen verwenden.

   Variable	BESCHREIBUNG
   resource_group	Geben Sie einen neuen oder vorhandenen Ressourcengruppennamen an.
   Region	Ersetze Sie diesen Platzhalter durch die Azure-Region, die Sie verwenden. Sie können standardmäßig westeurope verwenden. Es wird jedoch empfohlen, eine Region zu wählen, die sich in der Nähe Ihres Wohnorts befindet und die auch Azure Spring Apps unterstützt. Eine vollständige Liste verfügbarer Regionen finden Sie unter Azure Spring Apps-Verfügbarkeit nach Region.
   spring_apps_service	Name Ihrer Azure Spring Apps-Instanz
   mysql_server_name	Ersetzen Sie diesen Platzhalter durch den Namen Ihres MySQL-Servers. Er muss innerhalb von Azure eindeutig sein.
   mysql_server_admin_name	Hierbei handelt es sich um den Benutzernamen für den MySQL-Administrator. Der Administratorname darf nicht „azure-superuser“, „admin“, „administrator“, „root“, „guest“ oder „public“ lauten.
   mysql_server_admin_password	Ein neues Kennwort für den Serveradministratorbenutzer. Das Kennwort muss zwischen 8 und 128 Zeichen lang sein und eine Kombination aus Groß- oder Kleinbuchstaben, Ziffern und nicht alphanumerischen Zeichen (!, $, #, % usw.) aufweisen.
   log_analytics	Name Ihres Azure Log Analytics-Arbeitsbereichs

2. Speichern Sie die Datei. Wählen Sie hierzu im Editor oben rechts … und anschließend Speichern aus. Sie können auch STRG+S drücken.

3. Schließen Sie den Editor. Wählen Sie hierzu im Editor oben rechts … und anschließend Editor schließen aus. Sie können auch STRG+Q drücken.

4. Schließen Sie Azure Cloud Shell nicht, da Sie als Nächstes das Einrichtungsskript ausführen.

Ausführen des Setupskripts

Die Ausführung des Skripts dauert 30 bis 45 Minuten. Dabei werden unter anderem eine Azure Spring Apps-Instanz und eine MySQL-Instanz erstellt. Dieses Beispielskript füllt auch Beispieldaten für die Überwachungsprotokolle, Stapelüberwachungen und Metriken auf.

Führen Sie in der bereits geöffneten Azure Cloud Shell-Instanz das folgende Shellskript aus. Lassen Sie das Browserfenster und Azure Cloud Shell während der Ausführung geöffnet. Speichern Sie die URL nach Abschluss des Skripts.

bash deployPetClinicApp.sh

Wichtig

Wenn während der Ausführung des Einrichtungsskripts Fehler auftreten, versucht das Skript, Ressourcen zu löschen, die es erstellt hat. Sie können dann einen neuen Versuch starten, sobald die Ressourcengruppe vollständig gelöscht wurde. In der Lerneinheit „Zusammenfassung“ finden Sie auch eine Anleitung, wie Sie Ihre Ressourcen manuell löschen können.

Testen der Anwendung

Als Nächstes überprüfen Sie Ihre Umgebung über das Azure-Portal.

1. Öffnen Sie das Azure-Portal.

2. Wählen Sie aus der Liste der Azure-Dienste den Eintrag Azure Spring Apps aus.

3. Wählen Sie Ihre Azure Spring Apps-Instanz aus.

4. Klicken Sie auf der rechten Seite unter Einstellungen auf Apps.

5. Überprüfen Sie, ob alle Anwendungen ausgeführt werden und registriert sind, wie im folgenden Screenshot gezeigt:

   

6. Wählen Sie auf der linken Seite die Anwendung api-gateway aus.

7. Die URL für Ihre Anwendung ist in den Eigenschaften auf der linken Seite im Feld URL aufgeführt.

   

8. Navigieren Sie in einem Webbrowser zur URL für „api-gateway“, um die Microserviceanwendung „PetClinic“ zu öffnen.

9. Navigieren Sie anschließend zur Registerkarte Besitzer, und klicken Sie auf Nach allen Besitzern suchen.

10. Überprüfen Sie, ob Ihre Beispielanwendung ausgeführt wird, mit Daten aufgefüllt wurde und nun von Ihnen erkundet werden kann.