Konfigurieren eines Spring Cloud-Konfigurationsservers

  • 7 Minuten

In diesem Modul konfigurieren Sie einen Spring Cloud-Konfigurationsserver, der vollständig von Azure Spring Apps verwaltet und unterstützt und von Spring Boot-Microservices verwendet wird.

Dieser Spring Cloud Config Server erhält seine Konfigurationsdaten von einem Git-Repository, in dem Spring Boot-Konfigurationsdateien gespeichert werden. Das Speichern von Konfigurationsdateien mit diesem Mechanismus hat die folgenden Vorteile:

  • Die vertraulichen Parameter Ihrer Anwendung (z. B. das Datenbankkennwort) werden nicht in den Anwendungscode eingecheckt.
  • Das Git-Repository, in dem Ihre Konfiguration gespeichert ist, kann so gesichert werden, dass nur das Betriebsteam darauf zugreifen kann.
  • Da die Konfigurationsdateien in Git gespeichert werden, können Sie sie markieren oder zurücksetzen, um die Verwaltung Ihrer Produktionsumgebung zu vereinfachen.
  • Es wird ein zentraler Ort verwendet, um alle Konfigurationsdaten für Ihre Microservices zu speichern.

Erstellen eines Git-Repositorys zum Speichern der Anwendungskonfiguration

Erstellen Sie in Ihrem GitHub-Konto ein neues privates Repository, in dem die Spring Boot-Konfigurationen gespeichert werden.

Fügen Sie im neuen privaten GitHub-Repository eine neue application.yml-Datei hinzu, in der Konfigurationsdaten für alle Microservices gespeichert werden.

In der Regel enthält jede Spring Boot-Anwendung eine solche Datei innerhalb der Binärdateien der Anwendung, um Anwendungseinstellungen zu enthalten. Mit einem Spring Cloud-Konfigurationsserver können solche Einstellungen außerhalb der Anwendung gespeichert werden. Dies bietet die folgenden Vorteile:

  • Vertrauliche Parameter (wie Ihr Datenbankkennwort) können außerhalb der Anwendung gespeichert werden.
  • Ihre Konfiguration wird in einem Git-Repository gespeichert, sodass Ihre Daten markiert oder zurückgesetzt werden können.
  • Es wird ein bestimmtes Git-Repository verwendet, das separat gesichert werden kann.
  • Es wird ein zentraler Ort verwendet, um alle Konfigurationsdaten für Ihre Microservices zu speichern.

Im Moment speichert die Datei application.yml nur eine Nachricht, um zu überprüfen, ob die Konfiguration erfolgreich ist:

application:
    message: Configured by Azure Spring Apps

Committen Sie die neue Datei, und übertragen Sie diese mithilfe von Push:

git add application.yml
git commit -m 'Add new Spring Boot configuration file'
git push

Erstellen eines persönlichen GitHub-Tokens

Azure Spring Apps kann auf Git-Repositorys zugreifen, die öffentlich sind und per SSH oder mithilfe der HTTP-Standardauthentifizierung gesichert werden. Wir verwenden diese letzte Option, da sie mit GitHub einfacher erstellt und verwaltet werden kann.

Befolgen Sie die GitHub-Anleitung, um ein persönliches Token zu erstellen und Ihr Token zu speichern. Wenn Sie aufgefordert werden, Bereiche auszuwählen, überprüfen Sie nur den gesamten Abschnitt „repo“ und sonst nichts.

Screenshot that shows the GitHub personal access token settings.

Wenn das Token generiert ist, lassen Sie diese Registerkarte bis zum Ende dieses Abschnitts geöffnet.

Konfigurieren von Azure Spring Apps für den Zugriff auf das Git-Repository

  1. Wechseln Sie zum Azure-Portal und suchen Sie dort nach Azure Spring Apps.

  2. Navigieren Sie zur Übersichtsseite Ihres Azure Spring Apps-Servers und klicken Sie im Menü auf Config Server.

  3. Konfigurieren Sie das Repository, das Sie zuvor erstellt haben:

    1. Fügen Sie die Repository-URL hinzu (z. B. https://github.com/<YOUR_USERNAME>/azure-spring-cloud-config oder git@github.com:<YOUR_USERNAME>/azure-spring-cloud-config.git).

      Tipp

      Stellen Sie sicher, dass Sie die .git-Endung in die URL einschließen oder den qualifizierten URI verwenden.

    2. Fügen Sie den Branch in Label hinzu. Der Standardwert ist main auf GitHub, ältere Repositorys oder alternative Git-Anbieter können möglicherweise weiterhin master verwenden.

    3. Wählen Sie Authentifizierung und dann HTTP Basic aus.

    4. Der Benutzername ist Ihre GitHub-Anmelde-ID.

    5. Das Kennwort ist das im vorherigen Abschnitt erstellte persönliche Token.

    Screenshot of the Spring Cloud config server settings.

  4. Wählen SieÜberprüfen aus und warten Sie, bis der Vorgang abgeschlossen ist.

  5. Wählen Sie Anwenden aus und warten Sie, bis der Vorgang abgeschlossen ist.

Überprüfung

Sie haben ein privates Konfigurationsrepository erstellt. Außerdem haben Sie mit Azure Spring Apps einen Konfigurationsserver mit den Konfigurationsdateien aus diesem Repository erstellt.

Überprüfen Sie Ihr Wissen

1.

Welche Sicherheitsmechanismen werden in Azure Spring Cloud von Spring Apps-Konfigurationsservern unterstützt?

2.

Aus folgenden Gründen ist die Verwendung von Spring Cloud Config eine großartige Lösung: