Migrieren von Spring Cloud Config Server von Azure Spring Apps zu Azure Container Apps

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:✅ Basic/Standard ✅ Enterprise

In diesem Artikel wird beschrieben, wie Sie Spring Cloud Config Server zu Config Server for Spring in Azure Container Apps migrieren. Azure Container Apps verwaltet Config Server for Spring, der ähnliche Funktionen wie Spring Cloud Config Server in Azure Spring Apps hat.

Voraussetzungen

• Eine Azure Spring Apps-Instanz mit aktiviertem Configure Server.
• Eine Azure Container Apps-Umgebung für Konfigurationsserver und eine Azure Container Apps-Instanz.

Bereitstellungskonfigurationsserver

Azure portal

Die folgenden Schritte zeigen, wie Sie einen Config Server for Spring in Ihren Azure Container Apps bereitstellen:

1. Navigieren Sie im Azure-Portal zu Ihrer Azure Container Apps-Umgebung.

2. Wählen Sie im Menü Services>Services aus.

3. Öffnen Sie die Dropdownliste Konfigurieren und wählen Sie dann Java-Komponente aus.

4. Geben Sie im Bereich Java-Komponente konfigurieren die folgenden Werte ein:

   Eigenschaft	Wert
   Java-Komponententyp	Wählen Sie Config Server für Spring aus.
   Java-Komponentenname	Geben Sie configserver ein.

5. Wählen Sie im Abschnitt Git-RepositorysHinzufügen aus und migrieren Sie dann die Werte aus dem Anwendungskonfigurationsdienst zu dieser Stelle, wie in der folgenden Tabelle dargestellt. Wählen Sie ein Repository als Standard-Repository von Config Server for Spring aus.

   Eigenschaft	Wert
   Typ	Wählen Sie STANDARD aus.
   URI	Geben Sie den Wert des URI des Repositorys ein.
   Branchname	Geben Sie den Wert der Bezeichnung des Repositorys ein.
   Suchpfade	Geben Sie den Wert des Suchpfads des Repositorys ein.
   Authentifizierung	Wählen Sie den Authentifizierungstyp des Repositorys aus und geben Sie die entsprechenden Informationen ein.

   Übernehmen Sie bei den restlichen Feldern die Standardwerte, und wählen Sie Hinzufügen aus.

6. Wenn Sie über mehrere Repositorys verfügen, wählen Sie Hinzufügen aus, um andere Repositorys zu migrieren. Wählen Sie für TypAndere aus, und migrieren Sie dann andere Eigenschaften wie im vorherigen Schritt und in der folgenden Tabelle gezeigt:

   Eigenschaft	Wert
   Typ	Wählen Sie STANDARD aus.
   Muster	Geben Sie den Wert für Muster für das Repository im Format {application} oder {application}/{profile} ein.

7. Öffnen Sie im Abschnitt Bindung das Dropdownmenü, um die Apps auszuwählen, die an den Konfigurationsserver für Spring gebunden werden sollen.

8. Wählen Sie Weiter aus.

9. Wählen Sie zum Einrichten des Konfigurationsservers auf der Registerkarte ÜberprüfenKonfigurieren von aus, und folgen Sie dann den Anweisungen im Konfigurationsabschnitt.

Nach erfolgreicher Erstellung können Sie sehen, dass der Bereitstellungsstatus von Config Server for Spring erfolgreich ist.

Azure-Befehlszeilenschnittstelle

Verwenden Sie den folgenden Befehl, um die Config Server for Spring Java-Komponente zu erstellen und zu konfigurieren:

az containerapp env java-component config-server-for-spring create \
    --resource-group <resource-group-name> \
    --name <config-server-name> \
    --environment <azure-container-app-environment-name> \
    --min-replicas 1 \
    --max-replicas 1 \
    --configuration spring.cloud.config.server.git.uri=<URI> spring.cloud.config.server.git.default-label=<label>

Alle Eigenschaften werden mithilfe des Formats --configuration <CONFIGURATION_KEY>=<CONFIGURATION_VALUE> festgelegt. Informationen zum Zuordnen vorhandener Konfigurationen zu den Schlüsselwertpaaren des Konfigurationsservers finden Sie im Konfigurationsabschnitt.

Ressourcenzuteilung

Die Containerressourcenzuordnung für den verwalteten Config Server in Azure Container Apps ist auf die folgenden Werte festgelegt:

• CPU: 0.5 vCPU
• Speicher: 1 Gi

Um die Instanzenanzahl von Config Server for Spring zu konfigurieren, müssen Sie die Parameter --min-replicas und --max-replicas mit demselben Wert aktualisieren. Diese Konfiguration stellt sicher, dass die Anzahl der Instanzen fest bleibt. Derzeit unterstützt das System keine automatischen Skalierungskonfigurationen für die dynamische Skalierung.

Konfigurieren des Konfigurationsservers

Ordnen Sie das standardmäßige Git-Repository und zusätzliche Repositorys, die im Spring Cloud Config Server in Azure Spring Apps konfiguriert sind, den Standard- und anderen Repositorys im Config Server for Spring zu, die in Azure Container Apps bereitgestellt werden. Die folgende Tabelle zeigt die Zuordnungsbeziehungen für Eigenschaften:

