将应用程序配置服务迁移到 Azure 容器应用中的 Config Server for Spring

本文适用于： ❎ 基本计划/标准计划 ✅ 企业计划

本文介绍如何将应用程序配置服务 (ACS) 和 Config Server 迁移到 Azure 容器应用中的 Config Server for Spring。 Azure 容器应用管理 Config Server for Spring，其功能与 Azure Spring Apps 中的 ACS 或 Spring Cloud Config Server 类似。

先决条件

• 启用了应用程序配置服务的 Azure Spring Apps 企业计划实例。
• 用于 Config Server 的 Azure 容器应用环境和 Azure 容器应用实例。

预配 Config Server

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>

资源分配

Azure 容器应用中托管 Config Server 的容器资源分配固定为以下值：

• CPU：0.5 vCPU
• 内存：1 Gi

若要配置 Config Server for Spring 的实例计数，需要用相同的值更新参数 --min-replicas 和 --max-replicas。 此配置可确保实例计数保持固定。 目前，系统不支持动态缩放的自动缩放配置。

配置 Config Server

从应用程序配置服务 (ACS) 中选择一个 Git 存储库作为 Config Server 中的默认存储库，而选择其他存储库作为附加存储库。

下表提供 ACS 中的属性与 Config Server 中的相应配置之间的映射：

有关更多 Config Server 属性，请参阅在 Azure 容器应用中连接到适用于 Spring 的托管配置服务器的配置选项部分。

例如，假设在 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"
            }
        ]
    }
}

使用此 ACS 配置，可以通过以下配置迁移到 Config Server for Spring：

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

更改应用程序配置

在预配和配置 Config Server for Spring 后，请使用以下步骤调整应用程序配置以有效地使用它：

1. 更新 Spring Boot 依赖项。 将以下 Spring Cloud 配置依赖项添加到 Maven 的 pom.xml 或 Gradle 的 build.gradle。

   • Maven
   • Gradle

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

2. 配置一个配置文件。 ACS 的配置文件在 Azure Spring Apps 部署中作为模式提供，而在 Config Server 中，配置文件是在应用程序的源代码中配置的。

   确保应用程序使用正确的配置文件（dev、prod 等），以便 Config Server 可以提供特定于环境的配置。

   使用正确的配置属性更新应用程序中的 bootstrap.yml 或 application.yml 文件，以指向 Config Server，如以下示例所示：

   spring:
     cloud:
       config:
         profile: dev
   

3. 配置刷新间隔。 如果在 ACS 中设置刷新间隔，则还可以在 Config Server for Spring 的 spring.cloud.config.server.git.refreshRate 配置中指定相应的值。 此值确定 Config Server for Spring 从 Git 后端提取更新的配置数据的频率。

   若要在应用程序的代码中加载属性更改，请执行以下步骤：

   1. 注册计划任务以按给定的间隔刷新上下文。
   2. 启用 autorefresh 并在 application.yml 文件中设置适当的刷新间隔。
   3. 向代码添加 @RefreshScope。

   有关详细信息，请参阅刷新 Config Server。

将应用程序部署到 Azure 容器应用

在本地测试应用程序后，可以将新映像部署到 Azure 容器应用应用程序。

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>

疑难解答

可以使用 Log Analytics 在 Azure 容器应用中查看适用于 Spring 的托管配置服务器的日志。 请使用以下步骤：

1. 在 Azure 门户中导航到 Azure 容器应用环境。

2. 选择“监视”>“日志”菜单。

3. 若要查看日志，请在 ContainerAppSystemLogs_CL 表的查询编辑器中输入查询，如以下示例所示：

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

有关查询日志的详细信息，请参阅 Azure 容器应用中托管 Java 组件的可观测性。

已知限制

将 ACS 迁移到 Config Server for Spring 仅适用于 Java 应用程序。 因为 ACS 使用 Kubernetes 本机 ConfigMap 来管理配置。 此方法在 Kubernetes 环境中启用动态配置更新，使其适用于具有多种编程语言的不同应用程序。 而 Spring Cloud Config Server 主要为 Java 应用程序设计，使用 Spring Framework 功能，因此仅支持 Java 的配置管理。