微服务架构中的 Apollo 配置中心实战详解

集成 Spring Boot 项目

1. Maven 依赖引入

在 pom.xml 中添加 Apollo 客户端依赖。

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>com.ctrip.framework.apollo</groupId>
        <artifactId>apollo-client</artifactId>
        <version>1.4.0</version>
    </dependency>
</dependencies>

2. 配置文件配置

在 application.yml 中指定应用 ID 及配置中心地址。注意 bootstrap.enabled 需开启以优先加载配置。

server:
  port: 8080

spring:
  application:
    name: apollo-demo

# Apollo 配置
app:
  id: apollo-test

apollo:
  cacheDir: /opt/data/
  cluster: default
  meta: http://192.168.2.11:30002
  autoUpdateInjectedSpringProperties: true
  bootstrap:
    enabled: true
    namespaces: application
    eagerLoad:
      enabled: false

3. 代码实现

使用 @Value 注解注入配置，并编写 Controller 进行测试。

@RestController
public class TestController {

    @Value("${test:默认值}")
    private String test;

    @GetMapping("/test")
    public String test() {
        return "test 的值为:" + test;
    }
}

启动类无需特殊修改，但需注意 JVM 参数设置。若部署在 Kubernetes 环境中，必须指定 -Denv 和 -Dapollo.configService。

-Dapollo.configService=http://192.168.2.11:30002 -Denv=DEV

功能验证与测试

动态刷新

修改 Apollo 配置中心的 test 参数值并发布后，访问接口即可看到值已更新，无需重启应用。这得益于 Apollo 的长轮询机制。

回滚测试

执行配置回滚操作后，客户端会自动同步到回滚前的版本，确保业务连续性。

异常降级

当 Apollo 服务不可达时，由于本地缓存的存在，应用仍会使用缓存中的配置继续运行，不会报错。删除缓存文件后重启，才会回退到本地默认值。

高级特性：环境、集群与命名空间

多环境切换

通过修改 JVM 参数 -Denv 和 apollo.meta 地址，可以切换至 PRO 环境。不同环境的配置完全隔离，互不干扰。

多集群配置

为不同机房创建不同 Cluster（如 beijing, shanghai）。在配置中心分别为各集群设置相同的 Key 但不同的 Value。客户端通过 apollo.cluster 指定当前所属集群。

多命名空间

创建多个 Namespace（如 dev-1, dev-2）。在 YAML 中通过 apollo.bootstrap.namespaces 指定加载顺序。公共 Namespace 可被多个应用共享，私有 Namespace 仅限特定应用访问。

Kubernetes 环境部署

对于容器化部署，建议将配置参数通过环境变量传递给容器。

构建镜像

编写 Dockerfile，将编译后的 JAR 包打包，并设置 JAVA_OPTS 和 APP_OPTS 环境变量。

FROM openjdk:8u222-jre-slim
VOLUME /tmp
ADD target/*.jar app.jar
RUN sh -c 'touch /app.jar'
ENV JAVA_OPTS="-XX:MaxRAMPercentage=80.0 -Duser.timezone=Asia/Shanghai"
ENV APP_OPTS=""
ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -Djava.security.egd=file:/dev/./urandom -jar /app.jar $APP_OPTS"]

K8s 部署

在 Deployment 中定义环境变量，将 Apollo 相关参数注入 APP_OPTS。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: springboot-apollo
spec:
  replicas: 1
  selector:
    matchLabels:
      app: springboot-apollo
  template:
    spec:
      containers:
        - name: springboot-apollo
          image: example-group/springboot-apollo:0.0.1
          env:
            - name: JAVA_OPTS
              value: "-Denv=DEV"
            - name: APP_OPTS
              value: "--app.id=apollo-demo --apollo.bootstrap.enabled=true --apollo.meta=http://service-apollo-config-server-dev.mydlqcloud:8080"

通过这种方式，实现了配置与代码的解耦，提升了运维效率。