Eigenschaftenname in Azure Spring Apps	CONFIGURATION_KEY	CONFIGURATION_VALUE
uri	spring.cloud.config.server.git.uri spring.cloud.config.server.git.repos.{repoName}.uri	Die uri des Remote-Repositorys.
search path	spring.cloud.config.server.git.search-paths spring.cloud.config.server.git.repos.{repoName}.search-paths	Suchpfade zur Verwendung in lokalen Arbeitskopien. Standardmäßig wird nur der Stamm durchsucht.
label	spring.cloud.config.server.git.default-label spring.cloud.config.server.git.repos.{repoName}.default-label	Die Bezeichnung, die für Git verwendet wird.
name in zusätzlichen Repositorys	{repoName} in den folgenden Konfigurationen.
Patterns in zusätzlichen Repositorys	spring.cloud.config.server.git.repos.{repoName}.pattern
username	spring.cloud.config.server.git.username spring.cloud.config.server.git.repos.{repoName}.username	Geben Sie die username-Authentifizierung mit Remote-Repository ein, wenn der Authentifizierungstyp HTTP Basic lautet.
password	spring.cloud.config.server.git.password spring.cloud.config.server.git.repos.{repoName}.password	Geben Sie die password-Authentifizierung mit Remote-Repository ein, wenn der Authentifizierungstyp HTTP Basic lautet.
private key	spring.cloud.config.server.git.private-key spring.cloud.config.server.git.repos.{repoName}.private-key	Gültiger privater SSH-Schlüssel, wenn der Authentifizierungstyp SSH lautet.
host key	spring.cloud.config.server.git.host-key spring.cloud.config.server.git.repos.{repoName}.host-key	Gültiger SSH-Hostschlüssel, wenn der Authentifizierungstyp SSH lautet. Muss festgelegt werden, wenn host-key-algorithm auch festgelegt ist.
host key algorithm	spring.cloud.config.server.git.host-key-algorithm spring.cloud.config.server.git.repos.{repoName}.host-key-algorithm	Einer von ssh-dss, ssh-rsa, ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384 oder ecdsa-sha2-nistp521, wenn der Authentifizierungstyp SSH ist. Muss festgelegt werden, wenn auch „host-key“ festgelegt ist.

Weitere Config Server-Eigenschaften finden Sie im Abschnitt Konfigurationsoptionen in Herstellen einer Verbindung mit einem verwalteten Config Server for Spring in Azure Container Apps.

Bereitstellen der Anwendung in Azure Container Apps

Nach dem lokalen Testen der Anwendung können Sie das neue Image in der Azure Container Apps-Anwendung bereitstellen.

Azure portal

Führen Sie die folgenden Schritte zum Bereitstellen aus:

1. Navigieren Sie im Azure-Portal zu Ihrer Azure Container Apps-Anwendung.
2. Wählen Sie im Menü Anwendungscontainer>Container aus.
3. Wählen Sie Bearbeiten und Bereitstellen aus, um die Seite Neue Überarbeitung erstellen und bereitstellen zu öffnen.
4. Wählen Sie im Abschnitt Containerimage das Bild aus und wählen Sie dann Bearbeiten aus.
5. Wählen Sie im Abschnitt Container bearbeiten auf der Registerkarte Eigenschaften das neue Bild der Anwendung aus.
6. Geben Sie auf der Registerkarte Umgebungsvariablen als Namespring.application.name ein. Wählen Sie dann als QuelleManueller Eintrag aus und geben Sie den Konfigurationsdateinamen an, unter dem die Anwendung die Konfiguration verwendet.
7. Wählen Sie Speichern aus, um die neue Revision bereitzustellen.

Azure-Befehlszeilenschnittstelle

Verwenden Sie den folgenden Befehl, um die Container-App zu aktualisieren, welche die Konfigurationsdaten verwendet:

az containerapp update \
    --resource-group <your-resource-group> \
    --name <container-app-name> \
    --image <new-container-image> \
    --bind <config-server-name> \
    --set-env-vars spring.application.name=<config-file-name>

Der Parameter --bind <config-server-name> erstellt die Verknüpfung zwischen Ihrer Container-App und der Konfigurationskomponente. Sie sollten die Umgebungsvariable hinzufügen, indem Sie --set-env-vars spring.application.name=<config-file-name> für den App-Container festlegen, damit die App die Konfiguration aus der richtigen Konfigurationsdatei nutzen kann.

Problembehandlung

Sie können Protokolle für den verwalteten Konfigurationsserver für Spring in Azure Container Apps mithilfe von Log Analytics anzeigen. Führen Sie die folgenden Schritte durch:

1. Navigieren Sie im Azure-Portal zu Ihrer Azure Container Apps-Umgebung.

2. Wählen Sie das Menü Überwachung>Protokolle aus.

3. Um Protokolle anzuzeigen, geben Sie eine Abfrage in den Abfrage-Editor für die ContainerAppSystemLogs_CL-Tabelle ein, wie im folgenden Beispiel gezeigt:

   ContainerAppSystemLogs_CL
   | where ComponentType_s == "SpringCloudConfig"
   | project Time=TimeGenerated, ComponentName=ComponentName_s, Message=Log_s
   | take 100
   

Weitere Informationen zum Abfragen von Protokollen finden Sie unter Einblick von verwalteten Java-Komponenten in Azure Container Apps.