Apollo配置教程：Spring+SpringBoot集成与环境切换

本文档介绍了如何在Spring Boot项目中集成Apollo配置中心的详细步骤和注意事项。 Apollo是携程开源的一款分布式配置中心，它能够集中管理和推送应用程序的配置，使得配置的更新能够在各个服务实例间实时生效。以下是集成Apollo到Spring Boot项目的关键步骤： 1. **配置环境变量**： - 在本地启动时，需要在Java虚拟机（JVM）参数中指定环境，例如 `-Denv=DEVELOP`，以区分不同的开发环境如开发（DEVELOP）、系统测试（SIT）、用户验收测试（UAT）等。 2. **添加Apollo依赖**： - 在项目的`pom.xml`文件中，引入Apollo的依赖包，这样项目就能访问Apollo提供的服务。 3. **创建Apollo项目**： - 在Apollo控制台注册并创建项目，设置`appId`，这将是应用与Apollo交互的唯一标识。 4. **配置集群与配置**： - 在项目中创建所需的集群，并在Apollo控制台上配置相关参数。配置完成后需发布，以便它们对应用生效。 5. **配置文件引用**： - 在`application.yml`或`application.properties`中，可以引用Apollo的配置属性。 6. **初始化配置**： - 在`/resources/META-INF/app.properties`中，配置`app.id`以标识应用。 - 在`/resources/apollo-env.properties`中，配置对应环境的Apollo服务器地址。 7. **启用Apollo配置**： - 在Spring Boot的启动类上，使用`@EnableApolloConfig`注解来启用Apollo配置。 8. **获取配置值**： - 使用Spring的`@Value("${property}")`或`value="${property}"`注解，可以从Apollo中获取配置属性。 9. **本地缓存**： - Apollo客户端会缓存从服务器获取的配置到本地，以应对服务不可用的情况。默认缓存路径分别为Mac/Linux的`/opt/data/{appId}/config-cache`和Windows的`C:\opt\data\{appId}\config-cache`。确保这些目录存在并具有适当的权限。 10. **Jenkins集成**： - 在Jenkins的构建脚本（如`sh`命令）中，删除可能覆盖服务器配置的`application.properties`相关语句，通过设置`-eJAVA_OPTS="-Denv=DEVELOP"`指定环境。 11. **Dockerfile修改**： - 如果应用部署在Docker容器中，需要在`Dockerfile`的启动命令中指定环境变量，如`sh","-c","exec java$JAVA_OPTS -jar /opt/messenger.jar"`。 以上步骤概括了集成Apollo到Spring Boot应用的基本流程。在实际操作中，还需要考虑日志配置、异常处理、健康检查以及与其他服务的协同工作等细节，确保配置中心的稳定性和可靠性。