Migrieren des Anwendungskonfigurationsdiensts zu Config Server for Spring in Azure Container Apps

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

In diesem Artikel wird beschrieben, wie Sie Application Configuration Service (ACS) und Config Server zu Config Server for Spring in Azure Container Apps migrieren. Azure Container Apps verwaltet Config Server for Spring, der ähnliche Funktionen wie ACS oder Spring Cloud Config Server in Azure Spring Apps hat.

Voraussetzungen

• Eine Azure Spring Apps Enterprise-Instanz des Plans mit aktiviertem Anwendungskonfigurationsdienst.
• Eine Azure Container Apps-Umgebung für Config Server und eine Azure Container Apps-Instanz.

Bereitstellungskonfigurationsserver

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>

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

Wählen Sie ein Git-Repository aus dem Application Configuration Service (ACS) als Standardrepository in Config Server und andere Repositorys als zusätzliche Repositorys aus.

Die folgende Tabelle enthält eine Zuordnung zwischen den Eigenschaften in ACS und den entsprechenden Konfigurationen in Config Server:

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

Angenommen, Sie haben die folgende Konfiguration in ACS:

"settings": {
    "gitProperty": {
        "repositories": [
            {
                "name": "r1",
                "patterns": [
                    "application"
                ],
                "label": "master",
                "uri": "https://github.com/Azure-Samples/spring-petclinic-microservices-config"
            },
            {
                "name": "r2",
                "patterns": [
                    "customers-service"
                ],
                "label": "master",
                "uri": "https://github.com/Azure-Samples/spring-petclinic-microservices-config"
            },
            {
                "name": "r3",
                "patterns": [
                    "payment"
                ],
                "label": "main",
                "uri": "https://github.com/Azure-Samples/acme-fitness-store-config"
            }
        ]
    }
}

Mit dieser ACS-Konfiguration können Sie mit den folgenden Konfigurationen zu Config Server for Spring migrieren:

spring.cloud.config.server.git.uri=https://github.com/Azure-Samples/spring-petclinic-microservices-config
spring.cloud.config.server.git.default-label=master
spring.cloud.config.server.git.repos.repo1.uri=https://github.com/Azure-Samples/acme-fitness-store-config
spring.cloud.config.server.git.repos.repo1.default-label=main

Ändern der Anwendungskonfiguration

Nachdem Sie den Config Server for Spring bereitgestellt und konfiguriert haben, führen Sie die folgenden Schritte aus, um die Anwendungskonfiguration so anzupassen, dass sie effektiv verwendet wird:

1. Aktualisieren von Spring Boot-Abhängigkeiten. Fügen Sie die folgenden Spring Cloud Config-Abhängigkeiten zu Ihrem pom.xml für Maven oder build.gradle für Gradle hinzu.

   • Maven
   • Gradle

   <dependency>
       <groupId>org.springframework.cloud</groupId>
       <artifactId>spring-cloud-starter-config</artifactId>
   </dependency>
   

2. Konfigurieren Sie ein Profil. Das Profil für ACS wird als Muster in einer Azure Spring Apps-Bereitstellung bereitgestellt, während in Config Server das Profil im Quellcode der Anwendung konfiguriert ist.

   Stellen Sie sicher, dass Ihre Anwendung die richtigen Profile verwendet – dev, prod usw., damit der Config Server umgebungsspezifische Konfigurationen bereitstellen kann.

   Aktualisieren Sie die bootstrap.yml- oder application.yml-Datei in Ihrer Anwendung mit den richtigen Konfigurationseigenschaften, um auf den Config Server zu verweisen, wie im folgenden Beispiel gezeigt:

   spring:
     cloud:
       config:
         profile: dev
   

3. Konfigurieren Sie ein Aktualisierungsintervall. Wenn Sie ein Aktualisierungsintervall in ACS festlegen, können Sie auch den entsprechenden Wert in der spring.cloud.config.server.git.refreshRate-Konfiguration von Config Server for Spring angeben. Dieser Wert bestimmt, wie häufig Config Server for Spring aktualisierte Konfigurationsdaten aus dem Git-Back-End abruft.

   Gehen Sie wie folgt vor, um Eigenschaftsänderungen im Code Ihrer Anwendung zu laden:

   1. Registrieren Sie eine geplante Aufgabe, um den Kontext in einem bestimmten Intervall zu aktualisieren.
   2. Aktivieren Sie autorefresh und legen Sie das entsprechende Aktualisierungsintervall in Ihrer application.yml-Datei fest.
   3. Fügen Sie Ihrem Code @RefreshScope hinzu.

   Weitere Informationen finden Sie unter Config Server aktualisieren.

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.

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>

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.

Bekannte Einschränkung

Die Migration von ACS zu Config Server for Spring gilt nur für Java-Anwendungen. Da ACS die Konfiguration mithilfe der Kubernetes-nativen ConfigMap verwaltet. Diese Methode ermöglicht dynamische Konfigurationsupdates in Kubernetes-Umgebungen, was sie für verschiedene Anwendungen mit mehreren Programmiersprachen vielseitig macht. Während Spring Cloud Config Server in erster Linie für Java-Anwendungen konzipiert ist, werden Spring Framework-Features verwendet und somit nur die Konfigurationsverwaltung für Java unterstützt.