Springboot整合Apollo

springboot,apollo · 浏览次数 : 14

小编点评

Apollo配置中心是一个为开发人员提供配置管理服务的产品。随着程序功能的增加，配置项不断增多，传统的配置文件和数据库已经无法满足需求。Apollo配置中心应运而生，提供了规范化的权限、流程治理等特点。本文将指导如何在本地环境快速搭建Apollo配置中心，并介绍如何将其与Spring Boot项目整合。最后，我们将讨论Apollo的一些补充功能，如缓存和多环境配置。一、Apollo配置中心快速搭建 1. 准备数据库 - 创建ApolloPortalDB数据库，导入`apolloconfigdb.sql`。 - 创建ApolloConfigDB数据库，导入`apolloportaldb.sql`。 2. 连接数据库并启动Apollo配置中心 - 修改`demo.sh`脚本，设置Apollo Config DB和Apollo Portal DB的连接信息。 - 在Git Bash中执行`demo.sh start`以启动Apollo配置中心。 3. 访问Apollo平台 - 使用浏览器访问`http://localhost:8070/`，使用Apollo的用户名（默认为`apollo`）和密码进行登录。二、Spring Boot整合Apollo配置中心 1. 添加Apollo依赖在Spring Boot项目的`pom.xml`文件中添加`com.ctrip.framework.apollo:apollo-client1.1.1`依赖。 2. 编写application.yml文件在`application-dev.yml`中添加以下配置： ``` app:id: basedata apollo: meta: url: http://localhost:8080 bootstrap: enabled: true namespaces: - application - baseeagerLoad: enabled: true ``` 3. 在Spring Boot启动类上添加`@EnableApolloConfig`注解。 4. 登录Apollo平台并发布配置 - 访问`http://localhost:8070/apollo/admin`创建项目，并添加基于应用的配置。 - 选择集群发布，确保只有发布的配置文件会被客户端获取到，且发布仅适用于当前环境（例如DEV）。 5. 项目中读取配置现在可以在项目中直接读取Apollo配置中心的配置了。三、Apollo补充功能 1. Java连接Apollo配置中心用户在Java项目中连接Apollo配置中心时，需要在`application.properties`中指定AppId，该AppId是项目的唯一标识。可以在`application-dev.yml`中设置`app:id: basedata`，并在`apollo-env.properties`中配置不同环境访问不同的Apollo配置中心。 2. Apollo缓存 Apollo客户端会将从服务端获取到的配置在本地文件系统缓存一份。缓存路径位于`C:\opt\data\apollo`。缓存文件中的所有配置会写入其中，这样即使在服务不可用或网络不通的情况下，配置仍可以从本地恢复，而不会影响应用正常运行。

正文

一、Apollo作用

随着程序功能的日益复杂，程序的配置日益增多：各种功能的开关、参数的配置、服务器的地址……

对程序配置的期望值也越来越高：配置修改后实时生效，灰度发布，分环境、分集群管理配置，完善的权限、审核机制……

在这样的大环境下，传统的通过配置文件、数据库等方式已经越来越无法满足开发人员对配置管理的需求。

Apollo配置中心应运而生！Apollo（阿波罗）是携程框架部门研发的开源配置管理中心，具备规范的权限、流程治理等特性。

二、搭建Apollo配置中心

Quick Start：能够在几分钟内在本地环境部署、启动Apollo配置中心（只针对本地测试使用）

1.创建数据库

Apollo服务端共需要两个数据库：ApolloPortalDB和ApolloConfigDB

-- 数据库ApolloConfigDB 导入apolloconfigdb.sql

select `NamespaceId`, `Key`, `Value`, `Comment` from ApolloConfigDB.Item;

-- 数据库ApolloPortalDB 导入apolloportaldb.sql

select `Id`, `AppId`, `Name` from ApolloPortalDB.App;

2.Apollo服务端连接这两个数据库

修改demo.sh

# apollo config db info

apollo_config_db_url=jdbc:mysql://localhost:3306/ApolloConfigDB?characterEncoding=utf8

apollo_config_db_username=xxx

apollo_config_db_password=xxx

# apollo portal db info

apollo_portal_db_url=jdbc:mysql://localhost:3306/ApolloPortalDB?characterEncoding=utf8

apollo_portal_db_username=xxx

apollo_portal_db_password=xxx

3.启动Apollo配置中心

执行启动脚本，打开git bash here

./demo.sh start

4.使用Apollo

会在本地启动三个服务，分别使用8070、8080、8090端口

http://localhost:8070/

http://localhost:8080/

http://localhost:8090/

Apollo平台：

http://localhost:8070/

用户名：apollo

密码：xxx

三、springboot整合使用Apollo配置中心

1.添加Apollo依赖：pom.xml

com.ctrip.framework.apollo

apollo-client

1.1.1

2.编写application.yml文件

application-dev.yml：

# Apollo 配置管理

app:

id: basedata

apollo:

meta: http://localhost:8080

bootstrap:

enabled: true

namespaces: application, base

eagerLoad:

enabled: true

3.springboot启动类添加注解@EnableApolloConfig

4.登录Apollo平台添加配置并发布

http://localhost:8070/apollo/admin

创建项目：appId

添加配置项：key/value、选择集群

发布：只有发布过的配置文件才会被客户端获取到，该发布只会作用于当前环境：DEV

Apollo配置：

比如basedata:

公共的配置：去引用base应用的配置，继承base，自己改写会覆盖

私有的配置：application

文本可以查看自己改写的，和base不同的配置

5.项目中就可以读取到这些配置了

四、补充

1.用户在用java连接apollo时，需要创建app.properties：

在apollo配置中心中存在AppId，这是每一个项目的唯一标识，

因此app.properties内需要确定，你需要使用哪个项目的配置信息

-----》直接在application-dev.yml中：

app:

id: basedata

apollo-env.properties：用来配置不同环境访问不同的apollo配置中心的，apollo允许用户配置四个不同的环境，分别是dev-开发环境，fat-功能测试环境，uat-用户测试环境， pro-生产环境

-----》

apollo:

meta: http://localhost:8080/

application-fat.yml是8081

2.spring Eureka注册中心

http://localhost:8080/

表示apollo启动成功

apollo默认有8080、8090和8070三个端口

3.Apollo缓存

Apollo客户端会把从服务端获取到的配置在本地文件系统缓存一份，

用于在遇到服务不可用，或网络不通的时候，依然能从本地恢复配置，不影响应用正常运行。

本地缓存路径位于C:\opt\data\

apollo所有配置会写在这个缓存文件中