柚子快报邀请码778899分享:Apollo 统一配置中心
Apollo(阿波罗)是携程框架部门研发的开源配置管理中心
能够集中化管理应用不同环境、不同集群的配置,配置修改后能够实时推送到应用端,并且具备规范的权限、流程治理等特性
地址 https://github.com/ctripcorp/apollo
特性
统一管理不同环境、不同集群的配置
配置修改实时生效(热发布)
版本发布管理
灰度发布
权限管理、发布审核、操作审计
客户端配置信息监控
提供Java和.Net原生客户端
提供开放平台API
部署简单
Apollo架构图
Config Service提供配置的读取、推送等功能,服务对象是Apollo客户端
Admin Service提供配置的修改、发布等功能,服务对象是Apollo Portal(管理界面)
Config Service和Admin Service都是多实例、无状态部署,所以需要将自己注册到Eureka中并保持心跳
在Eureka之上架了一层Meta Server用于封装Eureka的服务发现接口
Client通过域名访问Meta Server获取Config Service服务列表(IP+Port),而后直接通过IP+Port访问服务,同时在Client侧会做load balance、错误重试
Portal通过域名访问Meta Server获取Admin Service服务列表(IP+Port),而后直接通过IP+Port访问服务,同时在Portal侧会做load balance、错误重试
为了简化部署,会把Config Service、Eureka和Meta Server三个逻辑角色部署在同一个JVM进程中
1.搭建 Apollo 配置中心
参照 https://github.com/ctripcorp/apollo/wiki/Quick-Start
(1)下载Quick Start安装包
(2)创建Apollo服务端需要两个数据库
ApolloPortalDB
ApolloConfigDB
(3)解压Quick Start安装包,修改demo.sh数据库配置
# apollo config db info
apollo_config_db_url=jdbc:mysql://localhost:3306/ApolloConfigDB?characterEncoding=utf8
apollo_config_db_username=root
apollo_config_db_password=root
# apollo portal db info
apollo_portal_db_url=jdbc:mysql://localhost:3306/ApolloPortalDB?characterEncoding=utf8
apollo_portal_db_username=root
apollo_portal_db_password=root
(4)服务启动与关闭
在git下执行启动脚本
./demo.sh start
关闭
./demo.sh stop
(5)浏览器打开http://localhost:8070/
输入用户名 apollo,密码 admin
http://localhost:8080/
2.spring boot集成
(1)依赖
(2)启动类
package com.xyz.provider;
import com.ctrip.framework.apollo.spring.annotation.EnableApolloConfig;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
@EnableApolloConfig
public class ProviderApplication {
public static void main(String[] args) {
SpringApplication.run(ProviderApplication.class, args);
}
}
(3)配置
server.port=8010
spring.application.name=service-provider
# 应用全局唯一的身份标识
app.id = springboot-apollo
# Apollo Meta Server 地址
apollo.meta = http://localhost:8080
# 自定义本地配置文件缓存路径
apollo.cacheDir = ./config
# 设置在应用启动阶段就加载 Apollo 配置
apollo.bootstrap.enabled = true
# 注入 application namespace
apollo.bootstrap.namespaces = application
apollo.bootstrap.eagerLoad.enabled = true
logging.level.com.xyz.provider.controller=debug
order.discount = 75
说明:
app.id:AppId是应用的身份信息,是配置中心获取配置的一个重要信息
apollo.bootstrap.enabled:在应用启动阶段,向Spring容器注入被托管的application.properties文件的配置信息
apollo.bootstrap.eagerLoad.enabled:将Apollo配置加载提到初始化日志系统之前
logging.level.com.xyz.provider.controller:调整 controller 包的 log 级别,用来在配置中心动态配置日志级别
(4)控制器
package com.xyz.provider.controller;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HelloController {
private static Logger logger = LoggerFactory.getLogger(HelloController.class);
@Value("${server.port}")
String port;
@Value(("${order.discount}"))
Integer discount;
@GetMapping("hello")
public String hello(String name) {
logger.debug("debug log...");
logger.info("info log...");
logger.warn("warn log...");
return "hello " + name + " ,i am from port:" + port + ",discount:" + discount;
}
}
启动项目
GET http://localhost:8010/hello?name=beibei
返回
hello beibei ,i am from port:8011,discount:75
(5)配置
创建项目
说明:
部门:选择应用所在的部门
应用AppId:用来标识应用身份的唯一id,格式为string,需要和客户端application.properties中配置的app.id对应
应用名称:应用名,仅用于界面展示
应用负责人:选择的人默认会成为该项目的管理员,具备项目权限管理、集群创建、Namespace创建等权限
新增配置
发布配置
编辑完配置后,需要发布配置,才能生效
发布后再次请求http://localhost:8010/hello?name=beibei
返回 hello beibei ,i am from port:8011,discount:50
说明:
服务的端口依然还是 8010,因为 apollo 修改配置,不会像Spring Cloud Config 那样去重启应用
重启应用后,客户端会使用配置中心中配置的端口
GET http://localhost:8011/hello?name=beibei
返回
hello beibei ,i am from port:8011,discount:50
控制台输出
2020-05-27 11:19:48.064 DEBUG 14880 --- [nio-8011-exec-1] c.x.provider.controller.HelloController : debug log...2020-05-27 11:19:48.064 INFO 14880 --- [nio-8011-exec-1] c.x.provider.controller.HelloController : info log...2020-05-27 11:19:48.064 WARN 14880 --- [nio-8011-exec-1] c.x.provider.controller.HelloController : warn log...
配置日志等级
说明:
在配置中心修改日志等级,发布后也没法立即生效,需要重启应用
重启后
GET http://localhost:8011/hello?name=beibei
控制台输出
2020-05-27 11:21:57.780 INFO 13200 --- [nio-8011-exec-1] c.x.provider.controller.HelloController : info log...2020-05-27 11:21:57.780 WARN 13200 --- [nio-8011-exec-1] c.x.provider.controller.HelloController : warn log...
添加监听
package com.xyz.provider.config;
import com.ctrip.framework.apollo.Config;
import com.ctrip.framework.apollo.model.ConfigChangeEvent;
import com.ctrip.framework.apollo.spring.annotation.ApolloConfig;
import com.ctrip.framework.apollo.spring.annotation.ApolloConfigChangeListener;
import org.apache.commons.lang3.StringUtils;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.logging.LogLevel;
import org.springframework.boot.logging.LoggingSystem;
import org.springframework.context.annotation.Configuration;
import javax.annotation.PostConstruct;
import java.util.Set;
@Configuration
public class LoggerConfig {
private static final Logger logger = LoggerFactory.getLogger(LoggerConfig.class);
private static final String LOGGER_TAG = "logging.level.";
@Autowired
private LoggingSystem loggingSystem;
@ApolloConfig
private Config config;
@ApolloConfigChangeListener
private void configChangeListter(ConfigChangeEvent changeEvent) {
refreshLoggingLevels();
}
@PostConstruct
private void refreshLoggingLevels() {
Set
for (String key : keyNames) {
if (StringUtils.containsIgnoreCase(key, LOGGER_TAG)) {
String strLevel = config.getProperty(key, "info");
LogLevel level = LogLevel.valueOf(strLevel.toUpperCase());
loggingSystem.setLogLevel(key.replace(LOGGER_TAG, ""), level);
logger.info("{}:{}", key, strLevel);
}
}
}
}
说明:
@ApolloConfig注解:将Apollo服务端的中的配置注入到这个类中
@ApolloConfigChangeListener注解:监听配置中心配置的更新事件,若该事件发生,则调用refreshLoggingLevels方法处理该事件
ConfigChangeEvent:获取被修改配置项的key集合,以及被修改配置项的新值、旧值和修改类型等信息
重启项目应用
修改配置logging.level.com.xyz.provider.controller为warn
GET http://localhost:8011/hello?name=beibei
控制台输出
2020-05-27 11:26:18.211 WARN 4636 --- [nio-8011-exec-4] c.x.provider.controller.HelloController : warn log...
Apollo与SpringCloud Config的对比
Apollo
Spring Cloud Config
配置界面
同一界面管理不同环境/集群配置
无,通过git操作
配置生效时间
实时
重启生效,或Refresh,git hook+MQ
版本管理
界面尚志杰提供发布历史和回滚按钮
无
灰度发布
支持
不支持
授权/审计/审核
界面直接操作,且支持修改和发布权限分离
需要通过git仓库设置,且不支持修改和发布权限分离
实时配置监控
可以方便看到当前那些客户端在使用哪些配置
不支持
配置获取性能
快
较慢
客户端支持
原生支持Java/.Net,提供API,支持Spring annotation
Spring应用+annotation支持
Apollo是企业生产级配置中心,使用范围更广
柚子快报邀请码778899分享:Apollo 统一配置中心
发表评论